create chapter on newml

4 files changed, 227 insertions, 106 deletions

diff --git a/fml/doc/ja/tutorial/book.sgml b/fml/doc/ja/tutorial/book.sgml
index da4f3ea0..057185b0 100644
--- a/fml/doc/ja/tutorial/book.sgml
+++ b/fml/doc/ja/tutorial/book.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: book.sgml,v 1.29 2002/02/16 13:23:24 fukachan Exp $
+$FML: book.sgml,v 1.30 2002/03/18 06:57:35 fukachan Exp $
 -->
 
 <!doctype book public "-//FML//DTD DocBook V3.1-Based Extension//EN" [
@@ -49,6 +49,7 @@ $FML: book.sgml,v 1.29 2002/02/16 13:23:24 fukachan Exp $
 	</para>
 	</partintro>
 
+	&chapter.usage.newml;
 	&chapter.usage.post;
 	&chapter.usage.command;
 	&chapter.usage.onhost;
diff --git a/fml/doc/ja/tutorial/include/chapters.ent b/fml/doc/ja/tutorial/include/chapters.ent
index 0128f4c9..e94ac38e 100644
--- a/fml/doc/ja/tutorial/include/chapters.ent
+++ b/fml/doc/ja/tutorial/include/chapters.ent
@@ -1,5 +1,5 @@
 <!--
-	$FML: chapters.ent,v 1.31 2002/02/16 13:23:25 fukachan Exp $
+	$FML: chapters.ent,v 1.32 2002/03/18 06:57:36 fukachan Exp $
 -->
 
 <!entity versin "1.1">
@@ -29,6 +29,7 @@
 
 
 <!-- パート II: 使い方の例とカスタマイズについて -->
+<!entity chapter.usage.newml     SYSTEM "usage/newml.sgml">
 <!entity chapter.usage.post      SYSTEM "usage/post.sgml">
 <!entity chapter.usage.command   SYSTEM "usage/command.sgml">
 <!entity chapter.usage.onhost    SYSTEM "usage/onhost.sgml">
diff --git a/fml/doc/ja/tutorial/overview/chapter.sgml b/fml/doc/ja/tutorial/overview/chapter.sgml
index 15976ba2..c2e72535 100644
--- a/fml/doc/ja/tutorial/overview/chapter.sgml
+++ b/fml/doc/ja/tutorial/overview/chapter.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: chapter.sgml,v 1.7 2002/02/04 00:03:57 fukachan Exp $
+   $FML: chapter.sgml,v 1.8 2002/02/26 14:15:28 fukachan Exp $
 -->
 
 <chapter id="overview"> 
@@ -146,115 +146,19 @@ root での作業、 configure の使用、
    <title> ＭＬを作る </title>
 
 <para>
-方法は &fml4; と同様です。 
-現状では 
-config.cf (設定ファイル) と
-fml を起動するために MTA が呼び出すファイルである
-include 
-および
-include-ctl をインストールしてくれます。 
+makefml を使ってＭＬを作成します。
+(デフォルトドメインの場合) makefml 使い方は &fml4; の時と同様です。
 <screen>
 % su fml
 % makefml newml elena
-% ls /var/spool/ml/elena
-config.cf include include-ctl
-</screen>
-カスタマイズは config.cf をエディタで編集して下さい。
-とりあえず 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>
+詳しくは
+<link linkend="usage.newml">
+<xref linkend="usage.newml">
+</link>
+を参照してください。
 </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>
-
-
-<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>
-aliases はまだ makefml が生成していません
-( &fmldevel; は virtual domain を前提にした扱いなので、
-ディレクトリ構成などをもうちょっと考えたいので、まだ自動生成されていません。
-もうちょっと待って〜)。
-</para>
-
-
-<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>
-
-<!--
-
-        案１
-        /etc/fml/ドメイン名/aliases
-
-        案２ (prefix は virtual_maps でドメインごとに定義されているの
-                で一意に定まる)
-        /var/spool/ml/etc/mail/aliases
-
--->
-
-
 </sect1>
 
 
diff --git a/fml/doc/ja/tutorial/usage/newml.sgml b/fml/doc/ja/tutorial/usage/newml.sgml
new file mode 100644
index 00000000..8603cf8b
--- /dev/null
+++ b/fml/doc/ja/tutorial/usage/newml.sgml
@@ -0,0 +1,215 @@
+<!--
+   $FML: post.sgml,v 1.2 2001/11/24 03:22:59 fukachan Exp $
+-->
+
+<!--
+
+        案１
+        /etc/fml/ドメイン名/aliases
+
+        案２ (prefix は virtual_maps でドメインごとに定義されているの
+                で一意に定まる)
+        /var/spool/ml/etc/mail/aliases
+
+-->
+
+
+<chapter id="usage.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 の設定を仕込む
+        </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>
+
+
+<sect1>
+	<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>
+
+
+<sect1>
+	<title>
+	aliaess のカスタマイズ
+	</title>
+
+<para>
+makefml はシステムの aliases を変更することはありませんが、
+$ml_home_prefix/etc/mail/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>
+
+
+<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>
+
+</sect1>
+
+
+</chapter>