po4av0.55

Locale::Po4a::AsciiDoc

Section: Po4a Tools (3pm)
Updated: 2018-12-10
Index Return to Main Contents
 

NOM

Locale::Po4a::AsciiDoc - convert AsciiDoc documents from/to PO files  

DESCRIPCIÓ

L'objectiu del projecte po4a (PO per a tot) és facilitar la traducció (i sobretot el manteniment de les traduccions) utilitzant les eines de gettext en àrees on no eren d'esperar, com ara en la documentació.

Locale::Po4a::AsciiDoc is a module to help the translation of documentation in the AsciiDoc format.  

OPCIONS QUE ACCEPTA AQUEST MÒDUL

Aquestes són les opcions particulars d'aquest mòdul:
definitions
The name of a file containing definitions for po4a, as defined in the INLINE CUSTOMIZATION section. You can use this option if it is not possible to put the definitions in the document being translated.

In a definitions file, lines must not start by two slashes, but directly by po4a:.

entry
Space-separated list of attribute entries you want to translate. By default, no attribute entries are translatable.
macro
Space-separated list of macro definitions.
style
Space-separated list of style definitions.
noimagetargets
By default, the targets of block images are translatable to give opportunity to make the content point to translated images. This can be stopped by setting this option.
 

PERSONALITZACIÓ INCRUSTADA

The AsciiDoc module can be customized with lines starting by //po4a:. These lines are interpreted as commands to the parser. The following commands are recognized:
//po4a: macro name[attribute list]
This permits to describe in detail the parameters of a macro; name must be a valid macro name, and it ends with an underscore if the target must be translated.

The attribute list argument is a comma separated list which contains informations about translatable arguments. This list contains either numbers, to define positional parameters, or named attributes.

If a plus sign (+) is prepended to name, then the macro and its arguments are translated as a whole. There is no need to define attribute list in this case, but brackets must be present.

//po4a: style [attribute list]
This permits to describe in detail which attributes of a style must be translated.

The attribute list argument is a comma separated list which contains informations about translatable arguments. This list contains either numbers, to define positional parameters, or named attributes. The first attribute is the style name, it will not be translated.

If a plus sign (+) is prepended to the style name, then the attribute list is translated as a whole. There is no need to define translatable attributes.

If a minus sign (-) is prepended to the style name, then this attribute is not translated.

//po4a: entry name
This declares an attribute entry as being translatable. By default, they are not translated.
 

ESTAT D'AQUEST MÒDUL

Tested successfully on simple AsciiDoc files.  

AUTORS

 Nicolas François <nicolas.francois@centraliens.net>
 Denis Barbier <barbier@linuxfr.org>

 

TRADUCCIÓ

 Carme Cirera <menxu@hotmail.com>
 Jordi Vilalta <jvprat@gmail.com>

 

DRET DE CÒPIA I LLICÈNCIA

 Copyright © 2005-2008 Nicolas FRANÇOIS <nicolas.francois@centraliens.net>.
 Copyright © 2012 Denis BARBIER <barbier@linuxfr.org>.
 Copyright © 2017 Martin Quinson <mquinson#debian.org>.

Aquest programa és programari lliure; podeu redistribuir-lo i/o modificar-lo sota els termes de la GPL (consulteu el fitxer COPYING).


 

Index

NOM
DESCRIPCIÓ
OPCIONS QUE ACCEPTA AQUEST MÒDUL
PERSONALITZACIÓ INCRUSTADA
ESTAT D'AQUEST MÒDUL
AUTORS
TRADUCCIÓ
DRET DE CÒPIA I LLICÈNCIA

This document was created by using the manual pages.
Time: 11:07:05 GMT, December 10, 2018
català Deutsch English español français Italiano 日本語 Bokmål polski Português Português (Brasil) Русский український 简体中文 (how to set the default document language)