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>
+ＭＬのカスタマイズは 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 上でＭＬを作成する
+	</title>
+
+
+<sect1>
+	<title>
+	makefml newml でＭＬを作る
+	</title>
+
+<para>
+makefml を使ってＭＬを作成します。
+使い方は &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 インターフェイスを用意する。
+	ドメインで一番偉いインターフェイス(そのドメインのＭＬは全部操
+	作できる)が
+	<screen>
+	~fml/public_html/cgi-bin/fml/$domain/admin/menu.cgi
+	</screen>
+	また、各ＭＬで一番偉いインターフェイス(そのＭＬの操作ができる)
+	<screen>
+	~fml/public_html/cgi-bin/fml/$domain/ml-admin/menu.cgi
+	</screen>
+        </para>
+   </listitem>
+
+</itemizedlist>
+</para>
+
+</sect1>
+
+
+<!-- メールサーバの設定について -->
+&sect.setup.postfix;
+&sect.setup.qmail;
+
+
+<!-- 各ＭＬの設定について -->
+&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 が適切に設定されていれば、
+ＭＬ作成時にも特別な作業はありません。
+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 でも自動的にＭＬが有効になります。
+<screen>
+fml.org:fml-fml.org
+</screen>
+</para>
+
+<warning>
+<para>
+この設定は、ＭＬ用に一つのドメインをまるまる使うことを前提としています。
+</para>
+</warning>
+
+</sect1>