clean up hierarchical structure

define and include logical structure such as &preface, &bookinfo, ...
add $FML$ tag if needed

10 files changed, 198 insertions, 70 deletions

diff --git a/fml/doc/ja/tutorial/bookinfo.sgml b/fml/doc/ja/tutorial/bookinfo.sgml
new file mode 100644
index 00000000..cfa477f2
--- /dev/null
+++ b/fml/doc/ja/tutorial/bookinfo.sgml
@@ -0,0 +1,41 @@
+<!--
+	$FML$
+-->
+
+  <bookinfo>
+  <bookbiblio>
+    <title>
+	fml-devel (fml 5.0) チュートリアル
+    </title>
+
+    <author>
+	<honorific> Dr        </honorific>
+	<firstname> Ken'ichi  </firstname>
+	<surname>   Fukamachi </surname>
+	<affiliation>
+		<orgname>FML.ORG</orgname>
+	    <address>
+		<email>
+		<ulink url="mailto:fukachan@fml.org">
+		fukachan@fml.org
+		</ulink> 
+		</email>
+	    </address>
+	</affiliation>
+    </author>
+
+    <copyright>
+	<year> 2001 </year>
+	<holder> Ken'ichi Fukamachi </holder>
+    </copyright>
+
+  </bookbiblio>
+
+    <legalnotice>
+      <para>
+	All rights reserved. This program is free software; you can
+	redistribute it and/or modify it under the same terms as Perl itself. 
+      </para>
+    </legalnotice>
+
+  </bookinfo>
diff --git a/fml/doc/ja/tutorial/bootloader.sgml b/fml/doc/ja/tutorial/bootloader.sgml
index c90e5f8d..69a6632f 100644
--- a/fml/doc/ja/tutorial/bootloader.sgml
+++ b/fml/doc/ja/tutorial/bootloader.sgml
@@ -1,7 +1,9 @@
 <!--
-	$FML$
+	$FML: bootloader.sgml,v 1.1 2001/04/23 14:14:01 fukachan Exp $
 -->
 
+<chapter id="bootloader">    	
+
 <title> バージョン依存性を解決するための fml ブートローダ </title>
 
 <para>
@@ -147,3 +149,5 @@ $process->finish($args);
    </listitem>
 </itemizedlist>
 </sect1>
+
+</chapter>
diff --git a/fml/doc/ja/tutorial/docbook.sgml b/fml/doc/ja/tutorial/docbook.sgml
index 72a78576..9cafff31 100644
--- a/fml/doc/ja/tutorial/docbook.sgml
+++ b/fml/doc/ja/tutorial/docbook.sgml
@@ -1,3 +1,10 @@
+<!--
+	$FML$
+-->
+
+<appendix id="docbook">
+
+
 <title> SGML の書き方 </title>
 
 <para>
@@ -25,3 +32,6 @@ SGML の書き方については
 
 のオンライン版を見ると良いでしょう。
 </para>
+
+
+</appendix>
diff --git a/fml/doc/ja/tutorial/fml-devel.sgml b/fml/doc/ja/tutorial/fml-devel.sgml
index 6d27f4f7..06774a6b 100644
--- a/fml/doc/ja/tutorial/fml-devel.sgml
+++ b/fml/doc/ja/tutorial/fml-devel.sgml
@@ -1,67 +1,64 @@
-<!doctype book public "-//OASIS//DTD DocBook V3.1//EN" [
-<!entity % include SYSTEM "include.sgml"> %include;
-]>
-
 <!--
 This is an sgml using DocBook dtd. Use sgmltools version 2.0.x or above
 to generate various output formats.
 
-$FML: fml-devel.sgml,v 1.4 2001/04/23 14:33:55 fukachan Exp $
+$FML: fml-devel.sgml,v 1.5 2001/04/23 17:27:21 fukachan Exp $
 -->
 
+<!doctype book public "-//OASIS//DTD DocBook V3.1//EN" [
+	<!entity % include SYSTEM "include.sgml"> %include;
+]>
+
 <book id="fml-devel">
-  <bookinfo>
-  <bookbiblio>
-    <title>
-	fml-devel (fml 5.0) チュートリアル
-    </title>
-
-    <author>
-	<honorific> Dr        </honorific>
-	<firstname> Ken'ichi  </firstname>
-	<surname>   Fukamachi </surname>
-	<affiliation>
-		<orgname>FML.ORG</orgname>
-	    <address>
-		<email>
-		<ulink url="mailto:fukachan@fml.org">
-		fukachan@fml.org
-		</ulink> 
-		</email>
-	    </address>
-	</affiliation>
-    </author>
-
-    <copyright>
-	<year> 2001 </year>
-	<holder> Ken'ichi Fukamachi </holder>
-    </copyright>
-
-  </bookbiblio>
-
-    <legalnotice>
-      <para>
-	All rights reserved. This program is free software; you can
-	redistribute it and/or modify it under the same terms as Perl itself. 
-      </para>
-    </legalnotice>
-
-  </bookinfo>
-
-  <TOC></TOC>
-
-  <chapter id="intro">
-    &intro;
-  </chapter>
-
-  <chapter id="bootloader">
-    &bootloader;
-  </chapter>
-
-
-  <!-- 〜ここから後は付録〜 -->
-  <appendix id="programingstyle"> &programingstyle; </appendix>
-  <appendix id="terms">   &terms;   </appendix>
-  <appendix id="docbook"> &docbook; </appendix>
+
+  &bookinfo;
+
+  &preface; 
+
+  <toc></toc>
+
+  <part>
+	<title> 基本的な設定ガイド </title>
+	<partintro>
+	<para>
+	本パートは初心者向けの設定ガイドを目指しています。
+	内容は基本的なデザイン思想や設定の仕方についてです。
+	</para>
+	<para>
+	なお、メーリングリストの仕組みなどの、
+	より基本的な内容については
+	&fmlbible; 
+	や
+	&www.fml.org;
+	などを参照して下さい。
+	</para>
+	</partintro>
+
+	<!-- 以下、各章が並ぶ -->
+	&intro;
+  </part>
+
+  <part>
+	<title> 技術的な議論 </title>
+	<partintro>
+	<para>
+	本パートでは…
+	</para>
+	</partintro>
+
+	<!-- 以下、各章が並ぶ -->
+	&bootloader;
+  </part>
+
+
+  <!-- 
+	***** ここから後は付録 *****
+  -->
+	&programingstyle; 
+	&docbook;
 
 </book>
+
+
+
+
diff --git a/fml/doc/ja/tutorial/include.sgml b/fml/doc/ja/tutorial/include.sgml
index 1647cc95..2c86c377 100644
--- a/fml/doc/ja/tutorial/include.sgml
+++ b/fml/doc/ja/tutorial/include.sgml
@@ -1,6 +1,13 @@
+<!--
+	$FML$
+-->
+
 <!entity versin "1.1">
 
 <!-- include する SGML ファイル群 -->
+<!entity bookinfo  SYSTEM "bookinfo.sgml">
+<!entity preface  SYSTEM "preface.sgml">
+
 <!entity appendix  SYSTEM "appendix.sgml">
 <!entity docbook   SYSTEM "docbook.sgml">
 <!entity terms     SYSTEM "terms.sgml">
@@ -10,8 +17,9 @@
 <!entity programingstyle  SYSTEM "programing_style.sgml">
 <!entity reference SYSTEM "reference.sgml">
 
-
+<!-- ポインタ -->
+<!entity fmlbible    "『fml バイブル』(オライリージャパン刊)">
+<!entity www.fml.org "http://www.fml.org/fml/">
 
 <!-- 画像 -->
 <!entity architecture SYSTEM "architecture.gif" ndata gif>
-
diff --git a/fml/doc/ja/tutorial/include/bookinfo.sgml b/fml/doc/ja/tutorial/include/bookinfo.sgml
new file mode 100644
index 00000000..cfa477f2
--- /dev/null
+++ b/fml/doc/ja/tutorial/include/bookinfo.sgml
@@ -0,0 +1,41 @@
+<!--
+	$FML$
+-->
+
+  <bookinfo>
+  <bookbiblio>
+    <title>
+	fml-devel (fml 5.0) チュートリアル
+    </title>
+
+    <author>
+	<honorific> Dr        </honorific>
+	<firstname> Ken'ichi  </firstname>
+	<surname>   Fukamachi </surname>
+	<affiliation>
+		<orgname>FML.ORG</orgname>
+	    <address>
+		<email>
+		<ulink url="mailto:fukachan@fml.org">
+		fukachan@fml.org
+		</ulink> 
+		</email>
+	    </address>
+	</affiliation>
+    </author>
+
+    <copyright>
+	<year> 2001 </year>
+	<holder> Ken'ichi Fukamachi </holder>
+    </copyright>
+
+  </bookbiblio>
+
+    <legalnotice>
+      <para>
+	All rights reserved. This program is free software; you can
+	redistribute it and/or modify it under the same terms as Perl itself. 
+      </para>
+    </legalnotice>
+
+  </bookinfo>
diff --git a/fml/doc/ja/tutorial/intro.sgml b/fml/doc/ja/tutorial/intro.sgml
index a5650498..2e60f0d9 100644
--- a/fml/doc/ja/tutorial/intro.sgml
+++ b/fml/doc/ja/tutorial/intro.sgml
@@ -1,9 +1,9 @@
 <!-- 
-	すでに <chapter> 〜 </chapter> の中で include されていることに注意
-
-	$FML: intro.sgml,v 1.2 2001/04/23 11:37:24 fukachan Exp $
+	$FML: intro.sgml,v 1.3 2001/04/24 03:40:38 fukachan Exp $
 -->
 
+<chapter id="intro">
+
 <title>fml5 (仮名) プロジェクトの目的</title>
 
   
@@ -289,3 +289,6 @@ fml 5.0 のアルファ版のアルファ版のアルファ版
 
 
 </sect1>
+
+
+</chapter>
diff --git a/fml/doc/ja/tutorial/preface.sgml b/fml/doc/ja/tutorial/preface.sgml
new file mode 100644
index 00000000..348dbd3a
--- /dev/null
+++ b/fml/doc/ja/tutorial/preface.sgml
@@ -0,0 +1,14 @@
+<!--
+	$FML$
+-->
+
+<preface>
+
+<title> はじめに </title>
+
+
+
+	<!-- テクニカルタームの定義を与える -->
+	&terms;
+
+</preface>
diff --git a/fml/doc/ja/tutorial/programing_style.sgml b/fml/doc/ja/tutorial/programing_style.sgml
index 2a00206f..944ef95a 100644
--- a/fml/doc/ja/tutorial/programing_style.sgml
+++ b/fml/doc/ja/tutorial/programing_style.sgml
@@ -1,6 +1,10 @@
-<TITLE>
-プログラミング・スタイル
-</TITLE>
+<!--
+	$FML$
+-->
+
+<appendix id="programingstyle">
+
+<TITLE>プログラミング・スタイル</TITLE>
 
 <para>
 プログラミング・スタイル (原案のメモ(注: 単なる走り書き))
@@ -83,3 +87,6 @@
 	しかし、そのひとつ下の層、そしてさらにその下では、
 	再利用性とポリモーフィズムに傾いた方がよさそうにおもえる。
 </para>
+
+
+</appendix>
diff --git a/fml/doc/ja/tutorial/terms.sgml b/fml/doc/ja/tutorial/terms.sgml
index e178d731..46203dbb 100644
--- a/fml/doc/ja/tutorial/terms.sgml
+++ b/fml/doc/ja/tutorial/terms.sgml
@@ -1,8 +1,9 @@
 <!-- 
-	すでに <chapter> 〜 </chapter> の中で include されていることに注意
-
-	$FML: terms.sgml,v 1.2 2001/04/22 16:10:46 fukachan Exp $
+	$FML: terms.sgml,v 1.1.1.1 2001/04/22 16:17:17 fukachan Exp $
 -->
+
+<sect1 id="terms">
+
 <title> 本チュートリアル中における用語について </title>
 
 <variablelist>
@@ -29,3 +30,5 @@
    </varlistentry>
 
 </variablelist>
+
+</sect1>