Usar o Translator para gerenciar dicionários using-translator-to-manage-dictionaries

O AEM fornece um console para gerenciar as várias traduções de textos usados na interface do usuário do componente. Este console está disponível em

https://<hostname>:<port-number>/libs/cq/i18n/translator.html

Use a ferramenta de tradução para gerenciar cadeias de caracteres em inglês e suas traduções. Os dicionários são criados no repositório, por exemplo, /apps/myproject/i18n.

A ferramenta Tradutor e os dicionários gerenciados são usados para apresentar a interface do usuário do componente em diferentes idiomas. Se quiser traduzir uma página ou conteúdo gerado pelo usuário, consulte Tradução de conteúdo para sites multilíngues e Tradução de conteúdo gerado pelo usuário.

O tradutor relaciona os textos usados no AEM com as várias traduções de idiomas ao lado umas das outras:

Você pode pesquisar, filtrar e editar os textos em inglês e traduzido. Você também pode exportar dicionários para o formato XLIFF para tradução e, em seguida, importar as traduções de volta para os dicionários.

Também é possível adicionar os dicionários i18n a um projeto de tradução a partir desse console. Você pode criar um ou adicionar a um projeto existente.

Criando um dicionário creating-a-dictionary

Crie um dicionário para gerenciar suas cadeias de caracteres localizadas da interface do usuário. Depois de criar um dicionário, você pode usar a ferramenta Tradução para gerenciá-lo.

Gerenciar strings de dicionário managing-dictionary-strings

Use a ferramenta Tradução para gerenciar as cadeias de caracteres em seus dicionários. Você pode adicionar, modificar e remover cadeias de caracteres em inglês e também fornecer cadeias de caracteres traduzidas.

Adição, Alteração e Remoção de Strings adding-changing-and-removing-strings

Adicione cadeias de caracteres em inglês a um dicionário internacionalizado por seu componente. Adicione somente strings internacionalizadas para não desperdiçar recursos traduzindo strings que não são usadas.

As cadeias de caracteres adicionadas a um dicionário devem corresponder exatamente à cadeia especificada no código. Se a cadeia de caracteres padrão em inglês que é usada no código não corresponder à cadeia de caracteres em inglês em um dicionário, a cadeia de caracteres traduzida não aparecerá na interface do usuário quando necessário. As cadeias de caracteres fazem distinção entre maiúsculas e minúsculas.

Fornecer dicas de tradução

Use a propriedade Comentário da string do dicionário para fornecer informações ao tradutor para esclarecer o significado da string. Normalmente, a interface auxilia os usuários a determinar o significado de palavras ambíguas. No entanto, o tradutor não vê a cadeia de caracteres no contexto da interface do usuário. A dica de tradução remove a ambiguidade. Por exemplo, um comentário ajuda o tradutor a entender que a palavra em inglês Request é usada como um substantivo em vez de um verbo.

As dicas de tradução também distinguem strings idênticas e com significados diferentes. Por exemplo, a palavra Pesquisa pode ser um substantivo ou um verbo, o que requer duas entradas de "Pesquisa" no dicionário com duas dicas de tradução diferentes. O código que solicita a cadeia de caracteres também inclui a dica de tradução para que a cadeia correta seja usada na interface do usuário.

Inclusão de variáveis indexadas

Inclua variáveis na string localizada para criar significado contextual em uma frase. Por exemplo, depois de fazer logon em um aplicativo web, a página inicial exibe a mensagem "Bem-vindo de volta, Administrador. Você tem duas mensagens na sua caixa de entrada." O contexto da página determina o nome de usuário e o número de mensagens.

Para incluir variáveis na string localizada, coloque os índices entre colchetes no local das variáveis no primeiro argumento do método get. Use a dica de localização para descrever os valores. O tradutor deve entender o significado das variáveis porque línguas diferentes usam estruturas de frases diferentes.

Observe que o código que solicita a cadeia de caracteres traduzida O fornece valores para as variáveis indexadas de acordo com o contexto.

Por exemplo, a seguinte string é exibida quando um usuário faz logon em um site e é incluída no dicionário:

Welcome back {0}. You have {1} messages.

O Comentário a seguir descreve as variáveis:

{0} = the user name, {1} = the number of items in the user's inbox

Modificação de strings

Altere ou remova cadeias de caracteres em inglês à medida que são alteradas ou removidas no código. Quando você altera uma string, a string original é mantida e uma nova string é feita refletindo a alteração. Antes de remover uma string, verifique se nenhum código a usa.

Use o procedimento a seguir para adicionar uma string.

Use o procedimento a seguir para alterar uma string em um dicionário.

Use o procedimento a seguir para remover uma string de um dicionário.

Pesquisando Strings searching-for-strings

A barra de pesquisa na parte inferior da ferramenta Tradutor fornece opções de seleção de strings:

Editar strings traduzidas editing-translated-strings

Depois de adicionar a sequência de caracteres em inglês a um dicionário, você pode adicionar traduções da sequência de caracteres. Também é possível exportar o dicionário para ser traduzido por um terceiro.

Uso de tradutores de terceiros using-third-party-translators

Para oferecer suporte ao uso de serviços de tradução de terceiros, a ferramenta de Tradução permite exportar e importar dicionários.

Exportar um dicionário exporting-a-dictionary

Exportar um dicionário para um arquivo XLIFF para que um serviço de terceiros possa traduzir as cadeias de caracteres do dicionário.

Quando você exporta um arquivo XLIFF e inclui um idioma, a estrutura do nó do dicionário no repositório deve incluir esse idioma. Se o idioma não for incluído, ocorrerão erros. Por exemplo, para exportar o arquivo XLIFF em francês, a pasta do dicionário deve incluir o mix:language nó filho chamado fr. (Consulte Criando um dicionário.)

Use o procedimento a seguir para exportar um arquivo XLIFF para um idioma específico.

Use o procedimento a seguir para exportar todas ou algumas das strings em inglês.

Importando um dicionário importing-a-dictionary

Importe um arquivo XLIFF em um dicionário para preencher o dicionário. Quando o dicionário inclui uma tradução para uma cadeia de caracteres em inglês e o arquivo XLIFF contém uma tradução diferente para a mesma cadeia de caracteres, a tradução do dicionário é substituída.

Gerenciamento de idiomas suportados managing-supported-lanuages

Adicione ou remova idiomas compatíveis com a ferramenta Tradução e que são fornecidos aos usuários das suas páginas da Web.

Alterando Idiomas Listados na Tabela de Dicionários changing-languages-listed-in-the-dictionary-table

A ferramenta Tradutor inclui os seguintes idiomas na tabela de dicionários:

Use o procedimento a seguir para adicionar ou remover idiomas.

Disponibilização de idiomas para autores making-languages-available-to-authors

Depois de definir um dicionário para um idioma novo na instância do AEM, é necessário disponibilizá-lo para seleção pelos autores (por exemplo, para uso no Preferências):

Alterando Nomes de Idiomas e Países Default changing-language-names-and-default-countries

Vários países usam a mesma língua, por exemplo, os EUA, o Reino Unido e a Austrália usam o inglês. Isso é indicado por um código indicando o idioma e o país, como en_US, en_GB e en_AU.

Os países padrão são usados ao exibir sinalizadores (por exemplo, na caixa de diálogo de cópia de idioma), para resolver o país de um código de idioma.

Para alterar as definições default:

Dicionários de publicação publishing-dictionaries

Incorpore seus dicionários no processo de gerenciamento de versões de seus aplicativos AEM. Por exemplo, inclua o dicionário no pacote de conteúdo do aplicativo para implantação na instância de publicação. Essa estratégia oferece os seguintes benefícios:

Da mesma forma, o teste de strings de dicionário deve ser executado como parte de seu ciclo de vida normal de desenvolvimento de software.