guideline of fj.archives (ver. 3.00a)
TOKUDA Masaaki
Version: 3.00a
Last-modified: 24 Jan 1998
この文書はfj.archives News groupを作る時に行われた議論の結果として徳田
(tok...@jaist.ac.jp)が作成し、その後の状況の変化により改訂され続けてい
ます。この文書は改変しないかぎり、複製、出版物への添付、転載が自由にで
きます。但し、徳田(tok...@jaist.ac.jp)にE-Mailで連絡をしておけば、今後
改変があった場合に知らせてもらえるかもしれません。
############### fj.archives.* ガイドライン (Ver. 3.00a) ###############
!!!!!!!!!!!!!!!!! 重要なお知らせ !!!!!!!!!!!!!!!!!
fj.archives News Groupはテスト投稿するNews Groupでは
ありません!
NetNewsへのテスト投稿、ニュースリーダ・サーバのテストは、fj.1st-readme
に投稿されている記事を参考にして、適切な場所で行って下さい。
fj.archives の秩序は、皆さん一人一人の努力の上に成り立っています。ど
うぞ御協力をお願い致します。
======================================================================
目次
0. はじめに
1. fj.archives NGについて
2. ヘッダについて
3. サブ・ヘッダについて
4. 例
5. 投稿について
======================================================================
0. はじめに
この記事は、fj.archives層のNews Group(以下「NG」と省略)における投稿
方法などを示すガイドラインです。fj.archives層には次のNGが存在します。
fj.archives.answers
fj.archives.documents
fj.archives.misc
fj.archives.d
fj.archives.programs.mac
fj.archives.programs.msdos
fj.archives.programs.ms-windows
fj.archives.programs.misc
fj.archives.programs.discussion
(この記事では、これらのNGのうち
fj.archives.d
fj.archives.programs.discussion
の2つのNGを「fj.archives議論用NG」と呼びます。また、逆にこの2つを除い
た他の7つのNGをまとめて「fj.archives NG」と呼びます。さらに
fj.archives.programs.mac
fj.archives.programs.msdos
fj.archives.programs.ms-windows
fj.archives.programs.misc
の4つのNGを「fj.archives.programs NG」と呼びます。)
この記事では、fj.archives NGの解説と記事を投稿する際に守るべき事柄を
説明します。fj.archives NGに記事を投稿される時には、このガイドラインを
よく読んで必要なヘッダを付加されるようお願いします。
このガイドラインは修正されることがあります。重大な変更があった場合は、
十分な告知をするはずですが、念のためfj.archives.answersや
fj.news.group.archivesより最新のガイドラインを参照するようにして下さい。
この記事は2.01cよりfj.archives.programs NGの新設にともない大幅な変更
をしました。誤植などの指摘を歓迎します。(ちなみに2.01bでは長い間誰にも
指摘されていなかった誤植があったという事例があります。)
======================================================================
1. fj.archives NGについて
fj.archives NGは、記事を保存、収集するためのNews Group(NG)です。プロ
グラムやまとめ(サマリー)、解説記事などを投稿するNGです。それぞれのNGと
憲章と概要は次の通りです。
・fj.archives.documents
文書を保存する。
Repository for documents.
このNGには、文章が主体の記事を投稿します。NetNewsやコンピュータ
に関わることでなくても、保存しておきたかったり、広く使いこまれる
文章ならここに投稿して構いません。
・fj.archives.answers
FAQを保存する。
Repository for FAQ (Frequently Asked Questions).
このNGには、文章でも特にFAQ(Frequently Asked Questions)を投稿し
ます。
・fj.archives.programs.mac
Macintosh専用のプログラム。
Repository for the programs for Macintosh.
Macintosh対応のプログラムを投稿します。
・fj.archives.programs.msdos
MS-DOS専用のプログラム。
Repository for the programs for MS-DOS.
MS-DOS対応のプログラムを投稿します。MS-Windowsにも対応しているプ
ログラムは次のNGに投稿した方が良いでしょう。
・fj.archives.programs.ms-windows
Microsoft Windows専用のプログラム。
Repository for the programs for Microsoft Windows.
MS-Windowsシリーズ(95/NTなど)に対応したプログラムを投稿します。
・fj.archives.programs.misc
他のfj.archives.programs.*に含まれない特定のプラットフォーム専用のプ
ログラム。
Repository for the programs for other platforms.
MacでもMS-DOSでもMS-Windowsでもない、他の特定の計算機やOS、言語
に依存するプログラムを投稿します。
・fj.archives.programs.discussion
fj.archives.programs.*に投稿されたプログラムに関する議論、情報。ただ
し、バグフィックス(特に作者の手によるオフィシャルパッチ)はそれぞれの
fj.archives.programs.*に。
Topics on the programs posted to fj.archives.programs.*.
fj.archivems.programs NGに投稿された記事に、何か意見があれば、こ
のNGに投稿します。決して、元のNGに投稿してはいけません。
fj.archives NGの全般的な話題については、fj.archives.dがあります。
・fj.archives.misc
他に分類されないデータなどを投稿する。
Repository for miscellaneous data.
このNGには様々なデータ(文書の雛形、画像、音声など)が投稿されます。
・fj.archives.d
fj.archives.*に投稿された記事や関連した話題。
For any topics related to fj.archives.
fj.archivems NGに投稿された記事に、何か意見があれば、このNGに投
稿します。決して、元のNGに投稿してはいけません。
fj.archives議論用NG(fj.archives.dとfj.archives.programs.discussion)
だけは上述のNGと違い、意見や議論の記事が投稿されます。fj.archives議論
用NGに限ってはFollowup-To、Archive-nameヘッダをつける必要はありません。
--------------- FAQ (Frequently Asked Questions) とは? ---------------
FAQというのは「よくある質問と、その回答集」で、たいていのNews Group
では、「○○というプリンターはWSの××にはどうやって繋ぐのでしょうか?」
とか「□□がコンパイルできません。何が悪いのでしょう?」といった、よく
ある質問というものがあります。このような質問を集めて回答集を作り、みん
なの目にふれるところに置くことによって、そのような質問が解決できると便
利ですね。この回答集がFAQで、置き場所がfj.archives.answersというわけで
す。
----------------------------------------------------------------------
------------------------- クロスポスト とは? -------------------------
クロスポストとは、複数のNGに同一記事を投稿する方法です。やり方は
Newsgroupヘッダに投稿したいNGを「,」で区切って記述します。このとき「,」
の前後に空白を入れてはいけません。こうすることで、1回の投稿で、複数の
NGに同じ記事を投稿する事ができます。1つの記事を複数のNGにいちいち投稿
するのはマルチポストと呼ばれておりクロスポストとは全く違います。マルチ
ポストは時間と計算機資源(ハードディスクなど)を浪費します。複数のNGに同
じ記事を投稿する時にはクロスポストにしましょう。
----------------------------------------------------------------------
fj.archives NGにはプログラム、文書、FAQ、データなどの記事だけが投稿
されるようにしなければなりません。もし、それらに対する意見などを投稿す
ると、本当に欲しい文書やデータがそれらの記事に埋もれて、見つけにくくな
ります。ですから、ここでは投稿された記事の議論をしないで下さい。そのた
めにも次から解説するヘッダをつけるようにお願いします。
======================================================================
2. ヘッダについて
fj.archives NGに投稿する記事につけるヘッダについて解説します。
fj.archives NGで使われるヘッダには重要性から次の3種類に分けられていま
す。(注意: ここでの重要性はfjの他のNGとは基準が異なる事があります。)
・(必須) : 必ずつけて欲しいヘッダです。形式も間違えないで下さい。
・(推奨) : なるべくならつけてほしいヘッダです。つけなくても構いません。
・(任意) : あると便利なヘッダです。つけなくても構いません。
なお、ヘッダとは別に、サブヘッダというものがあります。ヘッダを記述した
あと、空行を入れてからサブヘッダを記述することになります。
----------------------------------------------------------------------
2.1. Newsgroups (必須)
ここには投稿するNG(News group)を記述します。fj.archives NGはもちろ
んですが、関連するNG (あなたが投稿しようとしているFAQがDSPについての
ものならfj.comp.dspといったように)にもクロスポストしましょう。
クロスポストは、各NGを「,」で区切って記述します。このとき「,」の前
後に空白を入れてはいけません。
例
(a) Newsgroups: fj.archives.answers,fj.lang.c
(b) Newsgroups: fj.rec.food,fj.archives.answers,fj.archives.documents
(c) Newsgroups: fj.archives.programs.misc,fj.os.linux
(d) Newsgroups: fj.archives.programs.mac,fj.sys.mac
(e) Newsgroups: fj.archives.programs.ms-windows,fj.os.ms-windows
----------------------------------------------------------------------
2.2. Subject (必須)
ここには記事の概要を記述します。形式は特に定まっていませんが、わか
りやすく書くのがよいでしょう。
特にfj.archives.answersに投稿する記事は、FAQが多いわけですから
「FAQ」だけでは、他の記事との判別がつかないでしょう。具体的な内容か、
関連するNGを記述するようにします。
大作の記事はいくつかに分割して投稿することになるでしょう。その場合、
その記事が何番目かがわかりやすいように番号づけをするとよいでしょう。
例
(a) Subject: fj.comp.dsp Frequently Asked Questions (FAQ)
(b) Subject: (1/4) fj.rec.food FAQ [fish & meet]
(c) Subject: Internet no SUSUME
(b)の例では番号が先頭に書いてあります。こうすれば番号が画面からはみ
でる可能性が少ないでしょう。このようにいちばん知らせたい内容を先頭
に書くようにするのがよいでしょう。
----------------------------------------------------------------------
2.3. Followup-To (必須)
このヘッダを指定すると、記事にFollowupしたとき(記事に関連して投稿
すること)、そちらのNGへ記事が投稿されるようになります。fj.archives NG
では議論の記事を投稿しないようにするためにも、記事に関する意見は他の
NGで行うようにします。そのためにも、このFollowup-Toは必ずつけるよう
にして下さい。また、ここにはfj.archives NGは指定しないで下さい。もし、
適当なNGがない時はfj.archives.dかfj.archives.programs.discussionを指
定して下さい。
ここに「poster」と記述すると、Followupは、自動的に投稿者へのE-Mail
になります。これは記事に対する意見は確実に記事の作成者への報告にして
もらいたい時に使います。
このヘッダはふつうは自動的にはつきません。必ずつけるようにくれぐれ
も忘れないようにして下さい。
例
(a) Followup-To: fj.comp.dsp
(b) Followup-To: poster
(c) Followup-To: fj.archives.d
----------------------------------------------------------------------
2.4. Reply-To (推奨)
ここには、Reply Mailを送ってほしいアドレスを記述します。投稿者が記
事の作成者と違う場合などに使用します。
このヘッダはなるべくつけた方が良いでしょう。
例
Reply-To: f...@bar.hogehoge.ac.jp
----------------------------------------------------------------------
2.5. Expires (推奨)
FAQも時がたつにつれて内容が古くなるかもしれません。また次回の投稿
が予定されているときなどにExpiresを指定すると、その記事は自動的に削
除されます。逆にExpireの期間が短いサイトでは、このヘッダをつけること
により、記事が長く保存されます。形式はDateと同じです。
このヘッダはなるべくつけた方が良いでしょう。
例
Expires: 25 Jan 1994 21:00:00 JST
----------------------------------------------------------------------
2.6. Supersedes (推奨)
以前、投稿した文章やFAQを改訂して投稿する場合、Followupの形式で、
このヘッダをつけると、その以前投稿した記事と置き変わります。このヘッ
ダの後に、古い記事のMessage-IDを書きます。次に述べるReferenceは残し
ておいて下さい。
このヘッダをつける場合は、Expiresヘッダを設定しておかないと、通常
の保存期間で削除されますから、効果がほとんどなくなります。定期的に投
稿する間隔よりも、多少長めにExpiresヘッダを設定しておくと良いでしょ
う。そうすることで、途切れることなく最新版を読者は読むことができます。
例
Supersedes: <hogehog...@foo.bar.ac.jp>
----------------------------------------------------------------------
2.7. References (任意)
ニュースリーダーにもよりますが、関連する記事のMessage-IDを記述する
と簡単に参照できるようになります。
例
References: <foo.94Ja...@hogehoge.foo.bar.ac.jp>
_____________________________________________
以上のヘッダを記述したら空行を入れてください。
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
======================================================================
3. サブ・ヘッダについて
サブ・ヘッダはNews systemでの本来の意味でのヘッダではありません。記
事の本文の最初にNetNewsのヘッダと似た形式で記述し、さらに付加的な情報
を与えるものです。こうすることにより、利用者の利便性を向上させます。
これらのサブ・ヘッダはrkiveなどの自動保管のプログラムなどが使用した
りします。
----------------------------------------------------------------------
3.1. Archive-name (必須)
ここに記述されたキーワードは、rkiveなどの自動アーカイブユーティリ
ティが参照します。つまり、ここに記述されたキーワードをパス名として文
書やFAQ、データのファイル名として利用します。
もし、この名称で沢山の文書やFAQ、データがある時は、2つ目のパス名に
さらに詳しい分類の名称を記述します。最後のパス名にはファイルの順番を
記述します。
例
(a) Archive-name: Internet-Servers-Guide
(b) Archive-name: dsp-faq/part1
(c) Archive-name: rec-food/drink/part2
----------------------------------------------------------------------
3.2. Version と Last-modified (任意)
このヘッダがあると、以前投稿した記事よりどれぐらい変更されたかの目
安が容易に得られます。形式は、特に定まっていません。
このヘッダは必要に応じて付加すれば良いでしょう。
例
Version: 1.1
Last-modified: 18 Sep 1994
他にもヘッダがありますが、必須ではありませんので解説を省略させて頂きま
す。なお、News systemは勝手につけたヘッダは無視するようにできています。
くれぐれも綴を間違えてヘッダを無効にしないように気をつけて下さい。
======================================================================
4. 例
以上、解説したのヘッダの記述例です。 <-- は注意事項です。
-------------- ここから -------------------------------------------
Newsgroups: fj.archives.answers,fj.comp.dsp <-- 関連NGへのクロスポスト
Subject: fj.comp.dsp FAQ [1/4]
Followup-To: fj.comp.dsp <-- fj.archives.*を入れない
Reply-To: f...@bar.hogehoge.ac.jp
Supersedes: <foo94Ja...@hogehoge.ac.jp>
References: <foo93Se...@hogehoge.ac.jp>
<-- 空行を入れる
Archive-name: dsp-faq-j/part1 <-- 必須
Last-modified: Sat Sep 18 1993
Version: 1.3
-------------- ここまで -------------------------------------------
======================================================================
5. 投稿について
(1). 投稿形式
fj.archives.answersはすぐに既存ニュースリーダで読める形式、つまり
plain textで投稿して下さい。fj.archives.documentsは、plain textでな
くても構いませんが、初心者の方が読むことを考えて、元に戻す方法を解
説した文章をつけた方が良いでしょう。
(2). 投稿回数
作成したFAQを投稿してから、どれぐらいたったら再投稿するかが問題で
す。毎日、毎週は多すぎるでしょう。しかし、1年に1回では少なすぎるも
のもあると思います。記事の内容にもよりますが、3、4カ月に1回ぐらい、
もしくは変更した時点で再投稿すればよいでしょう。
(3). 投稿方法
fj.archives NGは、UnmoderatedなNGですから、ごく普通に投稿できます。
やり直しは、ほぼ効かないと思って、くれぐれもヘッダを忘れずに。
(4). 配布制限
もし、投稿する記事になにかしらの制限があったら、よくわかるように
明記する必要があるでしょう。例えば、BBSへの転載、雑誌への掲載は不可
の場合は、よく目立つ場所(記事の冒頭が適当でしょう)に明記して下さい。
また著作権表示も同様です。
============ fj.archives ガイドライン ここまで =======================
--
徳田昌晃.D4.奥村研.自然言語処理.情報.北陸先端大