.\" 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 "PO4A-TRANSLATE 1p" .TH PO4A-TRANSLATE 1p "2018-12-09" "Herramientas de po4a" "Herramientas de po4a" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NOMBRE" .IX Header "NOMBRE" po4a\-translate \- Convierte un fichero \s-1PO\s0 al formato de la documentación .SH "SINOPSIS" .IX Header "SINOPSIS" \&\fBpo4a\-translate\fR \fB\-f\fR \fIformato\fR \fB\-m\fR \fIoriginal.doc\fR \fB\-p\fR \fI\s-1XX\s0.po\fR \&\fB\-l\fR \fI\s-1XX\s0.doc\fR .PP (\fI\s-1XX\s0.doc\fR es la salida, todos los otros son entrada) .SH "DESCRIPCIÓN" .IX Header "DESCRIPCIÓN" El objetivo del proyecto po4a («PO for anything», \s-1PO\s0 para todo) es facilitar la traducción (y más interesante, el mantenimiento de las traducciones) usando las herramientas de gettext en ámbitos dónde no previstos, como la documentación. .PP El script \fBpo4a\-translate\fR se encarga de convertir la traducción (que se hizo en un fichero \s-1PO\s0) de vuelta al formato de la documentación. El fichero \&\s-1PO\s0 proporcionado debe ser la traducción del fichero \s-1POT\s0 que se produjo con \&\fI\f(BIpo4a\-gettextize\fI\|(1)\fR. .SH "OPCIONES" .IX Header "OPCIONES" .IP "\fB\-f\fR, \fB\-\-format\fR" 4 .IX Item "-f, --format" El formato de la documentación que desea tratar. Use la opción \&\fB\-\-help\-format\fR para ver la lista de los formatos disponibles. .IP "\fB\-a\fR, \fB\-\-addendum\fR" 4 .IX Item "-a, --addendum" Añade un fichero al fichero resultante (para poner el nombre del traductor o una sección «Acerca de esta traducción», por ejemplo). La primera línea del fichero a insertar debe ser la cabecera \s-1PO4A\s0 indicando dónde se debe insertar (consulte la sección \fBCómo añadir texto adicional a las traducciones\fR en \fBpo4a\fR\|(7)). .IP "\fB\-A\fR, \fB\-\-addendum\-charset\fR" 4 .IX Item "-A, --addendum-charset" El juego de caracteres del apéndice. Todos los apéndices deben usar el mismo juego de caracteres. .IP "\fB\-m\fR, \fB\-\-master\fR" 4 .IX Item "-m, --master" El fichero que contiene el documento original a traducir. .IP "\fB\-M\fR, \fB\-\-master\-charset\fR" 4 .IX Item "-M, --master-charset" El juego de caracteres del fichero que contiene el documento a traducir. .IP "\fB\-l\fR, \fB\-\-localized\fR" 4 .IX Item "-l, --localized" El fichero donde se debe escribir el documento localizado (traducido). .IP "\fB\-L\fR, \fB\-\-localized\-charset\fR" 4 .IX Item "-L, --localized-charset" El juego de caracteres del fichero que contiene la versión localizada del documento. .IP "\fB\-p\fR, \fB\-\-po\fR" 4 .IX Item "-p, --po" El fichero del que se debe leer el catálogo de mensajes. .IP "\fB\-o\fR, \fB\-\-option\fR" 4 .IX Item "-o, --option" Opción(es) adicionales a introducir a la extensión del formato. Especifique cada opción con el formato «\fInombre\fR\fB=\fR\fIvalor\fR». Consulte la documentación de cada extensión para más información acerca de las opciones aceptadas y su significado. .IP "\fB\-k\fR, \fB\-\-keep\fR" 4 .IX Item "-k, --keep" El umbral mínimo del porcentaje de traducción para preservar (es decir, escribir) el fichero resultante (predefinido: 80). Es decir, por omisión los ficheros deben estar traducidos como mínimo en un 80% para que se escriba el fichero resultante. .IP "\fB\-w\fR, \fB\-\-width\fR" 4 .IX Item "-w, --width" La columna en la que se debe justificar el fichero resultante. .IP "\fB\-h\fR, \fB\-\-help\fR" 4 .IX Item "-h, --help" Muestra un mensaje corto de ayuda. .IP "\fB\-\-help\-format\fR" 4 .IX Item "--help-format" Lista los formatos de documentación reconocidos por po4a. .IP "\fB\-V\fR, \fB\-\-version\fR" 4 .IX Item "-V, --version" Muestra la versión del script y cierra .IP "\fB\-v\fR, \fB\-\-verbose\fR" 4 .IX Item "-v, --verbose" Aumenta la cantidad de mensajes informativos del programa. .IP "\fB\-d\fR, \fB\-\-debug\fR" 4 .IX Item "-d, --debug" Devuelve por la salida información de depuración de fallos. .SH "Añadir contenido (aparte de las traducciones) a los ficheros generados" .IX Header "Añadir contenido (aparte de las traducciones) a los ficheros generados" Para añadir algún contenido adicional al documento generado además de lo traducido (como el nombre del traductor, o una sección «Sobre ésta traducción»), debe usar la opción \fB\-\-addendum\fR. .PP La primera línea de un apéndice («addendum») debe ser una cabecera indicando en qué parte del documento se debe insertar (puede ser antes o después de una parte del documento). El resto del fichero se insertará tal cual al fichero resultante sin ningún procesado adicional. .PP Tenga en cuenta que si po4a\-translate no puede añadir uno de los ficheros dados, descarta la traducción entera (porque el fichero que falta puede ser el que contenía los datos del autor, lo que impediría a los usuarios contactar con él para informarle de errores en la traducción). .PP La cabecera tiene una sintaxis bastante rígida. Para más información sobre cómo usar esta característica y su funcionamiento, consulte la página de manual \fBpo4a\fR\|(7). .SH "VÉASE TAMBIÉN" .IX Header "VÉASE TAMBIÉN" \&\fBpo4a\-gettextize\fR\|(1), \fBpo4a\-normalize\fR\|(1), \fBpo4a\-updatepo\fR\|(1), \fBpo4a\fR\|(7) .SH "AUTORES" .IX Header "AUTORES" .Vb 3 \& Denis Barbier \& Nicolas François \& Martin Quinson (mquinson#debian.org) .Ve .SH "TRADUCCION" .IX Header "TRADUCCION" .Vb 2 \& Jordi Vilalta \& Omar Campagne .Ve .SH "DERECHO DE COPIA Y LICENCIA" .IX Header "DERECHO DE COPIA Y LICENCIA" Copyright 2002\-2012 by \s-1SPI,\s0 inc. .PP Esto es software libre; puede redistribuirlo y/o modificarlo bajo las condiciones de la licencia \s-1GPL\s0 (consulte el fichero \s-1COPYING\s0).