POD mehrsprachige Dokumentation

Question

Gibt es eine Möglichkeit, mehrsprachige Dokumentation mit POD zu schreiben? Wenn nein, wofür soll ich es schreiben (ich habe bereits eine POD-Dokumentation in Englisch, also werde ich es konvertieren und dann übersetzen)?

Answer 1

1. Wenn Sie fragen, ob POD nicht-englische Codierung unterstützt, ist die Antwort ein klares JA. Hier ist ein Beispiel von brian d foy dem Artikel (in POD-Format) ins Russische übersetzt: http://perlrussia.ru/article/brians-guide/brian%27s_guide.ru.pod

2. Wenn Sie sich fragen, ob es möglich ist mehrsprachigen POD in die gleiche Datei zu halten, gibt es ein ziemlich kurioses Beispiel hier: http://cpansearch.perl.org/src/HIO/Unicode-Japanese-0.47/lib/Unicode/Japanese.mlpod

   es verwendet Pod::Multilang

   aber ich bin nicht ganz sicher, wie (oder auch wenn) es funktioniert, wie ich es nicht zwei Beispiele von hTML-Code aus diesem mlpod gerade erzeugt finden konnten.

3. Siehe http://perldoc2.sourceforge.net/ - das ist ein Projekt für die internationale Perldoc ist

Answer 2

Wenn Sie Ihr Modul für die Verteilung auf CPAN Vorbereitung, erstellen Sie separate .pod-Dateien für die Übersetzung Ihrer Dokumentation.

Zum Beispiel, wenn Sie die englische Dokumentation in My/Module.pm aufgenommen haben, können Sie die Dateien My/Module-jp.pod, My/Module-ru.pod, etc .:

=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 

...