NOME¶

DESCRIÇÃ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¶

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¶

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

nostrip

Impede-o para tirar os espaços em torno das sequências extraídas.

wrap

Canonicalizes the string to translate, considering that whitespaces are not important, and wraps the translated document. This option can be overridden by custom tag options. See the translated option below.

unwrap_attributes

Attributes are wrapped by default. This option disables wrapping.

caseinsensitive

Faz as etiquetas e atributos procurando 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

Escape quotes in output strings. Necessary, for example, for creating string resources for use by Android build tools.

See also: 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 sequências. Se não for definido, você vaiter 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, ou um atributo de marca sem valor). 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 sequência 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 mau.

addlang

A sequência indicando 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.

tags

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

Lista de etiquetas separada por espaços que deseja traduzir ou ignorar. Por padrão, as etiquetas especificadas serão excluídas, mas se você 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 de que o conteúdo da etiqueta <aaa> só será traduzido quando está numaetiqueta <bbb>.

Você também pode especificar algumas opções de etiquetas, colocando alguns carateres em frente da hierarquia de etiquetas. Por exemplo, você pode colocar 'w' (wrap) ou 'W' (don't wrap) para substituir o comportamento padrão especificado pela opção global "wrap".

Exemplo: W<chapter><title>

attributes

Lista de atributos das etiquetas separada por espaços que deseja traduzir. Você pode especificar os atributos pelo nome deles (por exemplo, "lang"), mas você 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 etiquetas <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 sequências 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 padrão, todas as etiquetas quebrar a sequência.

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

Please note a tag should be listed in only one of the break, inline placeholder, or customtag setting string.

inline

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

As etiquetas devem estar na forma <aaa>, mas você 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 seu bloco será marcado com uma sequência semelhante a:

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

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

nodefault

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

If you have a tag which has its default setting by the subclass of this module but you want to set alternative setting, you need to list that tag as a part of the nodefault setting string.

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 você pode juntar algumas (<bbb><aaa>), se uma etiqueta(<aaa>) só deveria ser considerada quando está em outra etiqueta(<bbb>).

You can also specify some tag options by putting some characters in front of the tag hierarchy. This overrides the default behavior specified by the global wrap and defaulttranslateoption option.

  * Tags listed in B<break> are set to I<w> or I<W> depending on the <wrap> option.
  * Tags listed in B<inline> are set to I<i>.
  * Tags listed in B<placeholder> are set to I<p>.
  * Tags listed in B<untranslated> are without any of these options set.

untranslated

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

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

Please note a translatable inline tag in an untranslated tag is treated as a translatable breaking tag, i setting is dropped and w or W is set depending on the <wrap> option.

defaulttranslateoption

As categorias padrão para etiquetas que não estão em nenhum dos traduzidosnão traduzidos, partidos, em linha, ou espaço reservado.

This is a set of letters as defined in translated and this setting is only valid for translatable tags.

WRITING DERIVATIVE MODULES¶

  $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;
  }

INTERNAL FUNCTIONS used to write derivative parsers¶

STATUS DESTE MÓDULO¶

LISTA PARAFAZER¶

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¶

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, você pode redistribuí-lo e/ou modificá-lo sob os termos da GPL (consulte o ficheiro CÓPIA).