.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43) .\" .\" 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 .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . 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 1" .TH PO4A-TRANSLATE.1P 1 2024-06-26 "perl v5.38.2" "User Contributed Perl Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH NOME .IX Header "NOME" po4a\-translate \- converter um ficheiro PO de volta ao formato de documentação .SH SINOPSE .IX Header "SINOPSE" \&\fBpo4a\-translate\fR \fB\-f\fR \fIfmt\fR \fB\-m\fR \fImaster.doc\fR \fB\-p\fR \fIXX.po\fR \fB\-l\fR \fIXX.doc\fR .PP (\fIXX.doc\fR é a saída, todos os outros são entradas) .SH DESCRIÇÃO .IX Header "DESCRIÇÃO" O objetivo do projeto po4a (PO for anything: PO para qualquer coisa) é facilitar traduções (e o mais interessante, a manutenção das traduções) a usar as ferramentas do gettext em áreas em que não se esperava, como na documentação. .PP O script \fBpo4a\-translate\fR é responsável por converter a tradução (que foi feita num ficheiro PO) de volta para o formato de documentação. O ficheiro PO fornecido deverá ser a tradução do ficheiro POT que foiproduzido por \fBpo4a\-gettextize\fR\|(1). .SH OPÇÕES .IX Header "OPÇÕES" .IP "\fB\-f\fR, \fB\-\-format\fR" 4 .IX Item "-f, --format" O formato da documentação que pretende processar. Use a opção \fB\-\-help\-format\fR para ver a lista de formatos disponíveis. .IP "\fB\-a\fR, \fB\-\-addendum\fR" 4 .IX Item "-a, --addendum" Adicionar um ficheiro ao ficheiro resultante (para pôr o nome do tradutor ou uma secção "Sobre esta tradução", por exemplo). A primeira linha do ficheiro para inserção deve ser um cabeçalho PO4A a indicar onde ele deve ser adicionado (ver secção \fBCOMO adicionar texto extra para traduções\fR em \fBpo4a\fR\|(7)). .IP "\fB\-A\fR, \fB\-\-addendum\-charset\fR" 4 .IX Item "-A, --addendum-charset" Conjunto de carateres da adenda. Note-se que todas as adendas devem estar no mesmo conjnto de carateres. .IP "\fB\-m\fR, \fB\-\-master\fR" 4 .IX Item "-m, --master" Ficheiro a conter o documento principal para traduzir. .IP "\fB\-M\fR, \fB\-\-master\-charset\fR" 4 .IX Item "-M, --master-charset" Conjunto de carateres do ficheiro que contém o documento a traduzir. .IP "\fB\-l\fR, \fB\-\-localized\fR" 4 .IX Item "-l, --localized" Ficheiro onde o documento localizado (traduzido) deve ser escrito. .IP "\fB\-L\fR, \fB\-\-localized\-charset\fR" 4 .IX Item "-L, --localized-charset" Conjunto de carateres do ficheiro que contém o documento localizado. .IP "\fB\-p\fR, \fB\-\-po\fR" 4 .IX Item "-p, --po" Ficheiro a partir do qual o catálogo de mensagens deve ser lido. .IP "\fB\-o\fR, \fB\-\-option\fR" 4 .IX Item "-o, --option" Opção/ções adicional/ais para passar ao plugin de formato. Veja a documentação de cada plugin para mais informações sobre as opções válidas e os significados deles. Por exemplo, poderia passar '\-o tablecells' para o analisador AsciiDoc, enquanto o analisador de texto aceitaria '\-o tabs=split'. .IP "\fB\-k\fR, \fB\-\-keep\fR" 4 .IX Item "-k, --keep" Limite mínimo de percentagem de tradução para manter (p.ex. escrever) o ficheiro resultante (predefinição: 80). P.ex. por predefinição, ficheiros têm que ser traduzido a pelo menos 80% para serem escritos. .IP "\fB\-w\fR, \fB\-\-width\fR" 4 .IX Item "-w, --width" Column at which we should wrap the resulting file if the format supports it (default: 76). .IP "\fB\-h\fR, \fB\-\-help\fR" 4 .IX Item "-h, --help" Mostrar uma pequena mensagem de ajuda. .IP \fB\-\-help\-format\fR 4 .IX Item "--help-format" Lista os formatos de documentação compreendidos por po4a. .IP "\fB\-V\fR, \fB\-\-version\fR" 4 .IX Item "-V, --version" Mostrar a versão do script e sair. .IP "\fB\-v\fR, \fB\-\-verbose\fR" 4 .IX Item "-v, --verbose" Aumentar o detalhe do programa. .IP "\fB\-d\fR, \fB\-\-debug\fR" 4 .IX Item "-d, --debug" Saída de alguma informação de depuração. .IP "\fB\-\-porefs\fR \fItype\fR[,\fBwrap\fR|\fBnowrap\fR]" 4 .IX Item "--porefs type[,wrap|nowrap]" Especifica o formato de referência. O argumento \fItipo\fR pode ser um de: \fBnever\fR para não produzir qualquer referência, \fBfile\fR para especificar o ficheiro sem o número da linha, \fBcounter\fR para substituir os números de linha a aumentar o contador e \fBfull\fR para incluir referências completas. (predefinição: full). .Sp O argumento pode ser seguido por uma vírgula ou pela palavra-chave \fBwrap\fR ou \fBnowrap\fR. Referências são escritas por predefinição numa única linha. A opção \fBwrap\fR envolve referências sobre várias linhas, para imitar as ferramentas \fBgettext\fR (\fBxgettext\fR e \fBmsgmerge\fR). Esta opção irá tornar-se a predefinição num lançamento futuro, porque é mais sensível. A opção \fBnowrap\fR é acessível aos utilizadores que querem manter o comportamento antigo. .SH "A adição de conteúdo (ao lado das traduções) para ficheiros gerados" .IX Header "A adição de conteúdo (ao lado das traduções) para ficheiros gerados" Para adicionar algum conteúdo extra ao documento gerado além do que traduziu (como o nome do tradutor ou uma secção "Sobre essa tradução"), deveria usar a opção \fB\-\-addendum\fR. .PP A primeira linha da adenda deve ser um cabeçalho a indicar onde colocá\-lo no documento (que pode ser antes ou depois de uma determinada parte do documento). O resto do ficheiro será adicionado na íntegra para o ficheiro resultante sem processamento posterior. .PP Note que se po4a\-translate não conseguir adicionar um dos ficheiros dados, ele descarta toda a tradução (porque o ficheiro que falta poderia ser o que indica o autor, o que impediria aos utilizadores o contato com ele para relatar erros na tradução). .PP O cabeçalho tem uma sintaxe bastante rígida. Para mais informações sobre como usar esse recurso e como ele funciona, consulte a página do manual \fBpo4a\fR\|(7). .SH "VER TAMBÉM" .IX Header "VER TAMBÉM" \&\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 "DIREITOS DE AUTOR E LICENÇA" .IX Header "DIREITOS DE AUTOR E LICENÇA" Copyright 2002\-2023 by SPI, inc. .PP This program is free software; you may redistribute it and/or modify it under the terms of GPL v2.0 or later (see the COPYING file).