1Locale::Po4a::Text(3pm)           Po4a Tools           Locale::Po4a::Text(3pm)
2
3
4

NAME

6       Locale::Po4a::Text - convert text documents from/to PO files
7

DESCRIPTION

9       The po4a (PO for anything) project goal is to ease translations (and
10       more interestingly, the maintenance of translations) using gettext
11       tools on areas where they were not expected like documentation.
12
13       Locale::Po4a::Text is a module to help the translation of text
14       documents into other [human] languages.
15
16       Paragraphs are split on empty lines (or lines containing only spaces or
17       tabulations).
18
19       If a paragraph contains a line starting by a space (or tabulation),
20       this paragraph won't be rewrapped.
21

OPTIONS ACCEPTED BY THIS MODULE

23       These are this module's particular options:
24
25       keyvalue
26           Treat paragraphs that look like a key value pair as verbatim (with
27           the no-wrap flag in the PO file).  Key value pairs are defined as a
28           line containing one or more non-colon and non-space characters
29           followed by a colon followed by at least one non-space character
30           before the end of the line.
31
32       nobullets
33           Deactivate detection of bullets.
34
35           By default, when a bullet is detected, the bullet paragraph is not
36           considered as a verbatim paragraph (with the no-wrap flag in the PO
37           file), but the module rewraps this paragraph in the generated PO
38           file and in the translation.
39
40       tabs=mode
41           Specify how tabulations shall be handled. The mode can be any of:
42
43           split
44               Lines with tabulations introduce breaks in the current
45               paragraph.
46
47           verbatim
48               Paragraph containing tabulations will not be re-wrapped.
49
50           By default, tabulations are considered as spaces.
51
52       breaks=regex
53           A regular expression matching lines which introduce breaks.  The
54           regular expression will be anchored so that the whole line must
55           match.
56
57       debianchangelog
58           Handle the header and footer of released versions, which only
59           contain non translatable informations.
60
61       fortunes
62           Handle the fortunes format, which separate fortunes with a line
63           which consists in '%' or '%%', and use '%%' as the beginning of a
64           comment.
65
66       markdown
67           Handle some special markup in Markdown-formatted texts.
68
69       control[=taglist]
70           Handle control files.  A comma-separated list of tags to be
71           translated can be provided.
72
73       neverwrap
74           Prevent po4a from wrapping lines.
75

STATUS OF THIS MODULE

77       Tested successfully on simple text files and NEWS.Debian files.
78

AUTHORS

80        Nicolas François <nicolas.francois@centraliens.net>
81

83        Copyright © 2005-2008 Nicolas FRANÇOIS <nicolas.francois@centraliens.net>.
84
85        Copyright © 2008-2009, 2018 Jonas Smedegaard <dr@jones.dk>.
86
87       This program is free software; you may redistribute it and/or modify it
88       under the terms of GPL (see the COPYING file).
89
90
91
92Po4a Tools                        2020-01-30           Locale::Po4a::Text(3pm)
Impressum