11:44 a.m.
Hello po4a maintainers,
we recently had a first translation of a perl man page in
manpages-l10n. In your documentation (in the man pages) I read that
you have lots of experience handling perl documentations, so I hope
you can help me.
The perl(1) man page introduces the macro
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
and then perl.1 uses this to create tables, e.g.:
Overview
perl Perl overview (this section)
perlintro Perl introduction for beginners
perlrun Perl execution and options
perltoc Perl documentation table of contents
This table becomes
#. type: IX
#: debian-bullseye debian-unstable fedora-37 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-5 opensuse-tumbleweed
#, no-wrap
msgid "Overview"
msgstr "Überblick"
#. type: IX
#: debian-bullseye debian-unstable fedora-37 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-5 opensuse-tumbleweed
#, no-wrap
msgid "Subsection"
msgstr "Subsection"
#. type: Plain text
#: debian-bullseye debian-unstable fedora-37 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-5 opensuse-tumbleweed
msgid ""
"\\& perl Perl overview (this section) \\& perlintro Perl introduction for
"
"beginners \\& perlrun Perl execution and options \\& perltoc Perl "
"documentation table of contents"
msgstr ""
"\\& perl Perl-Überblick (dieser Abschnitt) \\& perlintro Perl-Einführung
"
"für Anfänger \\& perlrun Perl-Ausführung und -Optionen \\& perltoc "
"Inhaltsverzeichnis der Perl-Dokumentation"
in the po file and then the resulting file looks like this:
Überblick
perl Perl-Überblick (dieser Abschnitt) perlintro Perl-Einführung für
Anfänger perlrun Perl-Ausführung und -Optionen perltoc
Inhaltsverzeichnis der Perl-Dokumentation
So the formatting is broken, unfortunately some tables are much longer
in perl.1 …
Do you have any suggestions how to handle this, to unbreak the
situation? I'm running out of ideas.
Thanks!
Greetings
Helge
--
Dr. Helge Kreutzmann debian(a)helgefjell.de
Dipl.-Phys. http://www.helgefjell.de/debian.php
64bit GNU powered gpg signed mail preferred
Help keep free software "libre": http://www.ffii.de/
2:07 a.m.
Hello Helge,
the man pages of po4a themselves are written in POD, as most of the Perl
documentation, so yes, we have some experience here.
But I'm wondering why you try to translate the manpage produced by POD (a file
in groff format) instead of trying to translate the pod file directly. I guess
that translating the source files is always better than translating something
that was generated.
Or maybe there is something that I misuderstand?
Cheers,
Mt
Le samedi 08 octobre 2022 à 18:44 +0200, Helge Kreutzmann a écrit :
Hello po4a maintainers,
we recently had a first translation of a perl man page in
manpages-l10n. In your documentation (in the man pages) I read that
you have lots of experience handling perl documentations, so I hope
you can help me.
The perl(1) man page introduces the macro
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
and then perl.1 uses this to create tables, e.g.:
Overview
perl Perl overview (this section)
perlintro Perl introduction for beginners
perlrun Perl execution and options
perltoc Perl documentation table of contents
This table becomes
#. type: IX
#: debian-bullseye debian-unstable fedora-37 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-5 opensuse-tumbleweed
#, no-wrap
msgid "Overview"
msgstr "Überblick"
#. type: IX
#: debian-bullseye debian-unstable fedora-37 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-5 opensuse-tumbleweed
#, no-wrap
msgid "Subsection"
msgstr "Subsection"
#. type: Plain text
#: debian-bullseye debian-unstable fedora-37 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-5 opensuse-tumbleweed
msgid ""
"\\& perl Perl overview (this section) \\& perlintro Perl introduction for
"
"beginners \\& perlrun Perl execution and options \\& perltoc Perl "
"documentation table of contents"
msgstr ""
"\\& perl Perl-Überblick (dieser Abschnitt) \\& perlintro Perl-Einführung
"
"für Anfänger \\& perlrun Perl-Ausführung und -Optionen \\& perltoc "
"Inhaltsverzeichnis der Perl-Dokumentation"
in the po file and then the resulting file looks like this:
Überblick
perl Perl-Überblick (dieser Abschnitt) perlintro Perl-Einführung für
Anfänger perlrun Perl-Ausführung und -Optionen perltoc
Inhaltsverzeichnis der Perl-Dokumentation
So the formatting is broken, unfortunately some tables are much longer
in perl.1 …
Do you have any suggestions how to handle this, to unbreak the
situation? I'm running out of ideas.
Thanks!
Greetings
Helge
_______________________________________________
Devel mailing list -- devel(a)lists.po4a.org
To unsubscribe send an email to devel-leave(a)lists.po4a.org
--
Pour une évaluation indépendante, transparente et rigoureuse !
Je soutiens la Commission d'Évaluation de l'Inria.
12:12 p.m.
Hello Martin,
On Tue, Oct 11, 2022 at 09:07:23AM +0200, Martin Quinson wrote:
the man pages of po4a themselves are written in POD, as most of the
Perl
documentation, so yes, we have some experience here.
But I'm wondering why you try to translate the manpage produced by POD (a file
in groff format) instead of trying to translate the pod file directly. I guess
that translating the source files is always better than translating something
that was generated.
Or maybe there is something that I misuderstand?
--
Pour une évaluation indépendante, transparente et rigoureuse !
Je soutiens la Commission d'Évaluation de l'Inria.
In manpage-l10n we always download the man pages available from the
various distributions, create po files from them and use these as
basis for the translation. So we actually don't know in general how
the man page was generated: From help2man, written in groff/nroff, in
docbook, markdown, pod, ..
Simply put: We don't have the source available.
Greetings
Helge
--
Dr. Helge Kreutzmann debian(a)helgefjell.de
Dipl.-Phys. http://www.helgefjell.de/debian.php
64bit GNU powered gpg signed mail preferred
Help keep free software "libre": http://www.ffii.de/
775
days inactive
778
days old
2 comments
2 participants
participants (2)
-
Helge Kreutzmann -
Martin Quinson