.\" Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "Locale::Po4a::Text 3pm" .TH Locale::Po4a::Text 3pm "2020-08-19" "Po4a Tools" "Po4a Tools" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" Locale::Po4a::Text \- convert text documents from/to PO files .SH "DESCRIPTION" .IX Header "DESCRIPTION" The po4a (\s-1PO\s0 for anything) project goal is to ease translations (and more interestingly, the maintenance of translations) using gettext tools on areas where they were not expected like documentation. .PP Locale::Po4a::Text is a module to help the translation of text documents into other [human] languages. .PP Paragraphs are split on empty lines (or lines containing only spaces or tabulations). .PP If a paragraph contains a line starting by a space (or tabulation), this paragraph won't be rewrapped. .SH "OPTIONS ACCEPTED BY THIS MODULE" .IX Header "OPTIONS ACCEPTED BY THIS MODULE" These are this module's particular options: .IP "\fBkeyvalue\fR" 4 .IX Item "keyvalue" Treat paragraphs that look like a key value pair as verbatim (with the no-wrap flag in the \s-1PO\s0 file). Key value pairs are defined as a line containing one or more non-colon and non-space characters followed by a colon followed by at least one non-space character before the end of the line. .IP "\fBnobullets\fR" 4 .IX Item "nobullets" Deactivate the detection of bullets. .Sp By default, when a bullet is detected, the bullet paragraph is not considered as a verbatim paragraph (with the no-wrap flag in the \s-1PO\s0 file). Instead, the corresponding paragraph is rewrapped in the translation. .IP "\fBtabs=\fR\fImode\fR" 4 .IX Item "tabs=mode" Specify how tabulations shall be handled. The \fImode\fR can be any of: .RS 4 .IP "\fBsplit\fR" 4 .IX Item "split" Lines with tabulations introduce breaks in the current paragraph. .IP "\fBverbatim\fR" 4 .IX Item "verbatim" Paragraph containing tabulations will not be re-wrapped. .RE .RS 4 .Sp By default, tabulations are considered as spaces. .RE .IP "\fBbreaks=\fR\fIregex\fR" 4 .IX Item "breaks=regex" A regular expression matching lines which introduce breaks. The regular expression will be anchored so that the whole line must match. .IP "\fBdebianchangelog\fR" 4 .IX Item "debianchangelog" Handle the header and footer of released versions, which only contain non translatable informations. .IP "\fBfortunes\fR" 4 .IX Item "fortunes" Handle the fortunes format, which separate fortunes with a line which consists in '%' or '%%', and use '%%' as the beginning of a comment. .IP "\fBmarkdown\fR" 4 .IX Item "markdown" Handle some special markup in Markdown-formatted texts. .IP "\fByfm_keys\fR (markdown-only)" 4 .IX Item "yfm_keys (markdown-only)" Coma-separated list of keys to process for translation in the \s-1YAML\s0 Front Matter section. All other keys are skipped. Keys are matched with a case-insensitive match. Arrays values are always translated, unless the \fByfm_skip_array\fR option is provided. .IP "\fByfm_skip_array\fR (markdown-only)" 4 .IX Item "yfm_skip_array (markdown-only)" Do not translate array values in the \s-1YAML\s0 Front Matter section. .IP "\fBcontrol\fR[\fB=\fR\fItaglist\fR]" 4 .IX Item "control[=taglist]" Handle control files. A comma-separated list of tags to be translated can be provided. .IP "\fBneverwrap\fR" 4 .IX Item "neverwrap" Prevent po4a from wrapping any lines. This means that every content is handled verbatim, even simple paragraphs. .SH "STATUS OF THIS MODULE" .IX Header "STATUS OF THIS MODULE" Tested successfully on simple text files and \s-1NEWS\s0.Debian files. .SH "AUTHORS" .IX Header "AUTHORS" .Vb 1 \& Nicolas François .Ve .SH "COPYRIGHT AND LICENSE" .IX Header "COPYRIGHT AND LICENSE" .Vb 1 \& Copyright © 2005\-2008 Nicolas FRANÇOIS . \& \& Copyright © 2008\-2009, 2018 Jonas Smedegaard . \& Copyright © 2020 Martin Quinson . .Ve .PP This program is free software; you may redistribute it and/or modify it under the terms of \s-1GPL\s0 (see the \s-1COPYING\s0 file).