Comment utiliser les caractères Unicode dans Pod et perldoc?
-
03-07-2019 - |
Question
Je dois utiliser les caractères utf-8 dans ma documentation perl. Si j'utilise:
perldoc MyMod.pm
Je vois des personnages étranges. Si j'utilise:
pod2text MyMod.pm
tout va bien.
J'utilise Ubuntu / Debian.
$ locale
LANG=de_DE.UTF-8
LC_CTYPE="de_DE.UTF-8"
LC_NUMERIC="de_DE.UTF-8"
LC_TIME="de_DE.UTF-8"
LC_COLLATE="de_DE.UTF-8"
LC_MONETARY="de_DE.UTF-8"
LC_MESSAGES="de_DE.UTF-8"
LC_PAPER="de_DE.UTF-8"
LC_NAME="de_DE.UTF-8"
LC_ADDRESS="de_DE.UTF-8"
LC_TELEPHONE="de_DE.UTF-8"
LC_MEASUREMENT="de_DE.UTF-8"
LC_IDENTIFICATION="de_DE.UTF-8"
LC_ALL=de_DE.UTF-8
Existe-t-il un guide d'utilisation des caractères spéciaux dans Pod?
Voici un petit exemple utilisant des trémas allemands "Juste un test: & # 228; & # 246; & # 252; & # 223; & # 196; & # 214;":
$ perldoc perl/MyMod.pm
<standard input>:72: warning: can't find character with input code 159
<standard input>:72: warning: can't find character with input code 150
MyMod(3) User Contributed Perl Documentation MyMod(3)
NAME
MyMod.pm - Just a Test: äöüÃÃÃ
perl v5.10.0 2008-10-16 MyMod(3)
La solution
Utilisez = encoding utf-8
comme première directive POD de votre fichier et utilisez un perldoc
relativement récent (par exemple, à partir de 5.10-maint). Alors ça devrait marcher.
Autres conseils
Vous avez trouvé ce ticket RT ... http: // rt .cpan.org / Public / Bug / Display.html? id = 39000
Ce " bug " semble être introduit avec Perl 5.10 et peut-être que pod2man --utf8 doit être utilisé.
perldoc -t MyMod.pm
À partir du manuel perldoc:
-t Affiche le pod en utilisant pod2text au lieu de Pod :: Man et groff (-t est la valeur par défaut sur win32 sauf si -n est spécifié)