PO4A.1P(1) User Contributed Perl Documentation PO4A.1P(1) PO4A - PO B [i ] i PO4A ( PO) . PO4A , . l . , B . PO ( ) , (PO ) . , PO . . , PO "" B . "" , , , . master documents ---+---->-------->---------+ (doc authoring) | | V (po4a executions) >-----+--> translated | | | documents existing PO files -->--> updated PO files >-+ | ^ | | | V | +----------<---------<-------+ ^ (manual translation process) | | addendum -->--------------------------------------+ B , . . PO . , PO , , b . , 80% . . . I <-keep> 80% . , 100% , , "" . , . PO , . , <> , . <> , </. ). , F . , , , , . , , . b . , , . : PO4A , . s . L , , , B PO4A . po4a-gettextize --format man --master foo.1 --localized foo.de.1 --po de.po PO4A . , : [po_directory] man/po4a/ [type: man] man/foo.1 $lang:man/translated/foo.$lang.1 PO ( ) F , , f . , . . , f f /foo.de.1> . B , . s (.. f ), b . : man/ | foo.1 <- The original man page, in English | po4a/ | | de.po <- The German PO translation, from gettextization | | foo.pot <- The POT template of future translations (empty at first) | translated/ <- Directory where the translations will be created po4a.cfg <- The configuration file , B , , PO , . : po4a --verbose po4a.cfg . B . f , . , , . PO , . , , S s . , f . f /foo.ja.1> ( ) b . <-k>, <-> ( ) (: 80). . , 80% . <-w>, <-> , (: 76). 0 , . . <-h>, <-> . <-m>, <--> . . B <-l>, b <--> . . B <-a>, b <-addendum-charset> . . <-v>, <-> . B <-v>, b <-verbose> . <-q>, <-> . <-d>, <-> . <-o>, <-> (). . , '-o ' , '-o = ' . <-f>, <-> B , PO . ( <-> ) : , (B <-no-Update> ). B . , , PO , . ( <-> ), <.po4a-stamp> ( b <-stamp>). , <-> , . PO . <-> B , . F <.PO4A- SPAMP> . : F <.po4a-stamp> . , B <-RM- > . <- > , PO . B <-no-Update> , . <--> <-> , . , . : PO4A : . . <-.-> ( <- >). <---> 0.41 , . <-.-> 0.41 , . <--> <-> . . PO POT . . <-> <=> <> B . I <$ (var)> i . . B <-target-lang> i PO , . . B <-srcdir> i B . i , , : i , . I . B <- destir> i B ( B <-SRCDIR> ). B <-porefs> i . <> b , <> , <> , < > (: ). <--> <> | < > | <> (: 76) PO . , , . , 77 PO . PO4A . , PO4A PO . < > , PO4A MSGID MSGSTR . <> , PO4A PO . . MSGID MSGSTR , . <- > . . B <-msgid-bugs-address> i <@> .... . , -MSGID-BUGS-TO . <--> . " , ." <--> . "". <--> . "". PO B <-msgmerge-opt> i B (1) . : <$ lang> . <--> b <-> b . 0.16 . <-> b <-msgmerge> B <-> . 0.16 , . PO4A . : o PO ; o , ; o . , . '#' . . , </..> . PO POT , : [po4a_paths] man/po/project.pot de:man/po/de.po fr:man/po/fr.po , . / : [po4a_langs] fr de [po4a_paths] man/po/project.pot $lang:man/po/$lang.po <$ lang> , / . . [po_directory] man/po/ PO , C C ISO 639-1. <.pot> . , , (PO4A ). C c . (c ) , / , . (c ), PO4A , , . .. , PO4A PO . , . , (, ....) , . , . , <[PO4A_Paths]> PO C <$ master> . [po4a_paths] doc/$master/$master.pot $lang:doc/$master/$lang.po , PO4A PO . , 3 5 , 3 15 . , <$ > . , < => , . . 2 : f (f ) f ( F f ). [po4a_langs] de fr ja [po4a_paths] l10n/po/$master.pot $lang:l10n/po/$master.$lang.po [type: xml] foo/gui.xml $lang:foo/gui.$lang.xml pot=foo [type: xml] bar/gui.xml $lang:bar/gui.$lang.xml pot=bar [type: xml] bar/cli.xml $lang:bar/cli.$lang.xml pot=bar , PO , PO . PO , B PO . , PO . . , , . . : [type: sgml] "doc/my stuff.sgml" "fr:doc/fr/mon truc.sgml" de:doc/de/mein\ kram.sgml [type: man] script fr:doc/fr/script.1 de:doc/de/script.1 [type: docbook] doc/script.xml fr:doc/fr/script.xml \ de:doc/de/script.xml , , .. . <$ > : [type: sgml] doc/my_stuff.sgml $lang:doc/$lang/my_stuff.sgml [type: man] script.1 $lang:po/$lang/script.1 [type: docbook] doc/script.xml $lang:doc/$lang/script.xml : I > PO4A , < > . I > , B <-Keep> 80% 50% . < > , .. L (3pm)>. , . c . . , ( ) , 0% ( ). [type:xml] toto.xml $lang:toto.$lang.xml opt:"-o nostrip" opt_fr:"--keep 0" , . , ( ), . , . : [type:xml] toto.xml $lang:toto.$lang.xml opt:"--keep 20" opt:"-o nostrip" opt_fr:"--keep 0" [type:xml] toto.xml $lang:toto.$lang.xml opt:"--keep 20 -o nostrip" opt_fr:"--keep 0" [type:xml] toto.xml $lang:toto.$lang.xml opt:--keep opt:20 opt:-o opt:nostrip opt_fr:--keep opt_fr:0 . , , . , , <-> . , . , <- 0> , <> . [po4a_alias:test] man opt_it:"--keep 0" [type: test] man/page.1 $lang:man/$lang/page.1 . . [po4a_alias:man] man opt_it:"--keep 0" [type: man] man/page.1 $lang:man/$lang/page.1 <[]> . [options] --keep 20 --option nostrip , : [options] -k 20 -o nostrip , . : o <[]> , . o . . o . , . o , B . : [po_directory] man/po/ [options] --master-charset UTF-8 [po4a_alias:man] man opt:"-o \"mdoc=NAME,SEE ALSO\"" [type:man] t-05-config/test02_man.1 $lang:tmp/test02_man.$lang.1 \ opt:"-k 75" opt_it:"-L UTF-8" opt_fr:--verbose : , , . L . [type: pod] script fr:doc/fr/script.1 \ add_fr:doc/l10n/script.fr.add : [type: pod] script $lang:doc/$lang/script.1 \ add_$lang:doc/l10n/script.$lang.add , . . . , . <@> , , . . , , . , . . [type: pod] script $lang:doc/$lang/script.1 add_$lang:?doc/l10n/script.$lang.add : [type: pod] script $lang:doc/$lang/script.1 add_$lang:@doc/l10n/script.$lang.add , . , . : [type:docbook] book.xml \ pot_in:book-filtered.xml \ $lang:book.$lang.xml , f ( b ) F . , f f PO , . . , <-> . L , l . Denis Barbier Nicolas Francois Martin Quinson (mquinson#debian.org) 2002-2023 , . ; / gpl v2.0 ( ). perl v5.42.0 2025-11-22 PO4A.1P(1)