## Trabalhar com texto formatado

- Tags de formatação

- Tags e segmentação por sentença

- Trabalhar com tags

- Aninhamento de grupos de tags

- Sobreposição de grupos de tags

- Verificação de grupos de tags

- Dicas para controle de tags

- printf-placeholders

As informações de formatação presentes no arquivo fonte geralmente precisam ser reproduzidas no arquivo traduzido. O OmegaT mostra informações de formatação in-line dos formatos que suporta (no momento DocBook, HTML, XHTML, Open Document e OpenOffice.org) como tags, ou etiquetas com códigos de formatação. As tags geralmente não são consideradas na comparação entre textos diferentes para fins de correspondência. As tags reproduzidas no segmento traduzido estarão presentes no documento traduzido.

### Tags de formatação

Composição das tags: as tags são formadas de um a três caracteres e um número. Um número exclusivo permite agrupar aquelas tags que se correspondem e diferenciar as tags que possam ter o mesmo caractere de atalho, mas na verdade são diferentes. Os caracteres podem ou não refletir o valor da formatação que a tag representa (por exemplo, negrito, itálico, etc.)

Numeração das tags: as tags são numeradas de forma sequencial e crescente por grupo de tags. O que nós chamamos de "grupos de tags" pode ser uma única tag (como `<br1>`), sozinha, ou 2 tags formando um par (como `<i0>` e `</i0>`). Dentro de um segmento, o primeiro grupo (par ou singleton) recebe o número 0, o segundo o número 1, etc. O primeiro exemplo abaixo tem 3 grupos de tags (um par, um singleton e depois, um outro par), o segundo exemplo tem apenas um grupo (um par).

Pares e singletons: as tags sempre são apresentadas em singletons ou em pares. Tags únicas indicam informações de formatação que não interferem no texto (espaço extra ou quebra de linha, por exemplo).

     <segment 2132><b0><Ctr+N></b0>, <br1><b2><Enter></b2><end segment>

`<br1>` é uma tag única e não interfere no texto. Tags em pares geralmente indicam informações de estilo que se aplicam ao texto entre a tag de início e a tag de fim de um par. Sejam quais forem os códigos de um par, a tag de início deve sempre vir antes da tag de fim:

     <segmento 3167>Arquivos de registro (<b0>log.txt</b0>) para acompanhar as operações e erros.<fim do segmento>

`<b0>` e `</b0>` estão em par e influenciam o texto `log.txt`.

### Tags e segmentação por sentença

OmegaT cria suas tags antes de aplicar a segmentação de sentenças. Dependendo das regras de segmentação, pode ser que as tags pareçam desrespeitar as regras acima de numeração e grupos. Veja o texto a seguir: "Antes: \. Depois: \s". A segmentação esperada seria (<b0> e </b0> indica o início e o fim do itálico):

     <segmento ....> <b0> Antes: \. Depois: \s</b0><fim do segmento>

Entretanto, se aplicarmos as regras de segmentação padrão neste segmento, o resultado final será o seguinte:

     <segmento 1990> <b0> Antes: \. <final segmento>

    <segmento 1991> Depois: \s</b0><fim do segmento>

Aplicar a regra segmentar depois de um ponto seguido por um espaço divide o texto original em dois segmentos, mesmo se as duas tags `<b0>` e `</b0>`devam ser mantidas juntas no mesmo segmento. Em alguns casos isso pode causar problemas na tradução, quando as tags devem ser colocadas em local diferente na frase para refletir a ordem das palavras na língua destino (veja Trabalhar com tags abaixo).

### Trabalhar com tags

Deve-se prestar muita atenção ao trabalhar com tags. Se elas forem modificadas por engano, a formatação final do arquivo pode ficar corrompida. O recomendado é "Se está funcionando, não mexa". Entretanto, é sempre bom saber o que é possível fazer e como fazer.

Duplicação de grupos de tags: para duplicar grupos de tags, basta copiá-los na nova posição desejada. Lembre-se de que em um grupo de pares a tag de início deve vir antes da tag de fim. A formatação representada pelo grupo que você duplicou será aplicada à seção onde a duplicação foi inserida.

Exemplo:

     <segmento 0001><b0>Esta formatação</b0> vai ser duplicada aqui.<fim do segmento>

Após a duplicação:

     <segmento 0001><b0>Esta formatação</b0> foi <b0>duplicada aqui</b0>.<fim do segmento>

Exclusão de grupos de tags: para excluir grupos de tags, basta apagá-los do segmento. Lembre-se de que um grupo de pares deve ter sua tag de início bem como de fim excluídas para garantir que todos os vestígios de formatação foram apagados; caso contrário, o arquivo traduzido pode ficar corrompido. Ao apagar um grupo de tags você exclui toda a formatação a elas relacionada de um arquivo traduzido.

Exemplo:

     <segmento 0001><b0>Esta formatação</b0> será excluída.<fim do segmento>

Após a exclusão:

     <segmento 0001>Esta formatação foi excluída.<fim do segmento>

Modificação da sequência de grupos de tags: para modificar a sequência de um grupo de tags para refletir a estrutura diferente usada na tradução, basta colocar o grupo de tags no local correspondente na tradução. A formatação será aplicada na parte onde foi inserida.

Exemplo:

     <segmento 0001><b0>Formatação zero</b0> e <b1>formatação um </b1>serão invertidas.<fim do segmento>

Após a modificação da sequência:

     <segmento 0001><b1>Formatação um</b1> e <b0>formatação zero</b0> foram invertidas.<fim do segmento>

### Aninhamento de grupos de tags

Modificar a sequência de um grupo de tags pode resultar no aninhamento deste grupo em um outro grupo de tags. Isto não representa nenhum problema, desde que o grupo esteja totalmente aninhado dentro do outro. Em outras palavras, ao mover as tags em par assegure-se de que as tags de início e de fim foram movidas; caso contrário, o arquivo traduzido pode ficar corrompido e não abrir. A parte aninhada terá ambas as formatações aplicadas.

Exemplo:

     <segmento 0001><b0>Formatação</b0> <b1>um</b1> vai ser aninhada na formatação zero.<fim do segmento>

Após o aninhamento:

     <segmento 0001><b0>Formatação <b1>um</b1></b0> foi aninhada na formação zero.<fim do segmento

### Sobreposição de grupos de tags

A sobreposição é o resultado da manipulação incorreta de pares de tags e certamente resultará em problemas de formatação e o arquivo traduzido pode não abrir. Exemplo:

     <segment 0001><b0>Formatação</b0> <b1>um</b1> vai ser bagunçada.<end segment>

Após a manipulação incorreta:

     <segment 0001><b0>Formatação <b1>um</b0> </b1>está muito bagunçada agora.<end segment>

### Verificação de grupos de tags

A função de verificação de tags detecta as tags modificadas (deliberadamente ou por engano) e indica os segmentos afetados. Para usar esta função pressione Ctrl+T - uma janela abrirá com todos os segmentos de um arquivo onde há tags incorretas ou danificadas na tradução. Os problemas de tags, criados no processo de tradução, são geralmente um problema para os arquivos no OpenDocument ou OpenOffice.org, pois eles podem não abrir. É fácil consertar as tags e recriar os documentos traduzidos com a função verificar tags. A janela, que abre com o comando Ctrl+T, tem a forma de tabela de 3 colunas com um link para o segmento, o segmento original e o segmento destino:

1 | Para selecionar uma fonte de visualização diferente, clique na caixa de diálogo <b0>Fonte de visualização</b0>. Para abrir esta caixa clique em <i1>Configurações</i1> >e depois <i2>Fonte de visualização...</i2>. O tipo e tamanho da fonte podem ser modificados nessa caixa. | 'n Mens kan 'n ander vertoonfont kies met die <b0>Vertoonfont</b0>-dialoogkassie. Kies <i1>Opstelling</i1> > Vertoonfont... op die kieslys. Die lettertipe én die lettergrootte kan met dié dialoogkassie verander word.

As tags estão destacadas em azul escuro para facilitar a comparação entre o original e o conteúdo traduzido. Clique no link para abrir o segmento no Editor. Corrija o erro, se necessário, e pressione `Ctrl+T` para voltar à janela de verificação de tags para ver se há outros erros. Os erros de tags são manipulações de tags na tradução que não reproduzem a mesma sequência e números das tags do segmento original. Algumas manipulações de tags são necessárias e não causam erros; algumas causarão problemas quando for criado o documento traduzido.

### Dicas para controle de tags

As tags geralmente representam algum tipo de formação do texto original. Simplificar a formatação do texto original reduz bastante a quantidade de tags. Se possível, deve-se procurar unificar as fontes usadas, os tamanhos e cores, etc., para simplificar a tradução e reduzir a possibilidade de criar erros de tags. Dê uma olhada na seção Trabalhar com tags para ver o que pode ser feito com tags. Lembre-se de que se as tags dificultarem seu trabalho e a formatação não for extremamente importante à tradução, remover as tags evitará problemas.

Se precisar ver as tags no OmegaT, mas não precisar reter a maioria do formato no documento traduzido, você pode optar por não acrescentar as tags na tradução. Neste caso preste atenção aos pares de tags pois se esquecer de apagar uma parte do par a formatação do documento ficará corrompida. Já que há tags inseridas no próprio documento, é possível usar as regras de segmentação para criar segmentos com menos tags. Esta é uma função avançada e requer alguma experiência do usuário.

Importante: o OmegaT ainda não faz a detecção total e automática de erros na formatação; portanto, não o alertará se você cometer erros ou mudar a formatação para melhor adaptá-la à língua destino. Algumas vezes, porém, o arquivo traduzido pode parecer distorcido e no caso do OpenDocument / OpenOffice.org os arquivos podem até não abrir.

### printf-placeholders

Em algumas linguages de programação (p.ex. PHP, C) são usadas tags especiais como placeholders (marcadores) em sequências de caracteres (strings) utilizadas em conjunto com a função printf. E.g.:

    $var =_("cool");
    echo printf(_("OmegaT is very %s"),$var);

Se as sequências de caracteres são extraídas deste código fonte (p.ex. via filtro-PO), o OmegaT não substituirá essas variáveis com tags porque não saberá ao certo se, por exemplo, `%s` é realmente um placeholder ou apenas parte do texto. No entanto, você pode ativar a validação destes placeholders. Selecione no menu Opções→ Verificação de tags.... Escolha entre a verificação simples ou completa.

A sintaxe oficial para printf variáveis ​​é

    "%" [ARGUMENTSWAPSPECIFIER] [SIGNSPECIFIER] [PADDINGSPECIFIER] [ALIGNMENTSPECIFIER] [WIDTHSPECIFIER] [PRECISIONSPECIFIER] TYPESPECIFIER

A verificação completa é compatível com este formato, exceto o `WIDTHSPECIFIER`. Na verificação simples a seguinte sintaxe é verificada:

    "%" [ARGUMENTSWAPSPECIFIER] [PRECISIONSPECIFIER] TYPESPECIFIER

É possível alterar a ordem dos placeholders, mas neste caso é necessário acrescentar o ARGUMENTSWAPSPECIFIER se ainda não estiver lá. Isto significa acrescentar um número de seqüência e um cifrão após o `%`. Por exemplo `"% S% s é um aplicativo"` é igual a `"% 1 $ s% 2 é um aplicativo $ s"` que você pode traduzir com `"A aplicação de 2% $ s é% 1 $ s"`.

Avisos legais | Home | Índice