merged to tutorial/virtual/

2 files changed, 105 insertions, 51 deletions

diff --git a/fml/doc/ja/01_RFC_VIRTUAL.txt b/fml/doc/ja/01_RFC_VIRTUAL.txt
index 59f56cc2..2e311d76 100644
--- a/fml/doc/ja/01_RFC_VIRTUAL.txt
+++ b/fml/doc/ja/01_RFC_VIRTUAL.txt
@@ -1,52 +1,3 @@
-X-Sequence: fml-devel 203
-
-問題1 :	virtual domain のサポートをどうする？
-	統一的に扱いたい。＃ すでに postfix と qmail は OK ？
-
-問題2:	場変(ホストを新しくする、ドメインを変更する)場合に、
-	いかに簡単に設定変更ができるか？
-
-◎ バーチャルドメインのサポート
-
- ○ おもな手順
-   	/etc/fml/virtual は手で編集してください (最初に一回)。
-	それ以降のコマンド、CGI ではドメインに関わらず操作方法は
-	同じであることがのぞましい。
-
- ○ コマンドの操作
-	makefml newml	ML@virtualdomain
-	makefml add	ML@virtualdomain	address
-	makefml bye	ML@virtualdomain	address
-
-  ○ CGI での操作
-	URL にドメインが入っているので、よしなに取り計らえる
-	＃ 注意: config.cgi 生成時にドメインが埋め込まれる
-
-	http://lists/~fml/cgi-bin/fml/$domain/admin/config.cgi
-
-◎ 場変
-
-	ホストを新しくする？ ドメインを変更する？ 他には？
-
-   ○ ドメインの変更 (は考えなくても良いか？)
-	ドメインの変更なんてそんなにあるか？
-	変更するならＭＬも作りなおすような気がする（嘘？）
-	いずれにせよ、ドメインの移行はいっぱい直すところが
-	あるので、そんなに簡単じゃない。
-
-
-   ○  ホストを新しくする
-	これは割とありそうだ。
-
-	解決しないといけない問題:
-	* ディレクトリのパスが変わる
-		/etc/fml/ の変更だけで解決できないか？
-
-		→ include ファイルの書式変更が必要
-		例: こんなんはどうよ？
-		"| /some/where/libexec/distribute elena@fml.org"
-
-	fml.pl は互換性のため fml.pl $DIR でも可で、
-	libexec/distribute libexec/command など新しいコマンドは
-	ＭＬ名を引数にとるということにしてもよいのかもしれない。
+moved to tutorial/
 
+http://www.fml.org/software/fml-devel/Documentation/ja/tutorial/
diff --git a/fml/doc/ja/tutorial/virtual/chapter.sgml b/fml/doc/ja/tutorial/virtual/chapter.sgml
new file mode 100644
index 00000000..4a4e4c38
--- /dev/null
+++ b/fml/doc/ja/tutorial/virtual/chapter.sgml
@@ -0,0 +1,103 @@
+<chapter id="virtualdomain">
+	<title>
+	バーチャルドメインの取り扱いについて
+	</title>
+
+<para>
+virtual domain のサポートをどう実装するか？が問題の一です。
+できるだけ fml 全体で統一的に扱えるようにするべきです。
+</para>
+
+<para>
+そして問題のその２は、場変(ホストを新しくする、ドメインを変更する)場合に
+いかに簡単に設定変更ができるか？という設問です。
+</para>
+
+
+<sect1 id="virtualdomain.fml8.overview">
+	<title>
+	概要: &fmldevel; におけるバーチャルドメインの取り扱い
+	</title>
+
+<para>
+最初に一回 
+<link linkend="install.virtual">
+/etc/fml/virtual を手で編集
+</link>
+してください。これだけです。あとは fml がよろしく頑張ります。
+ただし、いろいろな操作でＭＬ名を＠ドメインつきで行なって下さい。
+</para>
+
+<para>
+例えば、コマンドの操作はＭＬではなく、ＭＬ＠ドメイン名を使うことになり
+ます。つまり
+<screen>
+makefml newml	ML@virtualdomain
+makefml add	ML@virtualdomain	address
+makefml bye	ML@virtualdomain	address
+</screen>
+などという具合いになります。
+</para>
+
+<para>
+なお、CGI での操作ではドメイン名の指定は不要です。
+これは、config.cgi 生成時にドメインがスクリプト中に埋め込まれているためです。
+</para>
+
+<warning>
+<para>
+CGI の URL にはドメインが入っているのは操作する人が分かりやすいようにという
+配慮であって、URL を元にドメイン名を決めているわけではありません。
+<screen>
+http://lists/~fml/cgi-bin/fml/$domain/admin/config.cgi
+</screen>
+</para>
+</warning>
+
+</sect1>
+
+
+<sect1>
+	<title>
+	ケーススタディ: 場変？ (XXX 書きかけ↓つづきを！)
+	</title>
+
+<!--
+	レシピ化を！
+-->
+
+<para>
+ホストを新しくする？ ドメインを変更する？ 他には何かある？
+</para>
+
+<para>
+ドメインの変更は考えなくても良いか？
+ドメインの変更なんてそんなにあるか？
+変更するならＭＬも作りなおすような気がする（嘘？）。
+いずれにせよ、ドメインの移行はいっぱい直すところが
+あるので、そんなに簡単じゃない。
+</para>
+
+<para>
+ホストを新しくするか？
+うむ、これは割とありそうだ。
+</para>
+
+<para>
+解決しないといけない問題はディレクトリのパスが変わること。
+/etc/fml/ の変更だけで解決できないか？
+
+いや、include ファイルがこんな風になっているが、
+<screen>
+"| /some/where/libexec/distribute elena@fml.org"
+</screen>
+書式変更が必要ではないのか？
+一応、fml.pl は互換性のため fml.pl $DIR でも可で、
+libexec/distribute libexec/command など新しいコマンドは
+ＭＬ名を引数にとるということにしてある。
+</para>
+
+</sect1>
+
+
+</chapter>