.\" -*- 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 "LOCALE::PO4A::DOCBOOK.3PM 1" .TH LOCALE::PO4A::DOCBOOK.3PM 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" Locale::Po4a::Docbook \- converte documentos DocBook XML de/para arquivos PO .SH DESCRIÇÃO .IX Header "DESCRIÇÃO" O objetivo do projeto po4a (PO for anything, ou PO para qualquer coisa) é facilitar traduções (e o mais interessante, a manutenção das traduções) usando as ferramentas do gettext em áreas em que não se esperava, como documentação. .PP Locale::Po4a::Docbook é um módulo para ajudar a tradução de documentos DocBook XML em outros idiomas. .SH "ESTADO DESTE MÓDULO" .IX Header "ESTADO DESTE MÓDULO" Este módulo é completamente funcional, pois depende do módulo Locale::Po4a::Xml. Este apenas define as marcações e atributos traduzíveis. .PP O único problema conhecido é que ele não lida com entidades ainda e isso inclui as entidades de inclusão de arquivo, mas você pode traduzir a maioria daqueles arquivos sozinhos (exceto os arquivos de entidades comuns) e normalmente é melhor mantê\-los separadamente. .SH "SUBSTITUIÇÃO DO COMPORTAMENTO PADRÃO COM AS OPÇÕES DE LINHA DE COMANDO" .IX Header "SUBSTITUIÇÃO DO COMPORTAMENTO PADRÃO COM AS OPÇÕES DE LINHA DE COMANDO" O comportamento padrão dos módulos fornecidos pelo sistema é configurado para estar no lado seguro. .PP Por exemplo, o padrão da tag \fB\fR está apontando para aparecer em \fB\fR. Mas você pode estar usando apenas em \fB\fR. Para este caso, você pode querer traduzi-lo independentemente para cada autor. .PP Se você não gostar do comportamento padrão do módulo xml e seus módulos derivados, poderá fornecer opções de linha de comando para alterar seu comportamento. Por exemplo, você pode adicionar o seguinte ao arquivo de configuração po4a: .PP .Vb 4 \& opt:"\-k 0 \-o nodefault=\e" \e" \e \& \-o break=\e" \e" \e \& \-o untranslated=\e"\e" \e \& \-o translated=\e"\e"" .Ve .PP Isso substitui o comportamento padrão para \fB\fR e \fB\fR, define \fB\fR e \fB\fR para interromper o fluxo de dados de entrada nesses tags , define \fB\fR para não traduzir seu conteúdo marcado e defina \fB\fR para traduzir seu conteúdo marcado. .SH "VEJA TAMBÉM" .IX Header "VEJA TAMBÉM" \&\fBLocale::Po4a::TransTractor\fR\|(3pm), \fBLocale::Po4a::Xml\fR\|(3pm), \fBpo4a\fR\|(7) .SH AUTORES .IX Header "AUTORES" .Vb 1 \& Jordi Vilalta .Ve .SH "COPYRIGHT E LICENÇA" .IX Header "COPYRIGHT E LICENÇA" .Vb 2 \& Copyright © 2004 Jordi Vilalta \& Copyright © 2007\-2009 Nicolas François .Ve .PP Esse programa é um software livre; você pode redistribuí\-lo e/ou modificá\-lo sob os termos da GPL v2.0 ou posterior (veja o arquivo COPYING).