|
|
60.
|
|
|
How to use po4a?
|
|
|
type: =head1
|
|
|
|
|
如何使用po4a？
|
|
Translated and reviewed by
EAdam
|
|
|
|
Located in
doc/po4a.7.pod:220
|
|
|
61.
|
|
|
Graphical overview
|
|
|
type: =head2
|
|
|
|
|
图形总览
|
|
Translated and reviewed by
EAdam
|
|
|
|
Located in
doc/po4a.7.pod:227
|
|
|
62.
|
|
|
The following schema gives an overview of the process of translating documentation using po4a. Do not be afraid by its apparent complexity, it comes from the fact that the I<whole> process is represented here. Once you converted your project to po4a, only the right part of the graphic is relevant.
|
|
|
type: textblock
|
|
|
|
|
(no translation yet)
|
|
|
|
Located in
doc/po4a.7.pod:229
|
|
|
63.
|
|
|
Note that "master.doc" is taken as an example for the documentation to be translated and "translation.doc" is the corresponding translated text. The suffix could be ".pod", ".xml", or ".sgml" depending on its format. Each part of the picture will be detailed in the next sections.
|
|
|
type: textblock
|
|
|
|
|
(no translation yet)
|
|
|
|
Located in
doc/po4a.7.pod:235
|
|
|
64.
|
|
|
master.doc 
|
V
+<-----<----+<-----<-----<--------+------->-------->-------+
: | | :
{translation} | { update of master.doc } :
: | | :
XX.doc | V V
(optional) | master.doc ->-------->------>+
: | (new) |
V V | |
[po4a-gettextize] doc.XX.po--->+ | |
| (old) | | |
| ^ V V |
| | [po4a-updatepo] |
V | | V
translation.pot ^ V |
| | doc.XX.po |
| | (fuzzy) |
{ translation } | | |
| ^ V V
| | {manual editing} |
| | | |
V | V V
doc.XX.po --->---->+<---<---- doc.XX.po addendum master.doc
(initial) (up-to-date) (optional) (up-to-date)
: | | |
: V | |
+----->----->----->------> + | |
| | |
V V V
+------>-----+------<------+
|
V
[po4a-translate]
|
V
XX.doc
(up-to-date)
|
|
|
type: verbatim
|
|
|
represents a line break.
Start a new line in the equivalent position in the translation.
|
|
|
represents a space character.
Enter a space in the equivalent position in the translation.
|
|
|
|
|
(no translation yet)
|
|
|
|
Located in
doc/po4a.7.pod:240
|
|
|
65.
|
|
|
On the left part, the conversion of a translation not using po4a to this system is shown. On the top of the right part, the action of the original author is depicted (updating the documentation). The middle of the right part is where the automatic actions of po4a are depicted. The new material are extracted, and compared against the exiting translation. Parts which didn't change are found, and previous translation is used. Parts which where partially modified are also connected to the previous translation, but with a specific marker indicating that the translation must be updated. The bottom of the figure shows how a formatted document is built.
|
|
|
type: textblock
|
|
|
|
|
(no translation yet)
|
|
|
|
Located in
doc/po4a.7.pod:281
|
|
|
66.
|
|
|
Actually, as a translator, the only manual operation you have to do is the part marked {manual editing}. Yeah, I'm sorry, but po4a helps you translate. It does not translate anything for you...
|
|
|
type: textblock
|
|
|
|
|
(no translation yet)
|
|
|
|
Located in
doc/po4a.7.pod:291
|
|
|
67.
|
|
|
This section presents the needed steps required to begin a new translation with po4a. The refinements involved in converting an existing project to this system are detailed in the relevant section.
|
|
|
type: textblock
|
|
|
|
|
(no translation yet)
|
|
|
|
Located in
doc/po4a.7.pod:297
|
|
|
68.
|
|
|
To begin a new translation using po4a, you have to do the following steps:
|
|
|
type: textblock
|
|
|
|
|
要开始使用po4a进行新的翻译，您应该遵循以下步骤：
|
|
Translated and reviewed by
EAdam
|
|
|
|
Located in
doc/po4a.7.pod:301
|
|
|
69.
|
|
|
-
|
|
|
type: =item
|
|
|
|
|
-
|
|
Translated and reviewed by
EAdam
|
|
|
|
Located in
doc/po4a.7.pod:305 doc/po4a.7.pod:318 doc/po4a.7.pod:447 doc/po4a.7.pod:454 doc/po4a.7.pod:462 doc/po4a.7.pod:468 doc/po4a.7.pod:476 doc/po4a.7.pod:489 doc/po4a.7.pod:497 lib/Locale/Po4a/TransTractor.pm:52 lib/Locale/Po4a/TransTractor.pm:56 lib/Locale/Po4a/TransTractor.pm:66 lib/Locale/Po4a/TransTractor.pm:71 lib/Locale/Po4a/TransTractor.pm:764 lib/Locale/Po4a/TransTractor.pm:768 lib/Locale/Po4a/TransTractor.pm:772 lib/Locale/Po4a/TransTractor.pm:808 lib/Locale/Po4a/TransTractor.pm:812 lib/Locale/Po4a/TransTractor.pm:817 lib/Locale/Po4a/TransTractor.pm:1092 lib/Locale/Po4a/TransTractor.pm:1096 lib/Locale/Po4a/TransTractor.pm:1100
|
