1PO4A-NORMALIZE.1P(1) User Contributed Perl Documentation PO4A-NORMALIZE.1P(1)
2
3
4
6 po4a-normalize - normalize a documentation file by parsing it in po4a,
7 and writing it back
8
10 po4a-normalize -f fmt master.doc
11
13 The po4a (PO for anything) project goal is to ease translations (and
14 more interestingly, the maintenance of translations) using gettext
15 tools on areas where they were not expected like documentation.
16
17 The po4a-normalize script is a debugging tool used to make sure that
18 po4a don't change the document when it's not supposed to. Only use it
19 if you're developing a new module, or if you doubt the sanity of the
20 tools.
21
22 The generated document will be written to po4a-normalize.output while
23 the generated POT file will be written to po4a-normalize.po by default,
24 but you can use the --localized and --pot options to change that.
25
27 -o, --option
28 Extra option(s) to pass to the format plugin. See the documentation
29 of each plugin for more information about the valid options and
30 their meanings. For example, you could pass '-o tablecells' to the
31 AsciiDoc parser, while the text parser would accept '-o
32 tabs=split'.
33
34 -b, --blank
35 Create an blank translated document. The generated translated
36 document will be generated assuming all messages are translated by
37 a space or new line.
38
39 This is useful to check what parts of the document cannot be
40 translated.
41
42 -h, --help
43 Show a short help message.
44
45 --help-format
46 List the documentation formats understood by po4a.
47
48 -f, --format
49 Format of the documentation you want to handle. Use the
50 --help-format option to see the list of available formats.
51
52 -M, --master-charset
53 Charset of the file containing the document to translate.
54
55 -l, --localized
56 Name of the normalized file to produce (po4a-normalize.output by
57 default).
58
59 -p, --pot
60 Pot file to produce (po4a-normalize.po by default).
61
62 -V, --version
63 Display the version of the script and exit.
64
66 po4a-gettextize(1), po4a-translate(1), po4a-updatepo(1), po4a(7)
67
69 Denis Barbier <barbier@linuxfr.org>
70 Nicolas François <nicolas.francois@centraliens.net>
71 Martin Quinson (mquinson#debian.org)
72
74 Copyright 2002-2020 by SPI, inc.
75
76 This program is free software; you may redistribute it and/or modify it
77 under the terms of GPL (see the COPYING file).
78
79
80
81perl v5.38.0 2023-10-12 PO4A-NORMALIZE.1P(1)