X-Git-Url: http://git.chise.org/gitweb/?p=elisp%2Fsemi.git;a=blobdiff_plain;f=README.ja;h=0ecd2fc1ae574cae7945f9398cec14b7951428a6;hp=da785cf73236ef7977a8d2f7b03c839cad60cbbc;hb=a418e1c8b54f1dfb2e4f648b30107c0e9b5ae98b;hpb=cc0a722ec13e11cd7aa00db6929cb2505d1c9556 diff --git a/README.ja b/README.ja index da785cf..0ecd2fc 100644 --- a/README.ja +++ b/README.ja @@ -1,242 +1,241 @@ -[SEMI の核パッケージの README (日本語版)] +[README for SEMI kernel package (日本語版)] -SEMI とは？ -============ - - SEMI は GNU Emacs に MIME 機能を提供するライブラリーです。MIME はメッ - セージに (ASCII) plain text 以外の内容やヘッダーを含められるようにす - るために提案されている internet standard です。 +SEMI とは? +========= - RFC 2045 : Internet Message Bodies - RFC 2046 : Media Types - RFC 2047 : Message Header Extensions - RFC 2048 : MIME Registration Procedures - RFC 2049 : MIME Conformance + SEMI は GNU Emacs に対して MIME 機能を提供するライブラリです。MIME は、 + メッセージ内にプレーンテキスト (ASCII) 以外の内容やヘッダを含むものに + 関して提案されたインターネット規格です。 - SEMI は以下の機能があります。 + RFC 2045 : Internet Message Bodies + RFC 2046 : Media Types + RFC 2047 : Message Header Extensions + RFC 2048 : MIME Registration Procedures + RFC 2049 : MIME Conformance - - MIME メッセージ閲覧 (mime-view-mode) (RFC 2045 .. 2049) - - MIME メッセージ作成 (mime-edit-mode) (RFC 2045 .. 2049) + SEMI は、以下の機能を持っています: - MIME メッセージ閲覧と作成は以下の機能も提供しています: + - MIME message viewer (mime-view-mode) (RFC 2045 .. 2049) + - MIME message composer (mime-edit-mode) (RFC 2045 .. 2049) - - Content-Disposition フィールドによるファイル名の扱い (RFC - - 1806) - - PGP/MIME 安全な Multipart (RFC 2015) - - application/pgp (draft-kazu-pgp-mime-00.txt; obsolete) - - text/richtext (RFC 1521; obsolete; 閲覧のみ) - - text/enriched (RFC 1896) - - mailcap による外部方法設定 (RFC 1524) + MIME message viewer と MIME message compiser はさらに次の特徴を持って + います: - このパッケージは MUA のための MIME 拡張を含んでいないことに注意して - ください。それらは別のパッケージとしてリリースされます。 + - filename handling by Content-Disposition field (RFC 1806) + - PGP/MIME security Multiparts (RFC 2015) + - application/pgp (draft-kazu-pgp-mime-00.txt; obsolete) + - text/richtext (RFC 1521; obsolete; preview only) + - text/enriched (RFC 1896) + - External method configuration by mailcap (RFC 1524) + このパッケージには MUAs に関する MIME 拡張は含まれていないことに注意 + してください。これらは、別のパッケージとして配布されています。 必要な環境 ========== - SEMI は mule 機能つきの XEmacs 20.2 以降と Emacs 20 をサポートします。 + SEMI は、XEmacs 21.1 以降、および GNU Emacs 20.4 以降に対応しています。 - SEMI は Emacs 19.28 や XEmacs 19.14 以前はサポートしません。SEMI は - Emacs 19.29 から Emacs 19.34、XEmacs 19.15 から mule 機能のない - XEmacs 20.2 まではサポートしませんが、SEMI はそれらで動作するかもし - れません。 + SEMI は、GNU Emacs 19.28 または XEmacs 19.14 よりも古いものについては、 + 一切対応していません。加えて、SEMI は Mule 1, Mule 2 および GNU Emacs + 20.1/20.2 などで実装されている byte-indexing では動作しません。 - SEMI は APEL (9.6 以降) と FLIM (1.11.2 以降) を必要とします。SEMI - をインストールする前にまずそれらをインストールしてください。APEL パッ - ケージは以下のところで取得可能です: + SEMI は、Emacs 19.29 から 19.34, XEmacs 19.15 または XEmacs 20.2 につ + いても対応はしていませんが、動くかもしれません。 - ftp://ftp.jaist.ac.jp/pub/GNU/elisp/apel/ + SEMI は、APEL (10.7 以降) と FLIM (1.14.2 以降) を必要とします。 SEMI + をインストールする前に、これらをインストールしてください。APEL は、以 + 下で入手可能です。: - FLIM パッケージは以下のところで取得可能です。 + ftp://ftp.m17n.org/pub/mule/apel/ - ftp://ftp.jaist.ac.jp/pub/GNU/elisp/flim/ + そして、FLIM は以下で入手可能です。: - PGP/MIME と application/pgp は mailcrypt か tiny-pgp パッケージを必 - 要とします。 - - パッケージ enriched.el は text/enriched を作成するために必要ですので、 - Emacs 19.28 以前 (公式版の MULE 2.3 を含む) では、text/enriched の - WYSIWYG 作成は使用できません。 + http://www.kanji.zinbun.kyoto-u.ac.jp/~tomo/comp/emacsen/lisp/ + flim/flim-1.14/ インストール ============ -(a) 展開した場所で実行 +(a) 展開した場所で実行する - 他のディレクトリーにインストールしたくないなら、以下のことだけをやっ - てください: + もし、他のディレクトリにインストールすることを望まないならば、以下の + みを実行してください。: - % make + % make - emacs のコマンド名を指定することができます。例えば、 + あなたは emacs コマンド名を指定することが可能です。例えば、 - % make EMACS=xemacs + % make EMACS=xemacs - `EMACS=...' が省略されると、Emacs=emacs が使われます。 + もし、`EMACS=...' が省略されると、EMACS=emacs が用いられます。 (b) make install - 他のディレクトリーにインストールしたいなら、以下のことをしてください: + もしあなたが、他のディレクトリにインストールすることを望むならば、以下 + を実行してください。: - % make install + % make install - emacs のコマンド名を指定することができます。例えば、 + あなたは emacs コマンド名を指定することが可能です。例えば、 - % make install EMACS=xemacs + % make install EMACS=xemacs - `EMACS=...' が省略されると、Emacs=emacs が使われます。 + もし、`EMACS=...' が省略されると、EMACS=emacs が用いられます。 - Emacs Lisp プログラムとシェルスクリプトのためのディレクトリー木の接 - 頭辞 (prefix) を指定することができます。例えば、 + あなたは、Emacs Lisp プログラムとシェルスクリプトに関するディレクトリ階 + 層の接頭語を指定することができます。たとえば、: - % make install PREFIX=~/ + % make install PREFIX=~/ - `PREFIX=...' が省略されると、指定された emacs コマンドのディレクトリー - 木の接頭辞が使用されます (おそらく /usr/local です)。 + もし、`PREFIX=...' が省略されると、指定した emacs コマンドのディレク + トリ階層の接頭語が使用されます。(たぶん、/usr/local) - 例えば、PREFIX=/usr/local と Emacs 19.34 が指定されれば、以下のディ - レクトリー木が作成されます。 + 例えば、もし、PREFIX=/usr/local および、EMACS 19.34 が指定されると、 + 以下のようなディレクトリ階層が作成されるでしょう。: - /usr/local/share/emacs/20.2/site-lisp/ --- emu - /usr/local/share/emacs/site-lisp/apel/ --- APEL - /usr/local/share/emacs/site-lisp/flim/ --- FLIM - /usr/local/share/emacs/site-lisp/semi/ --- SEMI + /usr/local/share/emacs/19.34/site-lisp/ --- emu + /usr/local/share/emacs/site-lisp/apel/ --- APEL + /usr/local/share/emacs/site-lisp/flim/ --- FLIM + /usr/local/share/emacs/site-lisp/semi/ --- SEMI - site-lisp ディレクトリーを指定することができます。例えば、: + あなたは、site-lisp のディレクトリを指定することができます。例えば、 - % make install LISPDIR=~/share/emacs/lisp + % make install LISPDIR=~/share/emacs/lisp - `LISPDIR=...' が省略されると、指定された emacs のコマンドの - site-lisp ディレクトリーが使われます (おそらく - /usr/local/share/emacs/site-lisp か /usr/local/lib/xemacs/site-lisp) - です。 + もし、`LISPDIR=...' が省略されると、指定した emacs コマンドの + site-lisp ディレクトリが使用されます(たぶん、 + /usr/local/share/emacs/site-lisp または + /usr/local/lib/xemacs/site-lisp)。 - emu モジュール (APEL パッケージに入っています) が標準でないディレク - トリーにインストールされている場合は、それらのある場所を指定する必要 - があります。例えば、: + もし、emu モジュール (APEL に含まれている)が一般的ではないディレクト + リにインストールされている場合には、あなたは、これらがどこで見付けら + れるか指定する必要があります。: - % make install VERSION_SPECIFIC_LISPDIR=~/elisp + % make install VERSION_SPECIFIC_LISPDIR=~/elisp -(c) XEmacs のパッケージとしてインストールする +(c) XEmacs package としてのインストール - XEmacs のパッケージディレクトリーにインストールする場合は、以下のこ - とをしてください: + もしあなたが、XEmacs package のディレクトリにインストールすることを望 + むならば、以下を実行してください。: - % make install-package + % make install-package - emacs のコマンド名を指定することができます。例えば、 + あなたは、emacs command の名前を指定することができます。たとえば、: - % make install-package XEMACS=xemacs-21 + % make install-package XEMACS=xemacs-21 - `XEMACS=...' が省略されると、XEMACS=xemacs が使用されます。 + もし、`XEMACS=...' が省略されると、XEMACS=xemacs が用いられます。 - パッケージのディレクトリーを指定することができます。例えば: + あなたは、package のディレクトリを指定することができます。たとえば、: - % make install PACKAGEDIR=~/.xemacs + % make install PACKAGEDIR=~/.xemacs - `PACKAGEDIR=...' が省略されると、存在するパッケージディレクトリーの - 最初のものが使われます。 + もし、`PACKAGEDIR=...' が省略されると、最初に存在する package のディ + レクトリが使用されます。 - XEmacs のパッケージシステムは XEmacs 21.0 かそれ以降を要求することに - 注意してください。 + XEmacs package システムは、XEmacs 21.0 以降を必要とすることに注意してく + ださい。 (a,b,c) - 他の省略可能な設定をファイル ${archive}/SEMI-CFG を編集することで指 - 定できます。${archive}/README.ja と ${archive}/SEMI/CFG のコメントを - 読んでください。 + あなたは、${archive}/SEMI-CFG というファイルを書き換えることにより、 + 他のオプションの設定を指定することができます。${archive}/README.en と + ${archive}/SEMI-CFG のコメントを読んでください。 初期化 -============== +====== (a) load-path - Emacs か Mule を使っているなら、FLIM のディレクトリーを - load-path に追加してください。初期設定でインストールしたなら、次のよ - うに subdirs.el を書くことができます。例: + あなたが XEmacs 21.1 以降あるいは GNU Emacs 20.4 以降を使用しているな + ら、load-path に関して必要な設定はありません。 - -------------------------------------------------------------------- - (normal-top-level-add-to-load-path - '("apel" "flim" "semi")) - -------------------------------------------------------------------- +(b) mime-setup - XEmacs を使っているなら、load-path を設定する必要はありません。 + あなたの ~/.emacs に以下の記述を追加してください。: -(b) mime-setup + (load "mime-setup") - 以下のものを ~/.emacs に入れてください。 +付属資料 +======== - (load "mime-setup") + SEMI を使い始めるために、${archive}/README.en を読んでください。 + RFC 822, 1524, 1806, 1847, 1896, 2015, 2045, 2046, 2047, 2048 および + 2049 は anonymous ftp を経由して入手可能です。: -説明文書 -============= + ftp://ftp.merit.edu/internet/documents/rfc/ - 初めに、${archive}/README.en を読んでください。 +メーリングリスト +================ - RFC 822, 1524, 1806, 1847, 1896, 2015, 2045, 2046, 2047, 2048, 2049 - は anonymous ftp で以下のところから取得可能です。 + もし、あなたが、バグレポートおよび/または改良のための提案を書く場合には、 + それらを EMACS-MIME メーリングリストに送ってください。 - ftp://ftp.merit.edu/internet/documents/rfc/ + emacs-mime-en@m17n.org (英語) + emacs-mime-ja@m17n.org (日本語) + EMACS-MIME ML を経由して、あなたは SEMI のバグを報告することや、SEMI + の最新版の入手、SEMI の将来の強化について議論することなどができます。 + EMACS-MIME ML に加入するためには、本文に -メーリングリスト -=========== + subscribe あなたの名前 + 例: subscribe MORIOKA Tomohiko - バグ報告や改善の提案を書いたときは、是非 tm メーリングリストに送って - ください: +と書いたメールを次のアドレスのどちらかに送信してください。 - bug-tm-en@chamonix.jaist.ac.jp (英語) - bug-tm-ja@chamonix.jaist.ac.jp (日本語) + emacs-mime-en-ctl@m17n.org (英語) + emacs-mime-ja-ctl@m17n.org (日本語) - tm ML を通して、SEMIのバグを報告したり、SEMI の最新のリリースを取得 - したり、SEMI の将来の拡張の議論をしたりすることができます。tm ML に - 参加するには、空の電子メールを + ここで、morioka@jaist.ac.jp などの作者(達)に直接メールを送信してはな + らないことに注意してください。なぜなら、あなたの問題は、他の環境に生 + じるかもしれないからです(そうでなければそれはSEMIのバクでは無く、あな + たの問題であるかもしれません)。 我々は、EMACS-MIME メーリングリスト内 + で議論します。とりあえず、作者への直接のメールは無視されるかもしれま + せん。EMACS-MIME メーリングリストにメールを送信してください。 - tm-en-help@chamonix.jaist.ac.jp (英語) - tm-ja-help@chamonix.jaist.ac.jp (日本語) +CVS に基づいた開発 +================== - に送ってください。 + SEMI の開発版のソースは、CVS の pserver でアクセスすることができます。 + チェックアウトするためには、最初に以下の操作を行なって下さい。 - morioka@jaist.ac.jp のような、作者に直接メールを送らないように注意し - てください。それは、発生した問題は他の環境でも起こっているはずだから - です (もしそうでなければ、それは設定の問題で、SEMI のバグではありま - せん)。 tm メーリングリストで議論すべきです。とにかく、作者への直接 - のメールは反応がないかもしれません。メールは tm メーリングリストへ送っ - てください。 + % cvs -d :pserver:anonymous@cvs.m17n.org:/cvs/root login + CVS password: [CR] # 空文字列 + 以後は次の操作によって、最新の SEMI のソースを取得することができます。 -CVS による開発 -===================== + % cvs -d :pserver:anonymous@cvs.m17n.org:/cvs/root checkout -r semi-1_14 semi - CVS による開発に参加したいときは、アカウント名と UNIX 様式で暗号化さ - れたパスワードを + もしあなたが CVS に基づいた開発に参加したいと思うならば、以下のアドレスに、 + あなたのアカウント名と ssh の public key を添えたメールを送信してください。 - cvs@chamonix.jaist.ac.jp + cvs@cvs.m17n.org - に送ってください。開発に参加されることを期待しています。 + CVSROOT は、:ext:cvs@cvs.m17n.org:/cvs/root です。 + 我々は、あなたが開かれた開発に参加してくださることを期待しています。 作者 -======= +==== -根本部分の作者 +元の作者 MORIOKA Tomohiko - (the author of mime-view and various parts of SEMI) + (SEMI のいろいろな部分と mime-view の作者) UMEDA Masanobu - (the author of mime.el of emacs-mime-tools. mime.el is the - origin of mime-edit.el of SEMI) + (emacs-mime-tools の mime.el の作者。mime.el は SEMI の + meme-edit.el の原型です) 他の作者 Shuhei KOBAYASHI - (a major author of signature.el and a lot of codes) + (たくさんのコードと signature.el の主要な作者) MASUTANI Yasuhiro - (anonymous ftp codes of mime-play.el) + (mime-play.el の anonymous ftp コード) OKABE Yasuo - (a major author of mime-partial.el and signature.el) + (mime-partial.el と signature.el の主要な作者) Steinar Bang Steven L. Baur @@ -251,8 +250,9 @@ CVS による開発 Hisashi Miyashita Kazuhiro Ohta Alexandre Oliva - Fran,Agois Pinard + Fran苡is Pinard + Artur Pioro Artur Pioro Dan Rich - (contribute to evolve mime-image.el with XEmacs) + (XEmacs と共に mime-image.el を発展させるために寄与) Katsumi Yamaoka