diff options
Diffstat (limited to 'fml/doc/ja/tutorial/overview.sgml')
| -rw-r--r-- | fml/doc/ja/tutorial/overview.sgml | 204 |
1 files changed, 204 insertions, 0 deletions
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$ +--> + +<chapter id="overview"> +<title> おおまかな流れ </title> + +<sect1> + <title> 概要 </title> + +<warning> +<para> +fml-devel +は動くとはいえ、まだまだ開発者向けのプログラムであることに注意して +下さい。実運用には + <ulink url="http://www.fml.org/fml/"> + fml 4.0 + </ulink> +系を御利用下さい。 +</para> +</warning> + + +<para> +以下で、特に触れていない概念(例: MLとは?)については fml 4.0 と同様 +です。4.0 の資料を適宜参照して下さい。 +</para> + +<para> +いつものように elena MLを例にとりましょう。 +elena MLを作成するまでのおおまかな流れは次のようになります。 +</para> + + +<orderedlist> + <listitem> + <para> + <link linkend="download"> + ソースをダウンロードをする。 + </link> + </para> + </listitem> + + <listitem> + <para> + <link linkend="install"> + ユーザ root でインストールをする。 + </link> + + インストーラは /usr/local/bin に + fmldoc fmlconf fmlticket makefml + をインストールします。 + + これらは、 + 実は、 + /usr/local/libexec/fml の下の実体を呼び出す単なる + wrapper です。 + + なお、インストールされるコマンドの一覧は + <link linkend="available"> + ここ + </link> + にあります。 + </para> + </listitem> + + + <listitem> + <para> + <link linkend="guide.newml"> + ユーザ fml で elena MLを作る。 + </link> + </para> + </listitem> + + + <listitem> + <para> + <link linkend="guide.config.cf"> + カスタマイズをする。 + </link> + </para> + </listitem> + +</orderedlist> + +</sect1> + + + + +<sect1 id="guide.newml"> + + <title> MLを作る </title> + +<para> +fml 4.0 と同様です。 +が、config.cf という設定ファイルをインストールしてくれるだけです。 + +インストール後は、次のようになるはずです。 +<screen> +% su fml +% makefml newml elena +% ls /var/spool/ml/elena +config.cf +</screen> +</para> + + +<para> +とりあえず config.cf の先頭の ml_domain と ml_name を +自分のMLに変更して下さい。 +まだ自動変換できません(そのうちします)。 +</para> + + +<para> +<screen> +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 +</screen> +</para> + + +<para> +include include-ctl aliases も fml 4.0 と同様です。 +が、まだ、makefml newml で自動生成できるようになっていません _o_ +</para> + +<para> +/var/spool/ml/elena/include ファイルは +<screen> +"| /usr/local/libexec/fml/fml.pl /var/spool/ml/elena" +</screen> + +/var/spool/ml/elena/include-ctl ファイルは +<screen> +"| /usr/local/libexec/fml/fml.pl /var/spool/ml/elena --ctladdr" +</screen> +</para> + + +<para> +aliases への追加は次のようにして下さい。 +<screen> +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 +</screen> +</para> + +</sect1> + + + +<sect1 id="guide.config.cf"> + +<title> カスタマイズをする </title> + +<para> +elena MLの設定のカスタマイズは /var/spool/ml/elena/config.cf を編集 +して下さい。フォーマットは fml 4.0 の cf に近いですが、postfix の設定 +ファイルと同様です。 +</para> + +<para> +必要な項目を追加して下さい。それ以外はデフォルト値が使われます。 +デフォルト値はインストールしたバージョンに依存し、 + +<screen> +/etc/fml/defaults/バージョン番号/default_config.cf +</screen> + +というファイルで定義されています。 + +これは perl のライブラリが /usr/local/lib/perl/5.00503/ のように +バージョン番号付のディレクトリに置かれるのと同様です。 +</para> + +<para> +インストールした fml のバージョンごとに全部別のディレクトリに +置かれることに注意して下さい。 +この仕組みのおかげでアップグレードしても元に戻すのが簡単です。 +</para> + +</sect1> + +</chapter> |
