NOME¶

DESCRIÇÃO¶

Locale::Po4a::Xml é um módulo para ajudar a tradução de documentos XML para outros idiomas. Ele também pode ser usado como uma base para compilar módulos para documentos baseados em XML.

TRADUZINDO COM PO4A::XML¶

Há algumas opções (descritas na próxima seção) que podem personalizar este comportamento. Se isso não se adequar ao formato do seu documento, encorajamos você a escrever seu próprio módulo derivado deste, para descrever os detalhes do seu formato. Veja a seção abaixo ESCREVENDO MÓDULOS DERIVADOS, para a descrição do processo.

OPÇÕES ACEITAS POR ESTE MÓDULO¶

Estas são as opções específicas deste módulo:

nostrip

Previne-o de cortar espaços em volta das strings 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 "tags" option below.

caseinsensitive

Isso faz com que a pesquisa por marcações e atributos funcione de uma forma que diferencie letras maiúsculas das minúsculas. Se essa opção estiver definida, ela vai tratar <BooK>laNG e <BOOK>Lang como <book>lang.

includeexternal

Quando definida, entidades externas são incluídas no documento gerado (traduzido) e para a extração de strings. Se não estiver definido, você terá que traduzir entidades externas separadamente como documentos independentes.

ontagerror

This option defines the behavior of the module when it encounters invalid XML syntax (a closing tag which does not match the last opening tag, or a tag's attribute without value). It can take the following values:

tagsonly

Extrai apenas as marcações especificadas na opção "tags". Do contrário, ela extrairá todas as marcações, com exceção daquelas especificadas.

Nota: essa opção é obsoleta.

doctype

String que tentará corresponder com a primeira linha do tipo de documento (doctype) do documento (se definido). Se não estiver definido, um aviso vai indicar que o documento pode ser um tipo incorreto.

addlang

String indicando o caminho (ex.: <bbb><aaa>) de uma marcação na qual um atributo lang="..." deve ser adicionado. O idioma será definido como o nome base do arquivo PO sem qualquer extensão.

tags

Lista separada por espaço de marcações que você deseja traduzir ou ignorar. Por padrão, as marcações especificadas serão excluídas, mas se você usar a opção "tagsonly", as marcações especificadas serão as únicas incluídas. As marcações devem estar na forma <aaa>, mas você pode juntar algumas (<bbb><aaa>) para informar que o conteúdo da tag <aaa> será traduzido apenas quando ela estiver dentro de uma marcação <bbb>.

Você também pode especificar algumas opções de marcação para colocar alguns caracteres na frente da hierarquia de marcações. Por exemplo, você pode colocar um "w" (wrap) ou "W" (não aplica wrap) para sobrescrever o comportamento padrão especificado pela opção global "wrap".

Exemplo: W<capítulo><título>

Nota: Essa opção é obsoleta. Você deveria usar as opções translated e untranslated ao invés dessa.

attributes

Space-separated list of tag's attributes you want to translate. You can specify the attributes by their name (for example, "lang"), but you can prefix it with a tag hierarchy, to specify that this attribute will only be translated when it's in the specified tag. For example: <bbb><aaa>lang specifies that the lang attribute will only be translated if it's in an <aaa> tag, and it's in a <bbb> tag.

foldattributes

Não traduz atributos nas marcações integradas. Ao invés disso, substitui todos os atributos de uma marcação por po4a-id=<id>.

Isso é útil quando os atributos não devam ser traduzidos, pois isso simplifica as strings para tradutores e evita erros de escrita.

customtag

Lista separada por espaço de marcações que não deveriam ser tratadas como marcações. Essas marcações são tratadas como integradas e não precisam ser fechadas.

break

Lista separada por espaço de marcações que deveriam interromper a sequência. Por padrão, todas as marcações interrompem a sequência.

The tags must be in the form <aaa>, but you can join some (<bbb><aaa>), if a tag (<aaa>) should only be considered when it's within another tag (<bbb>).

inline

Lista separada por espaço de marcações que deveriam ser tratadas como integradas. Por padrão, todas as marcações interrompem a sequência.

The tags must be in the form <aaa>, but you can join some (<bbb><aaa>), if a tag (<aaa>) should only be considered when it's within another tag (<bbb>).

placeholder

Lista separada por espaço de marcações que devem ser tratadas como placeholders. Elas não interrompem a sequência, mas o conteúdo desses placeholders é traduzido separadamente.

A localização do placeholder em seu bloco será marcado com uma string similar a:

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

The tags must be in the form <aaa>, but you can join some (<bbb><aaa>), if a tag (<aaa>) should only be considered when it's within another tag (<bbb>).

nodefault

Lista separada por espaço de marcações que o módulo não deveria tentar definir por padrão em qualquer categoria.

cpp

Diretivas de suporte do preprocessador C. Quando essa opção está definida, po4a vai considerar as diretivas do preprocessador como separadores de parágrafo. Isso é importante se o arquivo XML deve ser preprocessado porque, do contrário, as diretivas podem ser inseridas no meio de linhas se po4a considerar que elas pertencem ao parágrafo atual, e elas não serão reconhecidas pelo preprocessador. Nota: as diretivas do preprocessador devem aparecer apenas entre marcações (elas não podem interromper uma marcação).

translated

Lista separada por espaço de marcações que você deseja traduzir.

The tags must be in the form <aaa>, but you can join some (<bbb><aaa>), if a tag (<aaa>) should only be considered when it's within another tag (<bbb>).

Você também pode especificar algumas opções de marcação para colocar alguns caracteres na frente da hierarquia de marcações. Por exemplo, você pode colocar um "w" (wrap) ou "W" (não aplica wrap) para sobrescrever o comportamento padrão especificado pela opção global "wrap".

Exemplo: W<capítulo><título>

untranslated

Lista separada por espaço de marcações que você não deseja traduzir.

The tags must be in the form <aaa>, but you can join some (<bbb><aaa>), if a tag (<aaa>) should only be considered when it's within another tag (<bbb>).

defaulttranslateoption

As categorias padrão para marcações que estão em nenhum entre "translated", "untranslated", "break", "inline" ou "placeholder".

Essa é um conjunto de letras:

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¶

LISTA DE TAREFAS¶

Há um suporte mínimo para a tradução de entidades. Elas são traduzidos como um todo e marcações não são levadas em conta. Não há suporte a entidades multilinhas, sofrendo elas uma quebra de linha durante a tradução.

MODIFICAR TIPOS DE MARCAÇÃO DE MÓDULOS HERDADOS (move a estrutura de tag_types para dentro do $self hash?)

VEJA TAMBÉM¶

AUTORES¶

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

COPYRIGHT E LICENÇA¶

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

Esse programa é um software livre; você pode redistribuí-lo e/ou modificá-lo sob os termos da GPL (veja o arquivo COPYING).