PO4A.7(1) User Contributed Perl Documentation PO4A.7(1) po4a - , . , . po4a, , , , , , . po4a? () , - . -- , : . - , - . , . , , . , , gettext. , ( PO-, translation catalogs, ). , PO-. gettext , . , . , , , . , , . , . , . , . , , -. , , , . , , , . po4a - . , . gettext . gettext, PO. gettext , . po4a , , . , , , , . . , , , , . , . << >> . : man ( ) man-, . po4a , , . Locale::Po4a::Man(3pm) mdoc, BSD man pages ( Linux). AsciiDoc ( ) , . , git. manpages po4a. . Locale::Po4a::AsciiDoc. pod ( ) Perl (Perl Online Documentation). , perl. , . , , , . . Locale::Po4a::Pod. sgml ( ) XML , , . . . , diff , . , po4a . DebianDoc DocBook DTD, DTD . po4a SGML DTD, ; . . Locale::Po4a::Sgml(3pm). TeX / LaTeX ( ) LaTeX -- , . Locale::Po4a::LaTeX(3pm) Python, . text ( ) Text , , Markdown, fortunes, YAML- (Front Matter), debian/changelog debian/control. , , README . Locale::Po4a::Text(3pm). xml and XHMTL (, ) XML . , po4a DocBook DTD (c. Locale::Po4a::Docbook(3pm)) XHTML. BibTex (, ) BibTex LaTex (). . Locale::Po4a::BibTex. Docbook (, ) XML, . . Locale::Po4a:Docbook. Guide XML (, ) XML. Gentoo Linux 2016 ( Wayback Machine). Gentoo XML- DevBook. Locale::Po4a:Guide. Wml (, ) -, WML WAP, . Xhtml, XmL. Locale::Po4a::Wml. Yaml (, ) JSON. YAML . YAML Ansible Red Hat. . Locale::Po4a::Yaml. RubyDoc (, ) Ruby Document (RD), Ruby Ruby- RDoc 2002 . , -, Ruby RD. . Locale::Po4a::RubyDoc. Halibut (, ) , , TeX, debiandoc-sgml, TeXinfo , , PuTTY. . Locale::Po4a:Halibut. Ini (, ) , MS-DOS. Locale::Po4a::Ini. texinfo ( ) GNU ( , , GNU). Locale::Po4a::Texinfo(3pm) po4a . , . gemtext ( ) Gemini. ".gmi". po4a . - , . org ( ) , Org-mode. po4a . - , . vimhelp ( ) , Vim ( ). po4a . - , . simplepod ( ) pod, Pod::Simple. , . - , , . pod. Po4a , Linux 2.4+ (Locale::Po4a::KernelHelp) , dia (Locale::Po4a::Dia). , , . . Locale::Po4a::TransTractor(3pm). , po4a . . , , , (deb rpm), , , changelogs , , , wine. po4a -- po4a . . po4a(1). po4a , . , po4a , , , po4a(1), , po4a. , , . master.doc - , ; XX.doc - , XX, doc.XX.po - XX. master.doc ( man-, XML-, AsciiDoc ..); PO-, XX.doc. , "[po4a updates po]", po4a, , "{ master.doc}" -- . .doc | V +<----<----+<-----<-----<--------+------->-------->--------+ : | | : {} | { .doc} : : | | : XX.doc | V V () | .doc ->-------->------->+ : | () | V V | | [po4a-gettextize] doc.XX.po -->+ | | | () | | | | ^ V V | | | [po4a po] | V | | V .pot ^ V | | | doc.XX.po | | | () | {} | | | | ^ V V | | { } | | | | | V | V V doc.XX.po --->---->+<---<-- doc.XX.po .doc () () () () : | | | : V | | +----->----->----->------> + | | | | | V V V +------>------+-----<-------+ | V [po4a ] | V XX.doc () , . . po4a(1). , po4a-gettextize(1) po4a. PO-. ( . po4a-gettextize(1)), . , . , -- . . . , , , , <<>> (fuzzy), , . . , , PO, . , GNOME Translation Editor, KDE's Lokalize poedit, - , weblate pootle. PO-, . . gettext. , po4a master.doc doc.XX.po, . , . , (addendum). , , , . . . po4a , . , po4a, . , , , . . po4a(1). - , .. , , , po4a po4a-gettextize. ( man- ), , . , po4a PO- . po4a "--no-translations", (.. PO-) "--no-update", PO- (.. ). , po4a-updatepo po4a-translate, (. << ?>> << >> ). (addendum) - , , , , :). , , - . -- , , , . po4a addendum-, <<>>, . , , , . -- , (, , - . ), . PO4A-HEADER:, key=value, . , , . PO4A-HEADER: mode=eof , . , , XML- ( "
"), " " ( ). PO4A-HEADER: position= ; mode=after; endboundary=
, po4a , "position" ( ). , po4a . , , , : PO4A-HEADER: position=A propos de ce document; mode=after; endboundary= "position" , po4a "position" , "endboundary" ( ). ( endboundary, , ). , : PO4A-HEADER: position= ; mode=after; beginboundary=
po4a , "
" , " " , , beginboundary, , . , po4a, , " ", , , "
". , "
", "
". (mode) "before" : "mode=before" "endboundary" "endboundary", "position"; "mode=before" "beginboundary" "beginboundary" "position". | | | ========|===============|============================|=================================== 'before'|'endboundary' | 'position' | 'before'|'beginboundary'| 'position' | 'after' |'endboundary' | 'position' | 'after' |'beginboundary'| 'position' | 'eof' | () | / | o , -- . , nroff, ".fi", ".fi" endboundary, "the[ fi]le", , , , . endboundary : "^\.fi$". o "position" . , . , . PO4A-HEADER: position= ; mode=after; beginboundary=
PO4A-HEADER: position= ; mode=after; beginboundary=
o , , , , . , , , XML- . , . o , , po4a "-vv". , , , po4a , . o - nroff ( man-): .SH "" , .. mode=after. position. (, ^\.SH) beginboundary. : PO4A-HEADER: mode=after; position=; beginboundary=\.SH o - (, < >>), position, , mode=after, beginboundary -- , . PO4A-HEADER:mode=after;position=Copyright , 2004;beginboundary=^ o - , position , ( ; po4a , ), endboundary . , "EOF", , . PO4A-HEADER:mode=after;position= ;beginboundary=FakePo4aBoundary ( POD): |=head1 NAME | |dummy - a dummy program | |=head1 AUTHOR | |Me ( ) . |PO4A-HEADER:mode=after;position=;beginboundary=^=head | |=head1 | | | <<>>, : PO4A-HEADER:mode=after;position=;beginboundary=^=head1 , beginboundary "/^=head1/" <> ( <<>> ) . , . , - <<>> <<>>, , . , mode=before: PO4A-HEADER:mode=before;position=^=head1 ? po4a , , . , , , . TransTractors po4a Locale::Po4a::TransTractor(3pm), -. , . , TransTractor PO- , , : PO- ( ) ( , , PO-). : -\ /---> \ TransTractor:: / () +-->-- parse() --------+ / \ PO ------/ \---> PO () po4a. PO-, po4a-translate. , po4a-updatepo. po4a TransTractor POT- ( ), msgmerge -U PO- , TransTractor, . , po4a , , . po4a-gettextize TransTractor, -: TransTractor , PO-, msgid , , msgid msgid msgstr. , , , , , po4a-gettextize(1). , po4a TransTractor. , Text, Markdown AsciiDoc. , TransTractor::shiftline(), ( - ). (, ) , TransTractor::translate(), (1) PO- (2) PO-. TransTractor::pushline(). , . , Xml, HTML, SGML Pod SAX-. , << >>, POT- , TransTractor::translate() TransTractor::pushline(). Yaml , : , YAML::Tiny. , Yaml- po4a : , , <<$_:1>> . , SAX-, . - . , TransTractor::read() ( ) . , , , , PerlIO. -- , . . Pod::read() Pod::parse(). , , , TransTractor, , , perl- open() : "<:encoding($charset)". PO- Locale::Po4a::Po(3pm) PO POT-, . , , , gettext() PO-. , PO- POT- , msgmerge msgfmt . po4a - , : , -, . po4a . , , , . CONTRIBUTING.md. , po4a , po4a . , e-mail ( ). o adduser (man): . o apt (man, docbook): Debian. o aptitude (docbook, svg): Debian o F-Droid website (markdown): (Free and Open Source Software) Android. o git (asciidoc): . o Linux manpages (man) man-, ( , Arch Linux, Debian , Fedora). o Stellarium (HTML): . po4a . o Jamulus (markdown, yaml, HTML): FOSS- - . - po4a. o , : <>? pouah , , <<!>> :) , :) ? po4a-updatepo po4a-translate, , (depricated) po4a. , , , po4a , -- , . 150 , po4a -- 1200, . , , , , , . #1022216 Debian #442 GitHub, , po4a, po4a-updatepo. . , , po4a. . , , 2030 . 2030 - po4a-updatepo po4a-translate, . - , , - . ( ), . , gettext? . ( ) , . poxml , KDE DocBook XML. , , PO- . XML DTD. , , msgid. , . po-debiandoc , , SGML po4a, . , DTD DebianDoc, . xml2po.py GIMP 2004 ; , , , , XML-, make-. Sphinx Sphinx gettext . , : rest markdown, , , , . po4a -- ( ) . , gettext o , , . o , , , . o gettext ( po4a , , ). , , , gettext , , . o ( , , , ). . o , PO- (, PO- Emacs, Lokalize Gtranslator) . o gettext , , , . : - https://docs.kde.org/stable5/en/kdesdk/lokalize/project-view.html - http://www.debian.org/intl/l10n/ , , . o . o , , - - -. , , , . o , , po4a , . , - po4a Gtranslator Lokalize. , , , PO- . MS Word (TM) (, , RTF), po4a. o po4a(1), , . o po4a: po4a-gettextize(1), po4a-updatepo(1), po4a-translate(1), po4a-normalize(1). o : msguntypot(1), po4a-display-man(1), po4a-display-pod(1). o , , : Locale::Po4a::AsciiDoc(3pm) Locale::Po4a::Dia(3pm), Locale::Po4a::Gemtext(3pm), Locale::Po4a::Guide(3pm), Locale::Po4a::Ini(3pm), Locale::Po4a::KernelHelp(3pm), Locale::Po4a::Man(3pm), Locale::Po4a::RubyDoc(3pm), Locale::Po4a::Texinfo(3pm), Locale::Po4a::Text(3pm), Locale::Po4a::Xhtml(3pm), Locale::Po4a::Yaml(3pm), Locale::Po4a::BibTeX(3pm), Locale::Po4a::Docbook(3pm), Locale::Po4a::Halibut(3pm), Locale::Po4a::LaTeX(3pm), Locale::Po4a::Org(3pm), Locale::Po4a::Pod(3pm), Locale::Po4a::Sgml(3pm), Locale::Po4a::TeX(3pm), Locale::Po4a::VimHelp, Locale::Po4a::Wml(3pm), Locale::Po4a::Xml(3pm).Locale::Po4a::Dia(3pm), Locale::Po4a::Gemtext(3pm), Locale::Po4a::Guide(3pm), Locale::Po4a::Ini(3pm), Locale::Po4a::KernelHelp(3pm), Locale::Po4a::Man(3pm), Locale::Po4a::RubyDoc(3pm), Locale::Po4a::Texinfo(3pm), Locale::Po4a::Text(3pm), Locale::Po4a::Xhtml(3pm), Locale::Po4a::Yaml(3pm), Locale::Po4a::BibTeX(3pm), Locale::Po4a::Docbook(3pm), Locale::Po4a::Halibut(3pm), Locale::Po4a::LaTeX(3pm), Locale::Po4a::Org(3pm), Locale::Po4a::Pod(3pm), Locale::Po4a::SimplePod(3pm), Locale::Po4a::Sgml(3pm), Locale::Po4a::TeX(3pm), Locale::Po4a::VimHelp, Locale::Po4a::Wml(3pm), Locale::Po4a::Xml(3pm). o : Locale::Po4a::TransTractor(3pm) ( ), Locale::Po4a::Chooser(3pm), Locale::Po4a::Po(3pm), Locale::Po4a::Common(3pm). CONTRIBUTING.md . (Denis Barbier) (Martin Quinson) (mquinson#debian.org) perl v5.42.0 2025-11-22 PO4A.7(1)