From 00c5b075e239ae909e75ec9bf647a225511e2b57 Mon Sep 17 00:00:00 2001 From: Hiroyuki Hanai Date: Tue, 7 Jul 1998 03:14:12 +0000 Subject: [PATCH] New tranlations of files under docproj directory and modification of the related files. Submitted by: HIROSE Shouichi , Motoyuki Konno --- data/ja_JP.EUC/Makefile | 4 +- data/ja_JP.EUC/docproj.sgml | 10 +- data/ja_JP.EUC/docproj/Makefile | 12 ++ data/ja_JP.EUC/docproj/doc-set.sgml | 71 +++++++++++ data/ja_JP.EUC/docproj/submitting.sgml | 163 +++++++++++++++++++++++++ data/ja_JP.EUC/docproj/who.sgml | 38 ++++++ ja/Makefile | 4 +- ja/docproj/Makefile | 12 ++ ja/docproj/doc-set.sgml | 71 +++++++++++ ja/docproj/docproj.sgml | 10 +- ja/docproj/submitting.sgml | 163 +++++++++++++++++++++++++ ja/docproj/who.sgml | 38 ++++++ 12 files changed, 582 insertions(+), 14 deletions(-) create mode 100644 data/ja_JP.EUC/docproj/Makefile create mode 100644 data/ja_JP.EUC/docproj/doc-set.sgml create mode 100644 data/ja_JP.EUC/docproj/submitting.sgml create mode 100644 data/ja_JP.EUC/docproj/who.sgml create mode 100644 ja/docproj/Makefile create mode 100644 ja/docproj/doc-set.sgml create mode 100644 ja/docproj/submitting.sgml create mode 100644 ja/docproj/who.sgml diff --git a/data/ja_JP.EUC/Makefile b/data/ja_JP.EUC/Makefile index 3a7b18ea7d..0625f9f417 100644 --- a/data/ja_JP.EUC/Makefile +++ b/data/ja_JP.EUC/Makefile @@ -1,4 +1,4 @@ -# $Id: Makefile,v 1.12 1998-06-23 15:15:00 kuriyama Exp $ +# $Id: Makefile,v 1.13 1998-07-07 03:14:10 hanai Exp $ # The FreeBSD Japanese Documentation Project # Original revision: 1.24 @@ -34,7 +34,7 @@ atoz.sgml: web.atoz # Subdirectories #SUBDIR= cgi commercial gifs ports releases tutorials -SUBDIR= ports releases +SUBDIR= docproj ports releases # Subdirectories that have linuxdoc docs and makefiles that use # . diff --git a/data/ja_JP.EUC/docproj.sgml b/data/ja_JP.EUC/docproj.sgml index 8a3ea14349..d78402f953 100644 --- a/data/ja_JP.EUC/docproj.sgml +++ b/data/ja_JP.EUC/docproj.sgml @@ -1,9 +1,9 @@ + %includes; ]> - + @@ -58,14 +58,14 @@ -

+

我々は何者か, どうしたら参加できるのか

このページでは, どのような人々がドキュメンテーションプロジェクトを構成しているのか, どうやったらあなたも参加できるのか説明しています.

-

FreeBSD ドキュメンテーション集

+

FreeBSD ドキュメンテーション集

このページでは, FreeBSD ドキュメンテーション集の構成と, ドキュメンテーションプロジェクトが, @@ -79,7 +79,7 @@ SGML でドキュメンテーションをつくる方法を概説し, 興味を持った読み手に, SGML に関する更なるリソースを教えています.

-

+

ドキュメンテーションを寄託する

ドキュメンテーションを寄託するのは, diff --git a/data/ja_JP.EUC/docproj/Makefile b/data/ja_JP.EUC/docproj/Makefile new file mode 100644 index 0000000000..6259e68a1f --- /dev/null +++ b/data/ja_JP.EUC/docproj/Makefile @@ -0,0 +1,12 @@ +# $Id: Makefile,v 1.1 1998-07-07 03:14:11 hanai Exp $ +# The FreeBSD Japanese Documentation Project +# Original revision: 1.2 + +.if exists(Makefile.conf) +.include "Makefile.conf" +.endif + +DOCS= doc-set.sgml submitting.sgml who.sgml +#DOCS+= current.sgml sgml.sgml translation.sgml + +.include "../../web.mk" diff --git a/data/ja_JP.EUC/docproj/doc-set.sgml b/data/ja_JP.EUC/docproj/doc-set.sgml new file mode 100644 index 0000000000..2da3b0e6b4 --- /dev/null +++ b/data/ja_JP.EUC/docproj/doc-set.sgml @@ -0,0 +1,71 @@ + + + + %includes; +]> + + + + + + &header; + +

FreeBSD のドキュメンテーションは四つの基本的なカテゴリにわけられます. +

+ +
    +

  1. + マニュアル・ページ

    + +

    これらはベース・システムの一部ですから, + プロジェクトは実際には関わっていません. + 例外として, 日本のチームがマニュアルページを翻訳しています. + 他の言語においても, + ボランティアが集まってマニュアルページを翻訳するのは十分可能でしょう. +

    + +

    プロジェクトがマニュアルページに関わっていないのは, + マニュアルページが重要でないからではありません. + その反対です. マニュアルページは FreeBSD + 固有のシステムと密接に結び付いています. + そして大部分の場合, + マニュアルページを書くのにもっとも適した人は, + FreeBSD でその部分を記述した人なのです.

    2. + +

  2. FAQ

    + +

    プロジェクトによって維持されています. + FreeBSD + 専用のメーリングリストやニュースグループで何回も繰り返されている, + あるいは繰り返され得る質問を (短い質疑応答の形で) + 取り扱うのが目的です. + この形式には長く複雑で込み入った回答はそぐいません.

    3. + +

  3. ハンドブック

    + +

    プロジェクトによって維持されていません. + 深い検討が必要な話題はハンドブックで扱われます.

    4. + +

  4. チュートリアル

    + +

    これらチュートリアルの一部はプロジェクトの committer + によって維持されていますが, そうでないものもあります. + これらの文書の維持は個々の著者の責任に任されていますが, + 私の知る限りでは, + 彼らは全員読者層からの要望等に答えて文書を更新しています.

    + +

    幾つかのチュートリアルは FreeBSD の web サイトに保管されています. + それらに関しては, 著者が変更点を committer の誰かに送り, + committer が変更を行っています. + それ以外のチュートリアルは著者の個人的な web + スペースに保管されており, 著者が自由に変更を加えています. + その著者に考えがあってそういう方法を選択している場合もありますし, + 歴史的な偶然によってそうなっている場合もあります.

    5. + +
+ + + &footer + + diff --git a/data/ja_JP.EUC/docproj/submitting.sgml b/data/ja_JP.EUC/docproj/submitting.sgml new file mode 100644 index 0000000000..e347154a87 --- /dev/null +++ b/data/ja_JP.EUC/docproj/submitting.sgml @@ -0,0 +1,163 @@ + + + + %includes; +]> + + + + + + &header; + +

ドキュメンテーションを書きました. どうやって寄稿すれば良いの?

+ +

はじめに, + ドキュメンテーションを書く作業に時間を割いてくださったことを感謝します. +

+ +

レビューのために, ドキュメンテーションを公開する必要があります. + もし可能なら, ドキュメンテーションを FTP や Web のサイトに置いてください. + もしご自分の FTP あるいは Web サイトをお持ちでない場合は, + ドキュメンテーションを + + ftp://ftp.FreeBSD.ORG/pub/FreeBSD/incoming/ + へアップロードし, send-pr (あとで説明します) + を使って, ドキュメンテーションを公開してくれるように + commiter の誰かにお願いしてください. +

+ +

それから, -doc メーリングリストへドキュメンテーションの概要と公開場所, + コメントの送り先を記したメッセージを投稿してください.

+ +

そのメッセージを他の適切なメーリングリストに cc: + した方がよい場合も多いでしょう. + 例えば, そのドキュメンテーションが, + ソースツリーを最新の状態に保つための CVSup + の使用法について言及しているなら, + その内容は FreeBSD-current や FreeBSD-stable + メーリングリストの講読者にとっても興味あるものでしょう.

+ +

ドキュメンテーションに目が通され, + 読者からの提案を組み入れる機会を得たなら, + ドキュメンテーションを寄稿する準備ができたと言えます.

+ +

ドキュメンテーションを寄稿する場合, + ファイルを tar 形式にまとめてください. + ドキュメンテーションが + + 

+    % tar cf doc.tar one two three
+
+ +

と入力してください. それから tar 形式のファイルを圧縮します.

+ + 
+    % gzip -9 doc.tar
+
+ +

doc.tar.gz というファイルが生成されます.

+ +

次に, /pub/FreeBSD/incoming/ + ディレクトリにアップロードする必要があります.

+ +

それから, + そのことをドキュメンテーションプロジェクトに知らせる必要があります. + 御使用のマシンにもインストールされているはずの + send-pr というコマンドを使うのが正しい方法です.

+ +

このコマンドを使うのは, + あなたが寄稿したことを後から確認することができるからです. + PR (Problem Report) を送ると, それぞれに固有な番号が割り当てられます. + その後, Commiter の誰かがその PR を担当し, + 新しいドキュメンテーションの commit + に関してあなたに連絡することになります.

+ +

send-pr 自体は非常に単純です. ちょっと特殊な形式の e-mail + を特定のアドレスに送るだけだからです. + send-pr を走らせると, エディタ (多分 vi か + emacs でしょう) が立ち上がり, + 記入用のテンプレートと記入方の説明が表示されるはずです.

+ +

"Category" を "docs" に, "Class" を "change-request" + に設定してください. Commiter がファイルを見つけられるように, + アップロードしたファイルの名前を書いておくのをお忘れなく!

+ +

エディタを終了させると, PR は e-mail として正しい場所へ送られます. + いくらもしないうちに, あなたが送った PR + の番号を伝える確認のメッセージが送られてくるはずです. + この番号は進展状況を確認するのに使用することができます.

+ +

また, + + http://www.freebsd.org/send-pr.html + の web インタフェースを使用することもできます.

+ +

既存のドキュメンテーションに変更を加えました. + どうやって寄稿すれば良いの?

+ +

繰り返しになりますが, お時間を割いてくださったことを感謝します.

+ +

まず最初に, diff + と呼ばれる特殊なファイルを生成する必要があります. + この diff は, あなたが施した変更点を正確にあらわしています. + Diff を使えば, commit を行う人は変更点を容易に知ることができ, + したがって, どこを変更したのか説明するのに時間を浪費しなくてすみます + (もちろん, + なぜその変更をした方がよいと考えるのかについては説明する必要があるのですが). +

+ +

'diff' をつくるには,

+ +
    +

  1. 変更するファイルのコピーを作ってください. + もし + + 

    +    % cp foo.sgml foo.sgml.old
+
    2. + +

  2. それから, foo.sgml を変更します.

    + + 
    +    % vi foo.sgml
+    ... えーと, ここをこうして, こう変えて ...
+
+    ... 変更点を点検して, 誤字がないか確認して, むにゃむにゃむにゃ ...
+
    3. + +

  3. diff をつくります. それ用のコマンドは以下のようになります.

    + + 
    +    % diff -c foo.sgml.old foo.sgml > foo.diff
+
    + +

    二つのファイルの相違点を調べ, それらを

    4. +
+ +

プロジェクトへ + +

+ ftp://ftp.FreeBSD.ORG/pub/FreeBSD/incoming/ + へ送ることもできますし, + もし diff が (誤字の訂正のように) 非常に小さいものである場合は, + 直接 PR の "Fix:" セクションに記入されても結構です.

+ +

どちらの場合でも, やはり send-pr を使用して, + commiter に変更点を知らせる必要があります. + その場合, "Category" を "docs" に, "Class" を + "doc-bug" (誤字のような問題を変更した場合) か + "change-request" (新しい情報を既存のセクションに加えた場合) に + 設定してください.

+ + &footer + + diff --git a/data/ja_JP.EUC/docproj/who.sgml b/data/ja_JP.EUC/docproj/who.sgml new file mode 100644 index 0000000000..1ab03be828 --- /dev/null +++ b/data/ja_JP.EUC/docproj/who.sgml @@ -0,0 +1,38 @@ + + + + %includes; +]> + + + + + + &header; + +

このプロジェクトは緩やかな結び付きを持った人々の集まりであり, + 我々はみな + FreeBSD-doc@FreeBSD.ORG + メーリングリストを購読しているという以外の共通点を持っていません.

+ +

我々の一部は, 変更点を直接 FreeBSD documentation tree に commit + することができます. + + ハンドブック に, commit 「権」を持っている人々の一覧があります.

+ +

他の人々は commit 権を持っていませんが, + ドキュメンテーションを書き, + 寄稿することはやはりできます. + Committer の誰かがドキュメンテーション集の中に追加してくれるでしょう. +

+ +

もしドキュメンテーションプロジェクトを手助けしたいと思われるなら + (そう思われることを強く願っています), + やることは一つ, メーリングリストを購読するだけです. + そうすればあなたももうプロジェクトの一員なのです. +

+ + &footer + + diff --git a/ja/Makefile b/ja/Makefile index 3a7b18ea7d..0625f9f417 100644 --- a/ja/Makefile +++ b/ja/Makefile @@ -1,4 +1,4 @@ -# $Id: Makefile,v 1.12 1998-06-23 15:15:00 kuriyama Exp $ +# $Id: Makefile,v 1.13 1998-07-07 03:14:10 hanai Exp $ # The FreeBSD Japanese Documentation Project # Original revision: 1.24 @@ -34,7 +34,7 @@ atoz.sgml: web.atoz # Subdirectories #SUBDIR= cgi commercial gifs ports releases tutorials -SUBDIR= ports releases +SUBDIR= docproj ports releases # Subdirectories that have linuxdoc docs and makefiles that use # . diff --git a/ja/docproj/Makefile b/ja/docproj/Makefile new file mode 100644 index 0000000000..6259e68a1f --- /dev/null +++ b/ja/docproj/Makefile @@ -0,0 +1,12 @@ +# $Id: Makefile,v 1.1 1998-07-07 03:14:11 hanai Exp $ +# The FreeBSD Japanese Documentation Project +# Original revision: 1.2 + +.if exists(Makefile.conf) +.include "Makefile.conf" +.endif + +DOCS= doc-set.sgml submitting.sgml who.sgml +#DOCS+= current.sgml sgml.sgml translation.sgml + +.include "../../web.mk" diff --git a/ja/docproj/doc-set.sgml b/ja/docproj/doc-set.sgml new file mode 100644 index 0000000000..2da3b0e6b4 --- /dev/null +++ b/ja/docproj/doc-set.sgml @@ -0,0 +1,71 @@ + + + + %includes; +]> + + + + + + &header; + +

FreeBSD のドキュメンテーションは四つの基本的なカテゴリにわけられます. +

+ +
    +

  1. + マニュアル・ページ

    + +

    これらはベース・システムの一部ですから, + プロジェクトは実際には関わっていません. + 例外として, 日本のチームがマニュアルページを翻訳しています. + 他の言語においても, + ボランティアが集まってマニュアルページを翻訳するのは十分可能でしょう. +

    + +

    プロジェクトがマニュアルページに関わっていないのは, + マニュアルページが重要でないからではありません. + その反対です. マニュアルページは FreeBSD + 固有のシステムと密接に結び付いています. + そして大部分の場合, + マニュアルページを書くのにもっとも適した人は, + FreeBSD でその部分を記述した人なのです.

    2. + +

  2. FAQ

    + +

    プロジェクトによって維持されています. + FreeBSD + 専用のメーリングリストやニュースグループで何回も繰り返されている, + あるいは繰り返され得る質問を (短い質疑応答の形で) + 取り扱うのが目的です. + この形式には長く複雑で込み入った回答はそぐいません.

    3. + +

  3. ハンドブック

    + +

    プロジェクトによって維持されていません. + 深い検討が必要な話題はハンドブックで扱われます.

    4. + +

  4. チュートリアル

    + +

    これらチュートリアルの一部はプロジェクトの committer + によって維持されていますが, そうでないものもあります. + これらの文書の維持は個々の著者の責任に任されていますが, + 私の知る限りでは, + 彼らは全員読者層からの要望等に答えて文書を更新しています.

    + +

    幾つかのチュートリアルは FreeBSD の web サイトに保管されています. + それらに関しては, 著者が変更点を committer の誰かに送り, + committer が変更を行っています. + それ以外のチュートリアルは著者の個人的な web + スペースに保管されており, 著者が自由に変更を加えています. + その著者に考えがあってそういう方法を選択している場合もありますし, + 歴史的な偶然によってそうなっている場合もあります.

    5. + +
+ + + &footer + + diff --git a/ja/docproj/docproj.sgml b/ja/docproj/docproj.sgml index 8a3ea14349..d78402f953 100644 --- a/ja/docproj/docproj.sgml +++ b/ja/docproj/docproj.sgml @@ -1,9 +1,9 @@ + %includes; ]> - + @@ -58,14 +58,14 @@ -

+

我々は何者か, どうしたら参加できるのか

このページでは, どのような人々がドキュメンテーションプロジェクトを構成しているのか, どうやったらあなたも参加できるのか説明しています.

-

FreeBSD ドキュメンテーション集

+

FreeBSD ドキュメンテーション集

このページでは, FreeBSD ドキュメンテーション集の構成と, ドキュメンテーションプロジェクトが, @@ -79,7 +79,7 @@ SGML でドキュメンテーションをつくる方法を概説し, 興味を持った読み手に, SGML に関する更なるリソースを教えています.

-

+

ドキュメンテーションを寄託する

ドキュメンテーションを寄託するのは, diff --git a/ja/docproj/submitting.sgml b/ja/docproj/submitting.sgml new file mode 100644 index 0000000000..e347154a87 --- /dev/null +++ b/ja/docproj/submitting.sgml @@ -0,0 +1,163 @@ + + + + %includes; +]> + + + + + + &header; + +

ドキュメンテーションを書きました. どうやって寄稿すれば良いの?

+ +

はじめに, + ドキュメンテーションを書く作業に時間を割いてくださったことを感謝します. +

+ +

レビューのために, ドキュメンテーションを公開する必要があります. + もし可能なら, ドキュメンテーションを FTP や Web のサイトに置いてください. + もしご自分の FTP あるいは Web サイトをお持ちでない場合は, + ドキュメンテーションを + + ftp://ftp.FreeBSD.ORG/pub/FreeBSD/incoming/ + へアップロードし, send-pr (あとで説明します) + を使って, ドキュメンテーションを公開してくれるように + commiter の誰かにお願いしてください. +

+ +

それから, -doc メーリングリストへドキュメンテーションの概要と公開場所, + コメントの送り先を記したメッセージを投稿してください.

+ +

そのメッセージを他の適切なメーリングリストに cc: + した方がよい場合も多いでしょう. + 例えば, そのドキュメンテーションが, + ソースツリーを最新の状態に保つための CVSup + の使用法について言及しているなら, + その内容は FreeBSD-current や FreeBSD-stable + メーリングリストの講読者にとっても興味あるものでしょう.

+ +

ドキュメンテーションに目が通され, + 読者からの提案を組み入れる機会を得たなら, + ドキュメンテーションを寄稿する準備ができたと言えます.

+ +

ドキュメンテーションを寄稿する場合, + ファイルを tar 形式にまとめてください. + ドキュメンテーションが + + 

+    % tar cf doc.tar one two three
+
+ +

と入力してください. それから tar 形式のファイルを圧縮します.

+ + 
+    % gzip -9 doc.tar
+
+ +

doc.tar.gz というファイルが生成されます.

+ +

次に, /pub/FreeBSD/incoming/ + ディレクトリにアップロードする必要があります.

+ +

それから, + そのことをドキュメンテーションプロジェクトに知らせる必要があります. + 御使用のマシンにもインストールされているはずの + send-pr というコマンドを使うのが正しい方法です.

+ +

このコマンドを使うのは, + あなたが寄稿したことを後から確認することができるからです. + PR (Problem Report) を送ると, それぞれに固有な番号が割り当てられます. + その後, Commiter の誰かがその PR を担当し, + 新しいドキュメンテーションの commit + に関してあなたに連絡することになります.

+ +

send-pr 自体は非常に単純です. ちょっと特殊な形式の e-mail + を特定のアドレスに送るだけだからです. + send-pr を走らせると, エディタ (多分 vi か + emacs でしょう) が立ち上がり, + 記入用のテンプレートと記入方の説明が表示されるはずです.

+ +

"Category" を "docs" に, "Class" を "change-request" + に設定してください. Commiter がファイルを見つけられるように, + アップロードしたファイルの名前を書いておくのをお忘れなく!

+ +

エディタを終了させると, PR は e-mail として正しい場所へ送られます. + いくらもしないうちに, あなたが送った PR + の番号を伝える確認のメッセージが送られてくるはずです. + この番号は進展状況を確認するのに使用することができます.

+ +

また, + + http://www.freebsd.org/send-pr.html + の web インタフェースを使用することもできます.

+ +

既存のドキュメンテーションに変更を加えました. + どうやって寄稿すれば良いの?

+ +

繰り返しになりますが, お時間を割いてくださったことを感謝します.

+ +

まず最初に, diff + と呼ばれる特殊なファイルを生成する必要があります. + この diff は, あなたが施した変更点を正確にあらわしています. + Diff を使えば, commit を行う人は変更点を容易に知ることができ, + したがって, どこを変更したのか説明するのに時間を浪費しなくてすみます + (もちろん, + なぜその変更をした方がよいと考えるのかについては説明する必要があるのですが). +

+ +

'diff' をつくるには,

+ +
    +

  1. 変更するファイルのコピーを作ってください. + もし + + 

    +    % cp foo.sgml foo.sgml.old
+
    2. + +

  2. それから, foo.sgml を変更します.

    + + 
    +    % vi foo.sgml
+    ... えーと, ここをこうして, こう変えて ...
+
+    ... 変更点を点検して, 誤字がないか確認して, むにゃむにゃむにゃ ...
+
    3. + +

  3. diff をつくります. それ用のコマンドは以下のようになります.

    + + 
    +    % diff -c foo.sgml.old foo.sgml > foo.diff
+
    + +

    二つのファイルの相違点を調べ, それらを

    4. +
+ +

プロジェクトへ + +

+ ftp://ftp.FreeBSD.ORG/pub/FreeBSD/incoming/ + へ送ることもできますし, + もし diff が (誤字の訂正のように) 非常に小さいものである場合は, + 直接 PR の "Fix:" セクションに記入されても結構です.

+ +

どちらの場合でも, やはり send-pr を使用して, + commiter に変更点を知らせる必要があります. + その場合, "Category" を "docs" に, "Class" を + "doc-bug" (誤字のような問題を変更した場合) か + "change-request" (新しい情報を既存のセクションに加えた場合) に + 設定してください.

+ + &footer + + diff --git a/ja/docproj/who.sgml b/ja/docproj/who.sgml new file mode 100644 index 0000000000..1ab03be828 --- /dev/null +++ b/ja/docproj/who.sgml @@ -0,0 +1,38 @@ + + + + %includes; +]> + + + + + + &header; + +

このプロジェクトは緩やかな結び付きを持った人々の集まりであり, + 我々はみな + FreeBSD-doc@FreeBSD.ORG + メーリングリストを購読しているという以外の共通点を持っていません.

+ +

我々の一部は, 変更点を直接 FreeBSD documentation tree に commit + することができます. + + ハンドブック に, commit 「権」を持っている人々の一覧があります.

+ +

他の人々は commit 権を持っていませんが, + ドキュメンテーションを書き, + 寄稿することはやはりできます. + Committer の誰かがドキュメンテーション集の中に追加してくれるでしょう. +

+ +

もしドキュメンテーションプロジェクトを手助けしたいと思われるなら + (そう思われることを強く願っています), + やることは一つ, メーリングリストを購読するだけです. + そうすればあなたももうプロジェクトの一員なのです. +

+ + &footer + +