GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  LOCALE::PO4A::TEXT.PM (3)

.ds Aq ’

NAME

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

CONTENTS

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:
<B>nobulletsB> 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.

<B>tabs=B>mode Specify how tabulations shall be handled. The mode can be any of:
<B>splitB> Lines with tabulations introduce breaks in the current paragraph.
<B>verbatimB> Paragraph containing tabulations will not be re-wrapped.

By default, tabulations are considered as spaces.

<B>breaks=B>regex A regular expression matching lines which introduce breaks. The regular expression will be anchored so that the whole line must match.
<B>debianchangelogB> Handle the header and footer of released versions, which only contain non translatable informations.
<B>fortunesB> Handle the fortunes format, which separate fortunes with a line which consists in ’%’ or ’%%’, and use ’%%’ as the beginning of a comment.
<B>markdownB> Handle some special markup in Markdown-formatted texts.
<B>asciidocB> Handle documents in the AsciiDoc format.
<B>controlB>[<B>=B>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 François <nicolas.francois@centraliens.net>



COPYRIGHT AND LICENSE



 Copyright 2005-2008 by Nicolas FRANÇOIS <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).

Search for    or go to Top of page |  Section 3 |  Main Index


Po4a Tools LOCALE::PO4A::TEXT.PM (3pm) 2016-04-03

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.