Documentation multilingue en POD

Question

Existe-t-il un moyen d'écrire une documentation multilingue en utilisant POD? Si non, dans quoi dois-je l'écrire (j'ai déjà la documentation POD en anglais, donc je vais vouloir la convertir et la traduire)?

Answer 1

1. Si vous demandez si POD prend en charge l'encodage non-anglais, la réponse est un OUI retentissant. Voici un exemple de l'article de brian d foy (au format POD) traduit en russe: http://perlrussia.ru/article/brians-guide/brian%27s_guide.ru.pod

2. Si vous vous demandez s'il est possible de coller POD en plusieurs langues dans le même fichier, il y a un exemple assez curieux ici: http://cpansearch.perl.org/src/HIO/Unicode-Japanese-0.47/lib/Unicode/Japanese.mlpod

   il utilise Pod::Multilang

   Cependant, je ne suis pas tout à fait certain comment (ou même si) cela fonctionne, comme je ne pouvais pas trouver deux exemples de html générés directement à partir de ce mlpod.

3. Voir http://perldoc2.sourceforge.net/ - c'est un projet pour perldoc international

Answer 2

Si vous préparez votre module pour la distribution sur CPAN, créer .pod fichiers séparés pour les traductions de la documentation.

Par exemple, si vous avez inclus la documentation anglaise à My/Module.pm, vous pouvez créer les fichiers 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 

...