locale::po4a::text(3) [centos man page]

Locale::Po4a::Text(3)					User Contributed Perl Documentation				     Locale::Po4a::Text(3)

NAME

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

DESCRIPTION

       The po4a (PO 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.

       Locale::Po4a::Text is a module to help the translation of text documents into other [human] languages.

       Paragraphs are split on empty lines (or lines containing only spaces or tabulations).

       If a paragraph contains a line starting by a space (or tabulation), this paragraph won't be rewrapped.

OPTIONS ACCEPTED BY THIS MODULE

       These are this module's particular options:

       nobullets
	   Deactivate detection of bullets.

	   By default, when a bullet is detected, the bullet paragraph is not considered as a verbatim paragraph (with the no-wrap flag in the PO
	   file), but the module rewraps this paragraph in the generated PO file and in the translation.

       tabs=mode
	   Specify how tabulations shall be handled. The mode can be any of:

	   split
	       Lines with tabulations introduce breaks in the current paragraph.

	   verbatim
	       Paragraph containing tabulations will not be re-wrapped.

	   By default, tabulations are considered as spaces.

       breaks=regex
	   A regular expression matching lines which introduce breaks.	The regular expression will be anchored so that the whole line must match.

       debianchangelog
	   Handle the header and footer of released versions, which only contain non translatable informations.

       fortunes
	   Handle the fortunes format, which separate fortunes with a line which consists in '%' or '%%', and use '%%' as the beginning of a
	   comment.

       markdown
	   Handle some special markup in Markdown-formatted texts.

       asciidoc
	   Handle documents in the AsciiDoc format.

       control[=taglist]
	   Handle control files.  A comma-separated list of tags to be translated can be provided.

STATUS OF THIS MODULE

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

AUTHORS

	Nicolas Francois <nicolas.francois@centraliens.net>

COPYRIGHT AND LICENSE

	Copyright 2005-2008 by Nicolas FRANCOIS <nicolas.francois@centraliens.net>.

       This program is free software; you may redistribute it and/or modify it under the terms of GPL (see the COPYING file).

perl v5.16.3							    2014-06-10						     Locale::Po4a::Text(3)

Check Out this Related Man Page

PO4A-NORMALIZE(1p)						    Po4a Tools							PO4A-NORMALIZE(1p)

NAME

       po4a-normalize - normalize a documentation file by parsing it in po4a, and writing it back

SYNOPSIS

       po4a-normalize -f fmt master.doc

DESCRIPTION

       The po4a (PO 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.

       The po4a-normalize script is a debugging tool used to make sure that po4a don't change the document when it's not supposed to. Only use it
       if you're developing a new module, or if you doubt the sanity of the tools.

       The generated document will be written to po4a-normalize.output while the generated PO file will be written to po4a-normalize.po. No way to
       change that ;)

OPTIONS

       -o, --option
	   Extra option(s) to pass to the format plugin. Specify each option in the 'name=value' format. See the documentation of each plugin for
	   more information about the valid options and their meanings.

       -b, --blank
	   Create an blank translated document.  The generated translated document will be generated assuming all messages are translated by a
	   space or new line.

	   This is useful to check what parts of the document cannot be translated.

       -h, --help
	   Show a short help message.

       --help-format
	   List the documentation formats understood by po4a.

       -f, --format
	   Format of the documentation you want to handle. Use the --help-format option to see the list of available formats.

       -M, --master-charset
	   Charset of the file containing the document to translate.

       -V, --version
	   Display the version of the script and exit.

SEE ALSO

       po4a-gettextize(1), po4a-translate(1), po4a-updatepo(1), po4a(7)

AUTHORS

	Denis Barbier <barbier@linuxfr.org>
	Nicolas Francois <nicolas.francois@centraliens.net>
	Martin Quinson (mquinson#debian.org)

COPYRIGHT AND LICENSE

       Copyright 2002-2012 by SPI, inc.

       This program is free software; you may redistribute it and/or modify it under the terms of GPL (see the COPYING file).

Po4a Tools							    2014-06-10							PO4A-NORMALIZE(1p)

Linux and UNIX Man Pages

locale::po4a::text(3) [centos man page]

Check Out this Related Man Page