summaryrefslogtreecommitdiff
path: root/fml/doc/ja/tutorial/customize
diff options
context:
space:
mode:
Diffstat (limited to 'fml/doc/ja/tutorial/customize')
-rw-r--r--fml/doc/ja/tutorial/customize/autoreply.sgml23
-rw-r--r--fml/doc/ja/tutorial/customize/case_studies.sgml40
-rw-r--r--fml/doc/ja/tutorial/customize/chapter.command.sgml15
-rw-r--r--fml/doc/ja/tutorial/customize/chapter.config.sgml4
-rw-r--r--fml/doc/ja/tutorial/customize/chapter.header.sgml5
-rw-r--r--fml/doc/ja/tutorial/customize/command_permit_anyone.sgml6
-rw-r--r--fml/doc/ja/tutorial/customize/command_rejectall.sgml8
-rw-r--r--fml/doc/ja/tutorial/customize/mailmagazine.sgml12
-rw-r--r--fml/doc/ja/tutorial/customize/ml.hier.ml12
-rw-r--r--fml/doc/ja/tutorial/customize/post_permit_anyone.sgml19
-rw-r--r--fml/doc/ja/tutorial/customize/recipe.filter.notice.sgml11
-rw-r--r--fml/doc/ja/tutorial/customize/recipe.header.tag.lowercase.sgml4
-rw-r--r--fml/doc/ja/tutorial/customize/recipe.header.tag.uppercase.sgml4
13 files changed, 105 insertions, 58 deletions
diff --git a/fml/doc/ja/tutorial/customize/autoreply.sgml b/fml/doc/ja/tutorial/customize/autoreply.sgml
index 5cce28ca..5e81e111 100644
--- a/fml/doc/ja/tutorial/customize/autoreply.sgml
+++ b/fml/doc/ja/tutorial/customize/autoreply.sgml
@@ -1,5 +1,5 @@
<!--
- $FML: autoreply.sgml,v 1.1 2002/07/29 09:32:57 fukachan Exp $
+ $FML: autoreply.sgml,v 1.2 2003/01/05 08:00:59 fukachan Exp $
-->
<sect1 id="config.autoreply">
@@ -9,28 +9,37 @@
<para>
配送プロセス( libexec/distribute )を改造して
-/etc/fml/help ファイルを送り返すことを考えます。
+/some/where/help ファイルを送り返すことを考えます。
例えば help@fml.org MLを作り、このアドレスにメールを送ると
-ヘルプファイルを送り返すというものです。
+(うむをいわさず:-)ヘルプファイルを送り返すというものです。
+</para>
+
+<para>
この場合の config.cf の例はこのようになります。
<screen>
-post_restrictions = permit_anyone
+article_post_restrictions = permit_anyone
</screen>
-=cut の後に hook を書きます。
+config.cf ファイルの =cut 行以降に hook を書きます。
<screen>
$distribute_run_start_hook = q{
$curproc->reply_message( {
type => "text/plain; charset=iso-2022-jp",
- path => "/etc/fml/help",
+ path => "/some/where/help",
filename => "help",
disposition => "help example",
});
- $curproc->refuse_further_processing();
+ $curproc->stop_this_process();
};
</screen>
+最後の
+<screen>
+$curproc->stop_this_process();
+</screen>
+が &fml4; の $DO_NOTHING 変数にあたりますが、&fml8; ではメソッドです。
+これで、このHOOK以降、正常の処理が無視されるようになります。
</para>
</sect1>
diff --git a/fml/doc/ja/tutorial/customize/case_studies.sgml b/fml/doc/ja/tutorial/customize/case_studies.sgml
index 68a7194f..16fdac37 100644
--- a/fml/doc/ja/tutorial/customize/case_studies.sgml
+++ b/fml/doc/ja/tutorial/customize/case_studies.sgml
@@ -1,5 +1,5 @@
<!--
- $FML: case_studies.sgml,v 1.4 2003/04/15 14:51:36 fukachan Exp $
+ $FML: case_studies.sgml,v 1.5 2003/11/29 07:29:12 fukachan Exp $
-->
@@ -9,7 +9,12 @@
</title>
<para>
-ヘッダ関連では、まず Subject: にタグをつけない
+以下の設定を /usr/local/etc/fml/site_default_config.cf に書き、全ML
+に反映させてください。
+</para>
+
+<para>
+ヘッダ関連では、まず Subject: にタグをつけないことにしました。
<footnote>
<para>
なお、この設定はデフォルトの site_default_config.cf に仕込まれているた
@@ -24,20 +29,20 @@ article_header_rewrite_rules -= rewrite_article_subject_tag
<para>
そして、X-ML-Name: 部分の mlname にオフィス名をつける(prepend する)、
-つまり mlname から office#mlname へ変更する。
+つまり mlname から office#mlname へ変更します。
<screen>
# office#$mlname
-outgoing_mail_header_x_ml_name = office#$ml_name
+outgoing_mail_header_x_ml_name = office#$ml_name
</screen>
</para>
<para>
-記事は誰でも投稿可能としよう。
+記事は誰でも投稿可能としましょう。
<screen>
-post_restrictions = permit_anyone
+article_post_restrictions = permit_anyone
</screen>
-そして、社内用途のMLなので、フィルタの多くは使わない。
-つぅか、使うと問題出まくりのようです;)
+そして、社内用途のMLなので、フィルタの多くは使いません。
+つぅか、使うと問題だらけのようです;)
<screen>
use_body_filter = no
use_article_body_filter = no
@@ -48,9 +53,9 @@ use_article_text_plain_filter = no
</para>
<para>
-気時のスプールだが、長期的な展望を踏まえるなら、仕事のメールは数が多い
-ので、数万通単位で記事を保存すると思います。よって、記事のスプールは
-subdir 形式とします。
+記事のスプールですが、長期的な展望を踏まえるなら、仕事のメールは数が多
+いので、数万通単位で記事を保存すると思います。よって、記事のスプールは
+subdir 形式としました。
<screen>
spool_type = subdir
</screen>
@@ -59,16 +64,13 @@ spool_type = subdir
<para>
なお、コマンドメールは使いません。
<screen>
-use_command_mail_program = no
+use_command_mail_function = no
</screen>
コマンドメールそのものを禁止するには、aliases から該当するエントリを省
くことが確実ですが、MLを作成するたびに、aliases から削除することはミ
ス操作を誘い易いでしょう。また、CGI 操作の場合、CGI 操作者が aliases
の操作をするのはおかしいです。そこで、コマンドメール用のプログラムが一
-度は起動しても、すぐ終るという設定にしています。
-<screen>
-use_command_mail_program = no
-</screen>
+度は起動しても、すぐ終るという設定にしているわけです。
</para>
</sect1>
@@ -80,8 +82,8 @@ use_command_mail_program = no
</title>
<para>
-以下の設定を /etc/fml/site_default_config.cf に書き、全MLに反映させ
-てください。
+以下の設定を /usr/local/etc/fml/site_default_config.cf に書き、全ML
+に反映させてください。
</para>
<para>
@@ -101,7 +103,7 @@ Subject: (SUPPORT 10000)
そして、過去記事を参照させるために、コマンドメールの使用を許します。
ただし、自ドメイン(例: example.co.jp )からのリクエストに対してのみ、
コマンドメールの使用を許すこととします。
-これは、HOOK で実現可能です。
+これは、HOOK で実現します。
<screen>
$command_verify_request_end_hook = q{
my $cred = $curproc->{ credential };
diff --git a/fml/doc/ja/tutorial/customize/chapter.command.sgml b/fml/doc/ja/tutorial/customize/chapter.command.sgml
index 2087c28d..071dbe56 100644
--- a/fml/doc/ja/tutorial/customize/chapter.command.sgml
+++ b/fml/doc/ja/tutorial/customize/chapter.command.sgml
@@ -1,5 +1,5 @@
<!--
- $FML: chapter.header.sgml,v 1.1 2002/07/28 06:26:56 fukachan Exp $
+ $FML: chapter.command.sgml,v 1.1 2002/09/15 01:46:30 fukachan Exp $
-->
<chapter id="customize.command">
@@ -14,14 +14,19 @@
</title>
<para>
-elena MLの help コマンドを独自のものにしたいとしましょう。
-その場合、オリジナルの help.pm を参考に独自の
-help.pm を作り、以下のパスにおいてください。
+elena MLに独自の help コマンドを作ることを考えます。
+</para>
+
+<para>
+独自のモジュール help.pm を用意して、MLローカルのライブラリパスへお
+くだけです。オリジナルの help.pm を参考にして、独自の help.pm を作り、
+以下のパスにおいてください。
<screen>
/var/spool/ml/elena/local/lib/FML/Command/User/help.pm
</screen>
+モジュールをロードするさい、
この local/ パスのモジュールが優先されるので、
-help コマンドの応答にはこのモジュール help.pm が使われます。
+help コマンドの応答には、このモジュール help.pm が使われます。
</para>
<caution>
diff --git a/fml/doc/ja/tutorial/customize/chapter.config.sgml b/fml/doc/ja/tutorial/customize/chapter.config.sgml
index fd670dc9..7a671d7d 100644
--- a/fml/doc/ja/tutorial/customize/chapter.config.sgml
+++ b/fml/doc/ja/tutorial/customize/chapter.config.sgml
@@ -1,5 +1,5 @@
<!--
- $FML: chapter.config.sgml,v 1.2 2002/07/29 12:14:17 fukachan Exp $
+ $FML: chapter.config.sgml,v 1.3 2003/04/15 14:51:36 fukachan Exp $
-->
<chapter id="config">
@@ -19,7 +19,7 @@
</para>
<para>
-このファイルは、&fml4; の site_init.ph に相当するものです。
+このファイルは、&fml4; の site_force.ph に相当するものです。
</para>
</sect1>
diff --git a/fml/doc/ja/tutorial/customize/chapter.header.sgml b/fml/doc/ja/tutorial/customize/chapter.header.sgml
index 3d26feb4..8f232d1e 100644
--- a/fml/doc/ja/tutorial/customize/chapter.header.sgml
+++ b/fml/doc/ja/tutorial/customize/chapter.header.sgml
@@ -1,5 +1,5 @@
<!--
- $FML: chapter.header.sgml,v 1.2 2002/10/29 03:32:21 fukachan Exp $
+ $FML: chapter.header.sgml,v 1.3 2003/04/15 14:51:36 fukachan Exp $
-->
<chapter id="customize.header">
@@ -10,11 +10,10 @@
<para>
ヘッダ情報は FML::Header クラスのオブジェクトに収納されています。
なお FML::Header は Mail::Header を継承しているので、
-Mail::Header で操作可能なことは何でもできます。
+Mail::Header のメソッドは何でも利用可能です。
</para>
-
<sect1 id="recipies.cutomize.header">
<title>
レシピ’s
diff --git a/fml/doc/ja/tutorial/customize/command_permit_anyone.sgml b/fml/doc/ja/tutorial/customize/command_permit_anyone.sgml
index 67710462..8e7e06eb 100644
--- a/fml/doc/ja/tutorial/customize/command_permit_anyone.sgml
+++ b/fml/doc/ja/tutorial/customize/command_permit_anyone.sgml
@@ -1,5 +1,5 @@
<!--
- $FML: command_permit_anyone.sgml,v 1.1 2002/07/29 09:32:57 fukachan Exp $
+ $FML: command_permit_anyone.sgml,v 1.2 2003/01/05 08:00:59 fukachan Exp $
-->
<sect1 id="config.command.permitanyone">
@@ -8,10 +8,10 @@
</title>
<para>
-command_restrictions はコマンドメールの利用を許すメンバーを定義してい
+command_mail_restrictions はコマンドメールの利用を許すメンバーを定義してい
ます。
<screen>
-command_restrictions = permit_anyone
+command_mail_restrictions = permit_anyone
</screen>
これで、MLのメンバーか否かを問わず誰でもコマンドメールが使えます。
</para>
diff --git a/fml/doc/ja/tutorial/customize/command_rejectall.sgml b/fml/doc/ja/tutorial/customize/command_rejectall.sgml
index a5aa6b2c..7ed54944 100644
--- a/fml/doc/ja/tutorial/customize/command_rejectall.sgml
+++ b/fml/doc/ja/tutorial/customize/command_rejectall.sgml
@@ -1,5 +1,5 @@
<!--
- $FML: command_rejectall.sgml,v 1.2 2003/01/05 08:00:59 fukachan Exp $
+ $FML: command_rejectall.sgml,v 1.3 2003/04/15 14:51:36 fukachan Exp $
-->
<sect1 id="config.command.rejectall">
@@ -11,14 +11,16 @@
コマンドプロセスが起動しても、即効で終了するようにすることができます。
これが(aliases を編集することをのぞけば)一番確実な方法です。
<screen>
-use_command_mail_program = no
+use_command_mail_function = no
</screen>
</para>
<para>
プロセスが動いてしまうのですが、別解として次のやり方もありでしょう。
<screen>
-command_restrictions = reject
+use_command_mail_function = yes
+
+command_mail_restrictions = reject
</screen>
こう設定すると(メンバー以外の人に送り返すはずの) guide すら返送されず、
何をしても「あなたはメンバーでない」という一点張りの答を返すだけです。
diff --git a/fml/doc/ja/tutorial/customize/mailmagazine.sgml b/fml/doc/ja/tutorial/customize/mailmagazine.sgml
index efa7f553..ee5225f3 100644
--- a/fml/doc/ja/tutorial/customize/mailmagazine.sgml
+++ b/fml/doc/ja/tutorial/customize/mailmagazine.sgml
@@ -1,5 +1,5 @@
<!--
- $FML$
+ $FML: mailmagazine.sgml,v 1.3 2003/07/27 17:45:30 fukachan Exp $
-->
<sect1 id="config.mailmagazine">
@@ -39,4 +39,14 @@ members というファイルに追加されていきますが、
気にはなるかも知れませんが…
</para>
+<para>
+別解としては、逆に
+<screen>
+primary_member_map = $tmp_dir/members-dummy
+</screen>
+などとメンバーリストの新規分追加先を変更して闇に葬り、
+membersには投稿可能なアドレスだけを書くというやり方もあります。
+このほうが &fml4; 風で分かりやすいでしょう。
+</para>
+
</sect1>
diff --git a/fml/doc/ja/tutorial/customize/ml.hier.ml b/fml/doc/ja/tutorial/customize/ml.hier.ml
index 50be05e9..ed07f722 100644
--- a/fml/doc/ja/tutorial/customize/ml.hier.ml
+++ b/fml/doc/ja/tutorial/customize/ml.hier.ml
@@ -1,5 +1,5 @@
<!--
- $FML$
+ $FML: ml.hier.ml,v 1.1 2002/07/29 12:16:19 fukachan Exp $
階層化されたML: $member_maps $recipient_maps をよろしく書く
@@ -49,4 +49,14 @@ post_restrictions = permit_anyone
と設定してしまうのもアリでしょう。
</para>
+<para>
+ここではファイルで管理する例を取り上げています。
+これは簡単で、すぐに実行できるというのがよいところです。
+</para>
+
+<para>
+しかしながら、MySQL なりで組織図とメール配送のリストを管理するほうが現
+代的ではあるでしょう。準備も保守も、それなりに必要となりますが
+</para>
+
</sect1>
diff --git a/fml/doc/ja/tutorial/customize/post_permit_anyone.sgml b/fml/doc/ja/tutorial/customize/post_permit_anyone.sgml
index 7413f8d0..9992e3e4 100644
--- a/fml/doc/ja/tutorial/customize/post_permit_anyone.sgml
+++ b/fml/doc/ja/tutorial/customize/post_permit_anyone.sgml
@@ -1,5 +1,5 @@
<!--
- $FML: post_permit_anyone.sgml,v 1.3 2003/04/15 14:51:37 fukachan Exp $
+ $FML: post_permit_anyone.sgml,v 1.4 2003/11/30 10:01:13 fukachan Exp $
-->
<sect1 id="config.post.permitanyone">
@@ -9,9 +9,9 @@
<para>
<screen>
-post_restrictions = permit_anyone
+article_post_restrictions = permit_anyone
</screen>
-post_restrictions は記事の投稿を許すメンバーを定義しています。
+article_post_restrictions は記事の投稿を許すメンバーを定義しています。
これを permit_anyone とすると、だれでも投稿可能になります。
</para>
@@ -22,10 +22,19 @@ reject_system_special_accounts という root などを弾くルールが別途あります。
</para>
<para>
-ちなみに post_restrictions のデフォルトは &fml4; 互換のため、
+&fml4; のように、rootなどシステムの特別なアカウントは弾き、それ以外の
+ユーザからのメールは受け付けるという場合、次のようにします。
+<screen>
+article_post_restrictions = reject_system_special_accounts
+ permit_anyone
+</screen>
+</para>
+
+<para>
+ちなみに article_post_restrictions のデフォルトは &fml4; 互換のため、
次のようになっています。
<screen>
-post_restrictions = reject_system_special_accounts
+article_post_restrictions = reject_system_special_accounts
permit_member_maps
reject
</screen>
diff --git a/fml/doc/ja/tutorial/customize/recipe.filter.notice.sgml b/fml/doc/ja/tutorial/customize/recipe.filter.notice.sgml
index 444df884..10ccee02 100644
--- a/fml/doc/ja/tutorial/customize/recipe.filter.notice.sgml
+++ b/fml/doc/ja/tutorial/customize/recipe.filter.notice.sgml
@@ -1,5 +1,5 @@
<!--
- $FML: recipe.filter.notice.sgml,v 1.1 2003/04/13 03:29:01 fukachan Exp $
+ $FML: recipe.filter.notice.sgml,v 1.2 2003/04/15 14:51:37 fukachan Exp $
-->
@@ -19,8 +19,8 @@
use_article_filter_reject_notice = yes
article_filter_reject_notice_recipient = maintainer sender
</screen>
-となっている。
-つまり、エラーメールを返し、返す先はMLの管理者だ。
+となっています。
+つまり、エラーメールを返し、返す先はMLの管理者です。
</para>
@@ -29,7 +29,7 @@ article_filter_reject_notice_recipient = maintainer sender
<screen>
article_filter_reject_notice_recipient = sender
</screen>
-とする。
+としてください。
</para>
@@ -38,7 +38,7 @@ article_filter_reject_notice_recipient = sender
<screen>
article_filter_reject_notice_recipient = maintainer sender
</screen>
-とする。
+としてください。
</para>
@@ -47,6 +47,7 @@ article_filter_reject_notice_recipient = maintainer sender
<screen>
use_article_filter_reject_notice = no
</screen>
+としてください。
</para>
</answer>
diff --git a/fml/doc/ja/tutorial/customize/recipe.header.tag.lowercase.sgml b/fml/doc/ja/tutorial/customize/recipe.header.tag.lowercase.sgml
index d0265f65..09270e62 100644
--- a/fml/doc/ja/tutorial/customize/recipe.header.tag.lowercase.sgml
+++ b/fml/doc/ja/tutorial/customize/recipe.header.tag.lowercase.sgml
@@ -1,5 +1,5 @@
<!--
- $FML$
+ $FML: recipe.header.tag.lowercase.sgml,v 1.1 2002/10/29 03:32:21 fukachan Exp $
-->
@@ -19,7 +19,7 @@ Unix 上では、たいてい小文字を使うので、ML名前も小文字でしょう。
<screen>
article_subject_tag = [\L$ml_name\E:%05d]
</screen>
-(注意: 2002/10/29 以降の snapshot を使ってください)。
+(注意: この機能を使う場合には 2002/10/29 以降の snapshot を使ってください)。
</para>
</answer>
diff --git a/fml/doc/ja/tutorial/customize/recipe.header.tag.uppercase.sgml b/fml/doc/ja/tutorial/customize/recipe.header.tag.uppercase.sgml
index 97c2c47f..8117d43b 100644
--- a/fml/doc/ja/tutorial/customize/recipe.header.tag.uppercase.sgml
+++ b/fml/doc/ja/tutorial/customize/recipe.header.tag.uppercase.sgml
@@ -1,5 +1,5 @@
<!--
- $FML$
+ $FML: recipe.header.tag.uppercase.sgml,v 1.1 2002/10/29 03:32:21 fukachan Exp $
-->
@@ -16,7 +16,7 @@
<screen>
article_subject_tag = [\U$ml_name\E:%05d]
</screen>
-(注意: 2002/10/29 以降の snapshot を使ってください)。
+(注意: この機能を使う場合には 2002/10/29 以降の snapshot を使ってください)。
</para>
</answer>