From fdcca16caee1f2d98f4519fe9bdaf8e079ba2f4c Mon Sep 17 00:00:00 2001 From: fukachan Date: Sat, 6 Jul 2002 14:55:14 +0000 Subject: clean up/update --- fml/doc/ja/tutorial/devel/create_program.sgml | 40 ++++++++++++++++++--------- fml/doc/ja/tutorial/devel/cvstree.sgml | 38 +++++++++++++++++++------ fml/doc/ja/tutorial/devel/docbook.sgml | 20 +++++++------- 3 files changed, 67 insertions(+), 31 deletions(-) (limited to 'fml/doc/ja/tutorial/devel') diff --git a/fml/doc/ja/tutorial/devel/create_program.sgml b/fml/doc/ja/tutorial/devel/create_program.sgml index 2dc90832..38c6961c 100644 --- a/fml/doc/ja/tutorial/devel/create_program.sgml +++ b/fml/doc/ja/tutorial/devel/create_program.sgml @@ -1,5 +1,5 @@ @@ -34,7 +34,9 @@ verify_request() run() finish() -ダミーでもよいので、このメソッドを用意しておいて下さい。 +ダミーでもよいので、これらのメソッドを適宜用意しておいて下さい。 +各メソッドの具体例は、FML::Process を見て下さい。 +メソッドの役割を知るためには最大構成の Distribute が一番適当かも知れません。 @@ -55,16 +57,21 @@ FML::Process:: を用意したら、 FML::Process::Switch を編集します。 -このモジュールは、各プログラムごとに +このモジュールでは、各プログラムごとに 『ロードするモジュール』 『コマンドラインオプション』 『ＭＬ名を必要とするか否か？』 -などを定義してください。 -編集する場所は fmlsch などの文字列を頼りにサーチすると良いでしょう。 +を定義してください。 +編集する場所は以下の private method です。 + +sub _module_specific_options +sub _ml_name_is_required +sub _module_we_use + -この 2 つの準備だけで、準備は終りですです。 +この 2 つの準備だけで、新しいプログラムの準備は終りですです。 呼びたい名前のファイルを loader と link もしくは symlink することで 実行が可能になります。 例えば、標準のインストールでは、次のようになっています。 @@ -103,7 +110,7 @@ lrwxr-xr-x 1 root wheel 6 Nov 23 22:10 mead -> loader CGI のプログラムは FML::CGI::○○○ というモジュールです。 -CGI 系列では次のような、オブジェクトの関係にあります。 +CGI 系列では次のような、オブジェクトの関係があります。 FML::Process::Kernel | @@ -119,9 +126,10 @@ CGI -CGI のプログラムの書き方も同様です。 -コマンドラインのプログラムと同様に、 -FML::CGI のモジュールを見本にして、 +CGI のプログラムの書き方もコマンドラインプログラムと同様です。 +名前空間で区別するために CGI スクリプトのモジュールは +FML::Process ではなく FML::CGI に配置されています。 +既存の FML::CGI のモジュールを見本にして、 FML::CGI::○○○ を適宜用意して下さい。 @@ -129,7 +137,7 @@ FML::CGI:: FML::CGI::○○○ の注意点は、 -用意するメソッドは +用意するメソッドが html_start() html_end() @@ -147,6 +155,11 @@ run_cgi_options() これらの組で一つの画面が構成されています。 + +これらは FML::Process::CGI の中の +verify_request() および run() から呼ばれた先のメソッドとなっています。 + + CGI プロセスは FML::Process::CGI で駆動され、run() メソッドは @@ -154,7 +167,7 @@ $curproc->html_start($args); 画面を作るために run_cgi_xxx() メソッド郡を呼び出す。 $curproc->html_end($args); -のように FML::CGI:: 以下のメソッド群を呼び出しているからです。 +の順に FML::CGI:: 以下のメソッド群を呼び出しています。 @@ -164,7 +177,8 @@ $curproc->html_end($args); このため、多くの場合 FML::Process::Kernel - のメソッドは呼ばれてはいません。 + のメソッドは CGI::Kernel でオーバロードされており、 + 直接呼ばれることは稀です。 からなっています。 diff --git a/fml/doc/ja/tutorial/devel/cvstree.sgml b/fml/doc/ja/tutorial/devel/cvstree.sgml index 220fb338..cf394bf5 100644 --- a/fml/doc/ja/tutorial/devel/cvstree.sgml +++ b/fml/doc/ja/tutorial/devel/cvstree.sgml @@ -1,5 +1,5 @@ @@ -15,17 +15,16 @@ -fml-devel の基本方針として、 +&fmldevel; の基本方針として、 使えるもの(例えば CPAN )は片っ端から使います。 -そうしないと保守する項目が増える一方のためです。 +そうしないと自分で保守しないといけない項目が増える一方のためです。 -また、保守する人をはっきり区別するためにベンダーごとにディレクトリを分 -けています。例えば CPAN で保守されているものは CPAN/ ディレクトリ以下 -に入れてください。 -ライセンスなどによっては、 -将来さらに区分を分ける必要が出てくるかも知れません。 +また、保守する人とライセンスをはっきり区別するためにベンダーごとにディ +レクトリを分けています。例えば CPAN で保守されているものは CPAN/ ディ +レクトリ以下に入れてください。ライセンスなどによっては、将来さらに区分 +を分ける必要が出てくるかも知れません。 @@ -157,6 +156,16 @@ CPAN/dist/ + + fml/bin/ + /usr/local/bin/ にインストールするプログラム + + + + fml/doc/ + Documentation/ のソース + + fml/etc/ 設定変数 @@ -177,6 +186,19 @@ CPAN/dist/ 呼び出すので、正確には wrapper です。 + + + fml/share/ + メッセージのテンプレートなど + + + + fml/utils/ + ユーティリティですが、 + これは + fml ソース内で使うだけです。 + + diff --git a/fml/doc/ja/tutorial/devel/docbook.sgml b/fml/doc/ja/tutorial/devel/docbook.sgml index 2c94e345..c2f6c347 100644 --- a/fml/doc/ja/tutorial/devel/docbook.sgml +++ b/fml/doc/ja/tutorial/devel/docbook.sgml @@ -1,5 +1,5 @@ @@ -19,7 +19,7 @@ fml-devel (&fmldevel;) -ここでは、SGML を書くために最小限必要な知識についてメモします。 +本章では、SGML を書くために最小限必要な知識についてメモします。 @@ -31,7 +31,7 @@ fml-devel (&fmldevel;) ですが、正しい HTML の書き方と同様です。 -本 Appendix で、２、３の典型的な SGML テンプレートをメモしておくので、 +本 Appendix で、2、3 の典型的な SGML テンプレートをメモしておくので、 それらを適当に切り剥ぎしていけばなんとかなるはずです。 @@ -48,7 +48,7 @@ SGML HTML のもっと厳密なものだと思って下さい - 正確には HTML が SGML の一部です。 + 正確には HTML が SGML の一部にフォーマッタの要素が合体してしまったものです。 HTML の方がはるかに有名になってしまったので、 「HTML のもっと厳密なもの…」といった説明が良くされます :) @@ -385,14 +385,14 @@ include SGML を HTML などに翻訳するために、いくつかのツールが必要です。 -DTD と DSL の規格文書群は必須です。 -処理系として openjade と opensp +また DTD と DSL の規格文書群も必須です。 +処理系としては openjade と opensp opensp は openjade パッケージに含まれています。 -も必須のプログラムです。 +が必須のプログラムでしょう。 その他はオプショナルで、各自が好きにすればよいようです。 @@ -420,8 +420,8 @@ DTD - -多くの OS では附属のパッケージシステムで一発ポン！てなもんでしょう。 +多くの OS ではこれらのプログラムを附属のパッケージシステムで簡単に +インストールできるでしょう。 @@ -499,7 +499,7 @@ HTML 見栄えは DSL により記述をすることになります。 -しかしながら、DSL は本質的に LISP (List Processre) 言語なので、 +しかしながら、DSL は本質的に LISP (List Processor) 言語なので、 LISP を知らないとちょっと手が出ないでしょう。 -- cgit v1.2.1