summaryrefslogtreecommitdiff
path: root/fml/doc/ja/tutorial
diff options
context:
space:
mode:
Diffstat (limited to 'fml/doc/ja/tutorial')
-rw-r--r--fml/doc/ja/tutorial/setup/config.cf.sgml73
-rw-r--r--fml/doc/ja/tutorial/setup/newml.sgml95
-rw-r--r--fml/doc/ja/tutorial/setup/postfix.sgml56
-rw-r--r--fml/doc/ja/tutorial/setup/qmail.sgml30
4 files changed, 254 insertions, 0 deletions
diff --git a/fml/doc/ja/tutorial/setup/config.cf.sgml b/fml/doc/ja/tutorial/setup/config.cf.sgml
new file mode 100644
index 00000000..ada4f957
--- /dev/null
+++ b/fml/doc/ja/tutorial/setup/config.cf.sgml
@@ -0,0 +1,73 @@
+<!--
+ $FML$
+-->
+
+<sect1 id="setup.config.cf">
+ <title>
+ 設定ファイル config.cf のカスタマイズ
+ </title>
+
+<para>
+makefml は
+config.cf (設定ファイル) と
+fml を起動するために MTA が呼び出すファイルである
+include
+および
+include-ctl をインストールしてくれます。
+<screen>
+% su fml
+% makefml newml elena
+ ... snip ...
+% ls /var/spool/ml/elena
+config.cf include include-ctl
+</screen>
+</para>
+
+<para>
+MLのカスタマイズは config.cf をエディタで編集して下さい。
+<warning>
+<para>
+まだ、設定ツールはできていません。
+</para>
+</warning>
+とりあえず config.cf の先頭の ml_domain と ml_name が
+正しいかどうかを確認して下さい。
+<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 の書き方は &fml4; と同様です。
+include ファイルの PATH がちょっと違いますが、
+aliases の設定の仕方は一緒です。
+</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>
+
+</sect1>
diff --git a/fml/doc/ja/tutorial/setup/newml.sgml b/fml/doc/ja/tutorial/setup/newml.sgml
new file mode 100644
index 00000000..71e8969e
--- /dev/null
+++ b/fml/doc/ja/tutorial/setup/newml.sgml
@@ -0,0 +1,95 @@
+<!--
+ $FML: newml.sgml,v 1.3 2002/07/02 10:39:39 fukachan Exp $
+-->
+
+
+<chapter id="setup.newml">
+ <title>
+ UNIX 上でMLを作成する
+ </title>
+
+
+<sect1>
+ <title>
+ makefml newml でMLを作る
+ </title>
+
+<para>
+makefml を使ってMLを作成します。
+使い方は &fml4; と同様です。
+<screen>
+% su fml
+% makefml newml elena
+</screen>
+</para>
+
+
+<para>
+この時、makefml newml は以下のような処理をします。
+
+<itemizedlist>
+
+ <listitem>
+ <para>
+ /var/spool/ml/elena へ
+ <screen>
+ config.cf
+ include
+ include-ctl
+ </screen>
+ などを作る(適宜、elena やドメインの値を変換しながら)
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ /var/spool/ml/etc/mail/aliases に elena の設定を仕込む。
+ postalias で /var/spool/ml/etc/mail/aliases.db を再生成する。
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <screen>
+ ~fml/public_html/$domain/$ml/
+ </screen>
+ 例えば elena@fml.org なら
+ <screen>
+ ~fml/public_html/fml.org/elena/
+ </screen>
+ を用意する。
+ ここに HTML 化された記事が自動的に作られることになる(でふぉると)。
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ CGI インターフェイスを用意する。
+ ドメインで一番偉いインターフェイス(そのドメインのMLは全部操
+ 作できる)が
+ <screen>
+ ~fml/public_html/cgi-bin/fml/$domain/admin/menu.cgi
+ </screen>
+ また、各MLで一番偉いインターフェイス(そのMLの操作ができる)
+ <screen>
+ ~fml/public_html/cgi-bin/fml/$domain/ml-admin/menu.cgi
+ </screen>
+ </para>
+ </listitem>
+
+</itemizedlist>
+</para>
+
+</sect1>
+
+
+<!-- メールサーバの設定について -->
+&sect.setup.postfix;
+&sect.setup.qmail;
+
+
+<!-- 各MLの設定について -->
+&sect.setup.config.cf;
+
+
+</chapter>
diff --git a/fml/doc/ja/tutorial/setup/postfix.sgml b/fml/doc/ja/tutorial/setup/postfix.sgml
new file mode 100644
index 00000000..7a068dcf
--- /dev/null
+++ b/fml/doc/ja/tutorial/setup/postfix.sgml
@@ -0,0 +1,56 @@
+<sect1 id="setup.postfix.aliases">
+ <title>
+ メールサーバの設定 (postfix)
+ </title>
+
+<important>
+<para>
+alias_maps が適切に設定されていれば、
+ML作成時にも特別な作業はありません。
+postfix の設定は自動的に更新されています。
+</para>
+</important>
+
+
+<para>
+makefml はシステムの aliases を変更することはありませんが、
+$ml_home_prefix/etc/mail/aliases
+への追加と aliases.db の更新が自動的に行なわれています。
+</para>
+
+
+<sect2>
+ <title>
+ 例: /var/spool/ml/etc/mail/aliases のフォーマット
+ </title>
+
+<para>
+aliases のエントリは
+$ml_home_prefix/etc/mail/aliases
+に追加されます。
+<screen>
+### BEGIN-elena@fml.org-ML-aliases ###
+
+# address for post
+elena: :include:/var/spool/ml/elena/include
+owner-elena: fukachan
+
+# address for command
+elena-ctl: :include:/var/spool/ml/elena/include-ctl
+owner-elena-ctl: fukachan
+
+# maintainer
+elena-request: elena-admin
+elena-admin: fukachan
+
+### END-elena@fml.org-ML-aliases ###
+</screen>
+バーチャルドメインの場合、
+$ml_home_prefix の部分は
+$virtual_maps にしたがって自動的に変化します。
+</para>
+
+</sect2>
+
+
+</sect1>
diff --git a/fml/doc/ja/tutorial/setup/qmail.sgml b/fml/doc/ja/tutorial/setup/qmail.sgml
new file mode 100644
index 00000000..d46ceb90
--- /dev/null
+++ b/fml/doc/ja/tutorial/setup/qmail.sgml
@@ -0,0 +1,30 @@
+<sect1 id="setup.qmail.aliases">
+ <title>
+ メールサーバの設定 (qmail)
+ </title>
+
+<para>
+makefml newml は次のような qmail 用の設定ファイルを作ります。
+<screen>
+~/.qmail-fml:org-elena
+~/.qmail-fml:org-elena-ctl
+</screen>
+よって
+<screen>
+/var/qmail/control/virtualdomains
+</screen>
+に、あらかじめ次のような設定を仕込んでおけば、
+makefml newml を実行するだけで
+qmail でも自動的にMLが有効になります。
+<screen>
+fml.org:fml-fml.org
+</screen>
+</para>
+
+<warning>
+<para>
+この設定は、ML用に一つのドメインをまるまる使うことを前提としています。
+</para>
+</warning>
+
+</sect1>