perl - POD 多言語ドキュメント

Question

POD を使用して多言語ドキュメントを作成する方法はありますか? いいえの場合、どのように記述すればよいですか (英語の POD ドキュメントが既にあるので、変換してから翻訳したいと考えています)。

Answer 1

1. POD が英語以外のエンコーディングをサポートしているかどうかを尋ねる場合、答えは圧倒的に YES です。ロシア語に翻訳された brian d foy の記事 (POD 形式) の例を次に示します。

2. 多言語 POD を同じファイルに貼り付けることが可能かどうか疑問に思っている場合は、かなり奇妙な例が​​ここにあります: http://cpansearch.perl.org/src/HIO/Unicode-Japanese-0.47/lib/Unicode/Japanese .mlpod

   Pod::Multilangを使用します

   ただし、その mlpod から直接生成された html の 2 つの例を見つけることができなかったため、それがどのように機能するか (または機能するかどうか) は完全にはわかりません。

3. http://perldoc2.sourceforge.net/を参照してください- これは国際的な perldoc のためのプロジェクトです

Answer 2

モジュールを CPAN で配布する準備をしている場合.podは、ドキュメントの翻訳用に別のファイルを作成してください。

たとえば、英語のドキュメントを に含めた場合、ファイル、などMy/Module.pmを作成できます。My/Module-jp.podMy/Module-ru.pod

=head1 NAME

My::Module-pl - Atin-lay Ig-pay ocumentation-day or-fay y-may odule-may

=head1 ERSION-VAY

1.01

=head1 ESCRIPTION-DAY

...