Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
jp:faq:dochelp [2007/01/24 09:32] amatubujp:faq:dochelp [2008/02/08 19:49] (current) – external edit 127.0.0.1
Line 1: Line 1:
 ====== POPFileのドキュメントをよりよくするためにできることはありますか? ====== ====== POPFileのドキュメントをよりよくするためにできることはありますか? ======
  
-POPFileのドキュメントは [[:jp| POPFile: POPFile Documentation Project]] に移っています(訳注:日本語のドキュメントは、 [[:jp| POPFile: JP POPFile Documentation Project]] です)+POPFileのドキュメントは [[:jp| POPFile: POPFile ドキュメンテーションプロジェクト]] に移っています。
  
 Wiki によって、誰でもドキュメントの編集に貢献することができ、継続的にドキュメントを改善することができるようになっています。ドキュメントの改善のために、あなたの知識を遠慮なく追加してください。アカウントのサインアップは、[[http://popfile.sourceforge.net/wiki/welcome?do=register | こちら]]です。 Wiki によって、誰でもドキュメントの編集に貢献することができ、継続的にドキュメントを改善することができるようになっています。ドキュメントの改善のために、あなたの知識を遠慮なく追加してください。アカウントのサインアップは、[[http://popfile.sourceforge.net/wiki/welcome?do=register | こちら]]です。
  
-===== ドキュメントの日本語化について =====+[[:jp:faq:editing_hints|編集する際のヒント]]もあります。
  
-POPFile 日本語化プロジェクトでは、このドキュメントの翻訳をすすめ、ほぼすべてのページの翻訳を終えることができました。今後は、既存ドキュメントの更新などが主となりますが、ドキュメントプロジェクトに興味のある方は、[[http://sourceforge.jp/projects/popfile/document/POPFile_Document_Project_Guideline/ja/4/POPFile_Document_Project_Guideline.txt| ドキュメントプロジェクトの概要]] を参照しください。+===== ドキュメントの日本語化プロジェクトについて =====
  
-==== ドキュメントプロジェクトに参加するまで流れ ====+POPFile 日本語化プロジェクトでは、このドキュメントの翻訳をすすめ、ほぼすべてのページの翻訳を終えることができました。たくさんの方のご協力ありがとうございました。今後は、既存ドキュメントの更新時への対応などが主となりますが、ドキュメンテーションプロジェクトに興味ある方は、以下を参照してください。
  
-  - まず、Sourceforge.jp にユーザ登録を行います。<br><br> 
-  - [[http://lists.sourceforge.jp/mailman/listinfo/popfile-jp-doc| popfile-jp-doc メーリングリスト]] に登録し、メーリングリスト宛に簡単な自己紹介などを投稿してください。<br><br> 
-  - 下記を参考に、編集のためのパスワードを入手します。<br><br> 
-  - "Preferences" をクリックして、"UserName" と "Administrator Password" を設定します。これで、編集ができるようになります。 
  
-===== 編集ためのパスワード配布(日本語)について =====+==== プロジェクトに参加するまで流れ ====
  
-John より、ドキュメンテーションプロジェクトのメンバーにパスワードを配布する許可をいただきしたのでamatubu (amatubu@users.sourceforge.jp連絡ただいてもかいませんこの場合、SourceForge.jp のメールアドレス (〜@users.sourceforge.jp) あるいは popfile-jp-doc に登録されたメールアドレスからメールっていたきますようよろしくお願します+  - [[http://sourceforge.jp/account/register.php |SourceForge.jp]] ユーザ登録を行いま 
 +  - [[http://lists.sourceforge.jp/mailman/listinfo/popfile-jp-doc| popfile-jp-doc メーリングリスト]] に登録し、メーリングリト宛に簡単な自己紹介などを投稿してください。 
 +  - [[http://popfile.sourceforge.net/wiki/welcome?do=register | こちら]] からサインアップってい。
  
-パスワドの設定については、名前を登録したときと同様に、Preferences で行います。Administrator Password 欄に、パスワードを入力して設定を保存すると編集ができるようになります。+==== 編集(翻訳)する際のルについて ====
  
-ちょっと不便になりますが、よろしくお願いします。+日本語プロジェクトでは、ページの内容に統一性を持たせるため、いくつかのルールを定めています。編集する際には、以下のルールに従て行うよう心がけてください。 
 + 
 +  - 日本語ページは、必ず「jp」ネームスペース内に作成してください。このドキュメントのように、原文が「faq:dochelp」であれば、これに「jp」を追加した「jp:faq:dochelp」が日本語ページなります。既存のページを編集する場合には気にする必要はありませんが、新しいページを作成する際にはご注意ください。 
 +  - 翻訳ページの下に必ず原文へのリンクを設定してください。これにより、レビューを行う方が原文を簡単に参照できるようなり、また、翻訳文が更新されていない場合でも原文を読んでいただくことが可能となります。 
 +  - ページの最後には[[:jp|POPFile ドキュメンテーションプロジェクト]]へのリンクを設定してください。これによっていつでもトップページに戻ることできるようになります。またトップページからいくつかの階層がある場合は、それぞれの階層に戻るためのリンクをできるだけ作成するようにしてください。 
 +  - 日本語オリジナルのドキュメントを作成した場合には、できるだけ英語に翻訳したページを作成するように心がけてください。日本語環境にのみ関係するドキュメントについてはこの限りではありません。 
 + 
 +==== 編集(翻訳)の手順について ==== 
 + 
 +日本語版 POPFile ドキュメンテーションプロジェクトでは、翻訳→レビューという流れを基本としています。これは誤訳を避けるとともに、できるだけわかりやすい文章にするためにも効果的だと考えています。逆に言えば、レビューという仕組みがあるわけですから、あまり自信がなくてもどんどん訳してもらえるとうれしいです。 
 + 
 +新しいページを翻訳するとき、あるいは既存のページでも大きな修正があった場合については翻訳後、レビューに回していただきますようよろしくお願いします(修正内容が大きいかどうかの判断は翻訳された方にお任せします)。編集する際の大まかな手順は以下のとおりです。 
 + 
 +  - 新しいページ(あるいは既存のページ)の翻訳をします。 
 +  - [[:jp:contributors | 日本語版 POPFile ドキュメンテーションプロジェクトに貢献した人たち]] の該当するレビュー待ち文書欄に、翻訳したページへのリンクを設定し(翻訳された方のアカウント名もしくは名前、そのページが新しいページなのか更新されたページなのかがわかるようにお願いします)、popfile-jp-doc メーリングリストにレビュー依頼を行います。 
 +  - レビューする方は、該当ページのレビューを行い、修正する箇所があれば修正し、[[:jp:contributors | 日本語版 POPFile ドキュメンテーションプロジェクトに貢献した人たち]] の該当するレビュー待ち文書欄からリンクを削除し、メーリングリストにレビュー完了報告を行います。その際、レビューの際に気になった点や大きな修正点があればそれも報告をお願いします。 
 + 
 +==== 翻訳以外の作業について ==== 
 + 
 +お使いのメールクライアントで POPFile を使用する方法、ファイアウォール、ウイルス対策ソフトと POPFile を共存させる方法を書いていただけるかたを募集しています。できるだけ多くのソフトウェアについて使用方法を掲載したいと考えていますが、実際に使っている方でないとわからないところもあるため、多くの方の協力が必要です。 
 + 
 +お使いのソフトウェアについての設定方法を書いていただけるという方は、[[jp:howtos|ハウツー]]の「特定のメールクライアントの設定」や「プロキシとファイアウォールソフトの設定」に項目の追加をお願いします。 
 + 
 +特定のソフトウェアについての設定方法については、同じソフトウェアを使用している方でないと内容の検証が行えませんので、レビューの対象外とします。ですが、情報はできるだけ共有していきたいと考えていますので、新しいページを作成された方は、メーリングリストへご報告いただければと思います。 
 + 
 +==== 日本語プロジェクトに貢献した人たち ==== 
 + 
 +POPFile はオープンソースプロジェクトですから、翻訳していただいた方に見返りを提供することはほとんどできません。ですが、ささやかではありますが、以下のページにクレジットを残しています。多くの方のご協力のおかげでドキュメントはほぼ完成しましたので、今後はこのページを翻訳、レビューの分担表として活用していきたいと思っています。
  
-参照: 
   * [[:jp:contributors | 日本語版 POPFile ドキュメンテーションプロジェクトに貢献した人たち]]   * [[:jp:contributors | 日本語版 POPFile ドキュメンテーションプロジェクトに貢献した人たち]]
-  * [[http://sourceforge.jp/projects/popfile/document/POPFile_Document_Project_Guideline/ja/4/POPFile_Document_Project_Guideline.txtドキュメントプロジェクトの概要]]+ 
 +==== 日本語プロジェクトへのご意見は ==== 
 + 
 +プロジェクトには参加しなくても、このドキュメンテーションプロジェクトに関して質問・提案・要望などがありましたら、[[http://lists.sourceforge.jp/mailman/listinfo/popfile-jp-doc|popfile-jp-doc ーリグリスト]]または [[:jp:discussionforum|POPFile 全般]]フォーラムへどうぞ。 
 + 
 +参考:
   * [[http://lists.sourceforge.jp/mailman/archives/popfile-jp-doc/2005-January/000601.html| Phase 7 以降の進め方について]] (popfile-jp-doc メーリングリストに投稿した amatubu 案)   * [[http://lists.sourceforge.jp/mailman/archives/popfile-jp-doc/2005-January/000601.html| Phase 7 以降の進め方について]] (popfile-jp-doc メーリングリストに投稿した amatubu 案)
  
 
jp/faq/dochelp.1169631144.txt.gz · Last modified: 2008/02/08 19:49 (external edit)
Old revisions

Should you find anything in the documentation that is incomplete, unclear, outdated or just plain wrong, please let us know and leave a note in the Documentation Forum.

Recent changes RSS feed Donate Driven by DokuWiki
The content of this wiki is protected by the GNU Fee Documentation License