NOME¶

Locale::Po4a::Xml - converte documentos XML e derivados de/para ficheiros PO

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.

Locale::Po4a::Xml é um módulo para ajudar a tradução de documentos XML em outro idioma [humano]. Também pode ser usado como uma base para a construção de módulos de documentos com base em XML.

TRADUZIR COM PO4A::XML¶

Este módulo pode ser usado diretamente para lidar com documentos XML genéricos. Isto irá extrair todo o conteúdo das etiquetas e, não atributos, já que é onde o texto é escrito na maioria dos documentos com base XML.

Existem algumas opções (descrito na próxima secção), que podem personalizar este comportamento. Se isto não se encaixa no seu formato de documento que está encorajado a escrever o seu próprio módulo derivado deste, para descrever os detalhes do seu formato. Consulte a secção WRITING DERIVATE MODULES abaixo, para descrição do processo.

OPÇÕES ACEITES POR ESTE MÓDULO¶

A opção de depuração global faz com que este módulo mostre as cadeia excluídas, para ver se ele ignora algo importante.

Estas são as opções particulares deste módulo:

nostrip

Impede-o para tirar os espaços em torno das cadeias extraídas.

wrap

Canoniza a cadeia para traduzir, a considerar que espaços em branco não são importantes e dimensiona o documento traduzido. Essa opção pode ser sobrescrita por opções personalizadas de marcação. Veja a opção translated abaixo.

unwrap_attributes

Atributos são quebrados por predefinição. Essa opção desativa a quebra.

caseinsensitive

Faz as etiquetas e atributos a procurar trabalhar de forma em maiúsculas e minúsculas. Se for definido, ele vai tratar <BooKe<gt>laNG e <BOOK>Lang como <book>lang.

escapequotes

Aspas de escapa em cadeias de saída. Necessário, por exemplo, para criação de recursos de cadeias para usar por ferramentas de compilação de Android.

Veja também: https://developer.android.com/guide/topics/resources/string-resource.html

includeexternal

Quando definido, entidades externas estão incluídas no documento gerado (traduzido) e para a extração de cadeias. Se não for definido, vai ter que traduzir entidades externas separadamente como documentos independentes.

ontagerror

Esta opção define o comportamento do módulo quando ele encontrar uma sintaxe de XML inválida (uma etiqueta de fecho, que não coincide com a última etiqueta de abertura). Ele pode ter os seguintes valores:

tagsonly

Nota: Esta opção está obsoleta.

Extrai apenas as etiquetas especificados na opção "tags". Caso contrário, ele irá extrair todas as marcas, exceto os especificados.

doctype

A cadeias que vai tentar combinar com a primeira linha do doctype do documento (se definido). Se isso não acontecer, um aviso indicará que o documento poderá ser de um tipo incorreto.

addlang

A cadeia a indicar o caminho (por exemplo, <bbb><AAA>) de uma etiqueta onde um atributo lang="..." deve ser adicionado. O idioma será definido como o nome base do ficheiro PO sem qualquer extensão po.

optionalclosingtag

Booleano a indicar se as marcações de fechamento são opcionais (como em HTML). Por predefinição, as marcações de fechamento ausentes geram um erro tratado de acordo com "ontagerror".

tags

Nota: Esta opção está obsoleta. Deve usar as opções translated e untranslated em vez.

Lista de etiquetas separada por espaços que deseja traduzir ou ignorar. Por predefinição, as etiquetas especificadas serão excluídas, mas se usar a opção "tagsonly", etiquetas especificadas serão as únicas incluídas. As etiquetas devem estar em forma <aaa>, mas podem-se juntar a algum (<bbb><aaa>) para dizer que o conteúdo da etiqueta <aaa> só será traduzido quando está numaetiqueta <bbb>.

Também pode especificar algumas opções de etiquetas, a por alguns carácteres em frente da hierarquia de etiquetas. Por exemplo, pode pôr 'w' (wrap) ou 'W' (don't wrap) para substituir o comportamento predefinido especificado pela opção global "wrap".

Exemplo: W<chapter><title>

attributes

Lista de atributos das etiquetas separada por espaços que deseja traduzir. Pode especificar os atributos pelo nome deles (por exemplo, "lang"), mas pode prefixar com uma hierarquia de etiquetas, para especificar que este atributo só será traduzido quando está na etiqueta especificada. Por exemplo:<bbb><aaa>lang especifica que o atributo lang só será traduzido se for em numa etiqueta <aaa> e é numa etiqueta <bbb>.

foldattributes

Não traduzir atributos em etiquetas em linha. Vez disso, substitua todos os atributos duma etiqueta por po4a-id=<id>.

Isto é útil quando atributos não serão traduzidas, como isso simplifica as cadeias para tradutores e evita erros de digitação.

customtag

lista de etiquietas separadas por espaços que não deviam ser tratadas como etiquetas. Estas etiquetas são tradadas com em linha e, não precisam de ser fechadas.

break

Lisat de etiquetas separada por espaços que devem quebrar a sequência. Por predefinição, todas as etiquetas quebrar a sequência.

As etiquetas devem estar na forma <aaa>, mas pode juntar algumas (<bbb><aaa>), se uma etiqueta (<aaa>) só deveria ser considerada quando está em outra etiqueta (<bbb>).

Note que uma marcação deve ser listada em apenas uma cadeia de configuração de break, inline placeholder ou customtag.

inline

Lista de etiquetas separada por espaços que devem ser tratados como em linha. Por predefinição todas as etiquetas quebram a sequência.

As etiquetas devem estar na forma <aaa>, mas pode juntar algumas (<bbb><aaa>), se uma etiqueta (<aaa>) só deveria ser considerada quando está em outra etiqueta (<bbb>).

placeholder

Lista de etiquetas separadas por espaços que devem ser tratadas como espaços reservados. Os espaços reservados não quebram a sequência, mas o conteúdo dos espaços reservados é traduzido separadamente.

A localização do espaço reservado no bloco dele será marcado com uma cadeia semelhante a:

  <placeholder type=\"footnote\" id=\"0\"/>
    

As etiquetas devem estar na forma <aaa>, mas pode juntar algumas (<bbb><aaa>), se uma etiqueta (<aaa>) só deveria ser considerada quando está em outra etiqueta (<bbb>).

break-pi

Por predefinição, as Instruções de Processamento (ou seja, marcações "<? ... ?">) são tratadas como marcações embutidas. Passe essa opção se desejar que as I.P. sejam tratadas como marcação de quebra. Note que marcações PHP não processadas são tratadas como Instruções de Processamento pelo analisador.

nodefault

lista de etiquetas separadas por espaço que o módulo não deve tentar definir por predefinição em qualquer categoria.

Se tiver uma marcação que tenha a configuração predefinida dela pela subclasse deste módulo, mas desejar definir uma configuração alternativa, será necessário listar essa marcação como parte da cadeia de configuração nodefault.

cpp

Diretivas de suporte do pré-processador C. Quando esta opção está definida, po4a irá considerar as diretivas de pré-processamento como separadores de parágrafo. Isso é importante se o ficheiro XML deve ser processado, porque senão as directivas podem ser inseridas no meio de linhas se o po4a considerar que pertencem ao parágrafo corrente, que não será reconhecido pelo pré-processador. Nota: as directivas de pré-processamento só devem aparecer entre etiquetas (que não deve quebrar uma etiqueta).

translated

Listas de etiquetas separadas por espaços que quer traduzir.

As etiquetas devem estar na forma <aaa>, mas pode juntar algumas (<bbb><aaa>), se uma etiqueta (<aaa>) só deveria ser considerada quando está em outra etiqueta (<bbb>).

Também pode especificar algumas opções de marcação para por alguns caracteres na frente da hierarquia de marcações. Isso sobrescreve o comportamento predefinido especificado pelas opções globais wrap e defaulttranslateoption.

  * Tags listadas em B<break> são definidas para I<w> ou I<W> a depender da opção <wrap>.
  * Tags listadas em B<inline> são definidas para I<i>.
  * Tags listadas em B<placeholder> são definidas para I<p>.
  * Tags listadas em B<untranslated> não são definidas com nenhuma dessas opções.

untranslated

Listas de etiquetas separadas por espaços que não quer traduzir.

As etiquetas devem estar na forma <aaa>, mas pode juntar algumas (<bbb><aaa>), se uma etiqueta (<aaa>) só deveria ser considerada quando está em outra etiqueta (<bbb>).

Note que uma marcação inline traduzível numa marcação não traduzida é tratada como uma marcação de quebra traduzível, a configuração i é descartada e w ou W é definida a depender da opção <wrap>.

defaulttranslateoption

As categorias predefinidas para etiquetas que não são nenhuns de: traduzidos, não traduzidos, partidos, em linha ou espaço reservado.

Este é um conjunto de letras, conforme definido em translated e essa configuração é válida apenas para tags traduzíveis.

ESCREVENDO MÓDULOS DERIVADOS¶

  $self->{options}{'new_option'}='';
  $self->SUPER::initialize(%options);
  $self->{options}{'_default_translated'}.=' <p> <head><title>';
  $self->{options}{'attributes'}.=' <p>lang id';
  $self->{options}{'_default_inline'}.=' <br>';
  $self->treat_options;

  sub found_string {
    my ($self,$text,$ref,$options)=@_;
    $text = $self->translate($text,$ref,"type ".$options->{'type'},
      'wrap'=>$self->{options}{'wrap'});
    return $text;
  }

FUNÇÕES INTERNAS usadas para escrever analisadores derivados¶

ESTADO DESTE MÓDULO¶

Este módulo pode traduzir etiquetas e atributos.

LISTA PARAFAZER¶

DOCTYPE (ENTITIES)

Há um suporte mínimo para a tradução de entidades. Elas são traduzida como um todo e as etiquetas não são tidas em conta. As entidades multi linhas não são suportados e as entidades são sempre re-envolvidas durante a tradução.

MODIFICAR TIPOS DE ETIQUETAS A PARTIR DE MÓDULOS HERDADOS (move a estrutura tag_types dentro de hash $self hash?)

VER TAMBÉM¶

Locale::Po4a::TransTractor(3pm), po4a(7)

AUTORES¶

 Jordi Vilalta <jvprat@gmail.com>
 Nicolas François <nicolas.francois@centraliens.net>

DIREITOS DE AUTOR E LICENÇA¶

 Copyright © 2004 Jordi Vilalta  <jvprat@gmail.com>
 Copyright © 2008-2009 Nicolas François <nicolas.francois@centraliens.net>

Este programa é software livre, pode redistribuí-lo e/ou modificá-lo sob os termos da GPL (consulte o ficheiro CÓPIA).