/translation

日本語訳したドキュメントをおく場所

このリポジトリについて

https://github.com/perldoc-jp/translation

日本語に翻訳された CPAN モジュールの POD や Perl 本体のドキュメントが置かれています。

誰でも PR を作成して貢献することができます。

翻訳された内容は、https://perldoc.jp/で公開されます。

翻訳の手順

翻訳の基本的な流れは次の通りです。

  1. すでに翻訳が存在するかどうかは https://perldoc.jp/ で検索する
  2. 翻訳の修正や追加
  • このリポジトリの書き込み権限がない方は、この translation を fork して PR を送る。
  • このリポジトリの書き込み権限がある方は、PRを送るか、あるいは、直接修正をしてください。
  • 詳しくは、チュートリアルを参照ください。

以上です。PRがマージされたら、perldoc.jpに反映されます。

翻訳作業自体の作法はこちらに詳細なドキュメントがあります。

NOTE

このリポジトリ translation 以外に、Japanized Perl Resources Project (JPRP) が存在します。

https://perldoc.jp/ は両方の翻訳ドキュメントがマージして公開されています。

https://perldoc.jp/ に翻訳が存在するのに、この translation リポジトリにソースが見つからない場合、Japanized Perl Resources Project (JPRP) の CVS リポジトリも参照してください。

FAQ

翻訳について、オリジナルの著者への報告は必要ですか？

ほとんどの CPAN モジュールが改変と再配布が許可されているライセンスなので、元々のドキュメントの著者に翻訳の報告をする必要はありません。ライセンスが不明な場合や、改変と再配布が許可されていないライセンスの場合には、著者に連絡を取ってください。

質問はどこでできますか？

気軽に issue を立てましょう！

コミット権限はもらえますか？

PR を送るとしれっと追加してもらえるようです！