From a0ec7d2f43ded31fdd563b13d36b6200c811dacb Mon Sep 17 00:00:00 2001 From: fukachan Date: Wed, 25 Apr 2001 14:30:19 +0000 Subject: merge guide.html and mailinglist.html --- fml/doc/ja/tutorial/fml-devel.sgml | 3 +- fml/doc/ja/tutorial/include.sgml | 3 +- fml/doc/ja/tutorial/overview.sgml | 204 ++++++++++++++++++++++++++++++ fml/doc/ja/tutorial/overview/chapter.sgml | 204 ++++++++++++++++++++++++++++++ fml/doc/ja/tutorial/preface.sgml | 52 +++++++- 5 files changed, 463 insertions(+), 3 deletions(-) create mode 100644 fml/doc/ja/tutorial/overview.sgml create mode 100644 fml/doc/ja/tutorial/overview/chapter.sgml (limited to 'fml/doc/ja/tutorial') diff --git a/fml/doc/ja/tutorial/fml-devel.sgml b/fml/doc/ja/tutorial/fml-devel.sgml index e75f1e04..23db0e84 100644 --- a/fml/doc/ja/tutorial/fml-devel.sgml +++ b/fml/doc/ja/tutorial/fml-devel.sgml @@ -2,7 +2,7 @@ This is an sgml using DocBook dtd. Use sgmltools version 2.0.x or above to generate various output formats. -$FML: fml-devel.sgml,v 1.12 2001/04/25 02:55:56 fukachan Exp $ +$FML: fml-devel.sgml,v 1.13 2001/04/25 03:54:02 fukachan Exp $ --> &intro; + &overview; &download; &install; &available; diff --git a/fml/doc/ja/tutorial/include.sgml b/fml/doc/ja/tutorial/include.sgml index 3a79f1ba..f7300d57 100644 --- a/fml/doc/ja/tutorial/include.sgml +++ b/fml/doc/ja/tutorial/include.sgml @@ -1,5 +1,5 @@ @@ -19,6 +19,7 @@ + diff --git a/fml/doc/ja/tutorial/overview.sgml b/fml/doc/ja/tutorial/overview.sgml new file mode 100644 index 00000000..996474c3 --- /dev/null +++ b/fml/doc/ja/tutorial/overview.sgml @@ -0,0 +1,204 @@ + + + + おおまかな流れ + + + 概要 + + + +fml-devel +は動くとはいえ、まだまだ開発者向けのプログラムであることに注意して +下さい。実運用には + + fml 4.0 + +系を御利用下さい。 + + + + + +以下で、特に触れていない概念(例: ＭＬとは？)については fml 4.0 と同様 +です。4.0 の資料を適宜参照して下さい。 + + + +いつものように elena ＭＬを例にとりましょう。 +elena ＭＬを作成するまでのおおまかな流れは次のようになります。 + + + + + + + + ソースをダウンロードをする。 + + + + + + + + ユーザ root でインストールをする。 + + + インストーラは /usr/local/bin に + fmldoc fmlconf fmlticket makefml + をインストールします。 + + これらは、 + 実は、 + /usr/local/libexec/fml の下の実体を呼び出す単なる + wrapper です。 + + なお、インストールされるコマンドの一覧は + + ここ + + にあります。 + + + + + + + + ユーザ fml で elena ＭＬを作る。 + + + + + + + + + カスタマイズをする。 + + + + + + + + + + + + + + ＭＬを作る + + +fml 4.0 と同様です。 +が、config.cf という設定ファイルをインストールしてくれるだけです。 + +インストール後は、次のようになるはずです。 + +% su fml +% makefml newml elena +% ls /var/spool/ml/elena +config.cf + + + + + +とりあえず config.cf の先頭の ml_domain と ml_name を +自分のＭＬに変更して下さい。 +まだ自動変換できません（そのうちします）。 + + + + + +config.cf の例 + +# ドメイン名 (参照: 以下のアドレスを見よ $ml_domain がこの値に展開される) +ml_domain = fml.org + +# ML の名前 +ml_name = elena + +# 管理者のアドレス +maintainer = $ml_name-admin@$ml_domain + +# 投稿用のアドレス +address_for_post = $ml_name@$ml_domain + +# コマンド用のアドレス +address_for_command = $ml_name-ctl@$ml_domain + + + + + +include include-ctl aliases も fml 4.0 と同様です。 +が、まだ、makefml newml で自動生成できるようになっていません _o_ + + + +/var/spool/ml/elena/include ファイルは + +"| /usr/local/libexec/fml/fml.pl /var/spool/ml/elena" + + +/var/spool/ml/elena/include-ctl ファイルは + +"| /usr/local/libexec/fml/fml.pl /var/spool/ml/elena --ctladdr" + + + + + +aliases への追加は次のようにして下さい。 + +elena: :include:/var/spool/ml/elena/include +elena-ctl: :include:/var/spool/ml/elena/include-ctl +elena-admin: fml +owner-elena: fml +owner-elena-ctl: fml + + + + + + + + + + カスタマイズをする + + +elena ＭＬの設定のカスタマイズは /var/spool/ml/elena/config.cf を編集 +して下さい。フォーマットは fml 4.0 の cf に近いですが、postfix の設定 +ファイルと同様です。 + + + +必要な項目を追加して下さい。それ以外はデフォルト値が使われます。 +デフォルト値はインストールしたバージョンに依存し、 + + +/etc/fml/defaults/バージョン番号/default_config.cf + + +というファイルで定義されています。 + +これは perl のライブラリが /usr/local/lib/perl/5.00503/ のように +バージョン番号付のディレクトリに置かれるのと同様です。 + + + +インストールした fml のバージョンごとに全部別のディレクトリに +置かれることに注意して下さい。 +この仕組みのおかげでアップグレードしても元に戻すのが簡単です。 + + + + + diff --git a/fml/doc/ja/tutorial/overview/chapter.sgml b/fml/doc/ja/tutorial/overview/chapter.sgml new file mode 100644 index 00000000..996474c3 --- /dev/null +++ b/fml/doc/ja/tutorial/overview/chapter.sgml @@ -0,0 +1,204 @@ + + + + おおまかな流れ + + + 概要 + + + +fml-devel +は動くとはいえ、まだまだ開発者向けのプログラムであることに注意して +下さい。実運用には + + fml 4.0 + +系を御利用下さい。 + + + + + +以下で、特に触れていない概念(例: ＭＬとは？)については fml 4.0 と同様 +です。4.0 の資料を適宜参照して下さい。 + + + +いつものように elena ＭＬを例にとりましょう。 +elena ＭＬを作成するまでのおおまかな流れは次のようになります。 + + + + + + + + ソースをダウンロードをする。 + + + + + + + + ユーザ root でインストールをする。 + + + インストーラは /usr/local/bin に + fmldoc fmlconf fmlticket makefml + をインストールします。 + + これらは、 + 実は、 + /usr/local/libexec/fml の下の実体を呼び出す単なる + wrapper です。 + + なお、インストールされるコマンドの一覧は + + ここ + + にあります。 + + + + + + + + ユーザ fml で elena ＭＬを作る。 + + + + + + + + + カスタマイズをする。 + + + + + + + + + + + + + + ＭＬを作る + + +fml 4.0 と同様です。 +が、config.cf という設定ファイルをインストールしてくれるだけです。 + +インストール後は、次のようになるはずです。 + +% su fml +% makefml newml elena +% ls /var/spool/ml/elena +config.cf + + + + + +とりあえず config.cf の先頭の ml_domain と ml_name を +自分のＭＬに変更して下さい。 +まだ自動変換できません（そのうちします）。 + + + + + +config.cf の例 + +# ドメイン名 (参照: 以下のアドレスを見よ $ml_domain がこの値に展開される) +ml_domain = fml.org + +# ML の名前 +ml_name = elena + +# 管理者のアドレス +maintainer = $ml_name-admin@$ml_domain + +# 投稿用のアドレス +address_for_post = $ml_name@$ml_domain + +# コマンド用のアドレス +address_for_command = $ml_name-ctl@$ml_domain + + + + + +include include-ctl aliases も fml 4.0 と同様です。 +が、まだ、makefml newml で自動生成できるようになっていません _o_ + + + +/var/spool/ml/elena/include ファイルは + +"| /usr/local/libexec/fml/fml.pl /var/spool/ml/elena" + + +/var/spool/ml/elena/include-ctl ファイルは + +"| /usr/local/libexec/fml/fml.pl /var/spool/ml/elena --ctladdr" + + + + + +aliases への追加は次のようにして下さい。 + +elena: :include:/var/spool/ml/elena/include +elena-ctl: :include:/var/spool/ml/elena/include-ctl +elena-admin: fml +owner-elena: fml +owner-elena-ctl: fml + + + + + + + + + + カスタマイズをする + + +elena ＭＬの設定のカスタマイズは /var/spool/ml/elena/config.cf を編集 +して下さい。フォーマットは fml 4.0 の cf に近いですが、postfix の設定 +ファイルと同様です。 + + + +必要な項目を追加して下さい。それ以外はデフォルト値が使われます。 +デフォルト値はインストールしたバージョンに依存し、 + + +/etc/fml/defaults/バージョン番号/default_config.cf + + +というファイルで定義されています。 + +これは perl のライブラリが /usr/local/lib/perl/5.00503/ のように +バージョン番号付のディレクトリに置かれるのと同様です。 + + + +インストールした fml のバージョンごとに全部別のディレクトリに +置かれることに注意して下さい。 +この仕組みのおかげでアップグレードしても元に戻すのが簡単です。 + + + + + diff --git a/fml/doc/ja/tutorial/preface.sgml b/fml/doc/ja/tutorial/preface.sgml index 0b73637b..b4945e65 100644 --- a/fml/doc/ja/tutorial/preface.sgml +++ b/fml/doc/ja/tutorial/preface.sgml @@ -1,5 +1,5 @@ @@ -156,6 +156,56 @@ fml-devel + + + + メーリングリスト + + +fml 5 の議論のためのメーリングリストを用意してあります。 + + + +登録の仕方はいつもと一緒です。 + +fml-devel MLへの自動登録は fml-devel-ctl@ffs.fml.org へ +subscribe の後に自分の名前をローマ字で続けたフレーズをメールの"本文" +(注意: メールの本文)に書いて送って下さい。例えば次のようになります。 + + +To: fml-devel-ctl@ffs.fml.org + +subscribe Kinomoto Sakura + + +このメールに対し、登録意志確認のメールが送り返されてきます。 +そのメールに返事をしてください。 +ＭＬに登録されます。 + + + +fml-devel ＭＬのログは + + http://www.fml.org/mlarchives/ + +で公開しています。 + + + +ＭＬに参加しないが、要望等を送りたいという場合、ＭＬではなく + + + fml-request@fml.org + + +へメールを送って下さい。このメールは適宜 fml-devel 等に流して議論した +いと思います。他にフォワードなどされたくない場合はその旨を一筆書いてお +いて下さい。 + + + + + -- cgit v1.2.1