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

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

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

Use a ferramenta do tradutor 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.

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

O tradutor apresenta uma lista dos textos utilizados em AEM com as várias traduções linguísticas ao lado de cada um:

Você pode pesquisar, filtrar e editar o inglês e os textos traduzidos. Você também pode exportar dicionários para o formato XLIFF para tradução e depois 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 desse console. Você pode criar um novo ou adicionar a um projeto existente.

Criação de um dicionário creating-a-dictionary

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

Gerenciamento de sequências 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 strings em inglês e também fornecer strings traduzidas.

Adicionar, alterar e remover cadeias de caracteres adding-changing-and-removing-strings

Adicione strings em inglês a um dicionário que seu componente internacionalizou. Adicione somente strings que são internacionalizadas para que você não desperdice recursos traduzindo strings que não são usadas.

As cadeias de caracteres adicionadas a um dicionário devem corresponder exatamente à cadeia de caracteres especificada no código. Se a string padrão em inglês usada no código não corresponder à string em inglês em um dicionário, a string 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 Commenet da cadeia de caracteres do dicionário para fornecer informações ao tradutor e esclarecer o significado da cadeia de caracteres. Normalmente, a interface do usuário ajuda os usuários a determinar o significado de palavras ambíguas. No entanto, o tradutor não vê a string 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 Solicitação é usada como um substantivo em vez de um verbo.

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

Incluindo 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 da Web, a página inicial exibe a mensagem "Bem-vindo ao Administrador. Você tem 2 mensagens na sua caixa de entrada." O contexto da página determina o nome do usuário e o número de mensagens.

Para incluir variáveis na string localizada, coloque í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, pois idiomas diferentes usam estruturas de frases diferentes.

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

Por exemplo, a seguinte sequência de caracteres é 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 cadeias de caracteres

Altere ou remova as strings em inglês à medida que forem alteradas ou removidas no código. Quando você altera uma string, a string original é mantida e é feita uma nova string que reflete 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.

Pesquisar por cadeias de caracteres searching-for-strings

A barra de pesquisa na parte inferior da ferramenta Tradutor fornece opções de seleção de sequência de caracteres:

Edição de cadeias de caracteres traduzidas editing-translated-strings

Após adicionar a string em inglês a um dicionário, é possível adicionar traduções dessa string. Você também pode exportar o dicionário para que seja traduzido por um terceiro.

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

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

Exportar um dicionário exporting-a-dictionary

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

Ao exportar um arquivo XLIFF e incluir um idioma, a estrutura de 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 francês, a pasta do dicionário deve incluir o mix:language nó filho nomeado fr. (Consulte Criação de 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 somente em inglês.

Importação de 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 string em inglês e o arquivo XLIFF contém uma tradução diferente para a mesma string, 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 fornecidos aos usuários de suas páginas da Web.

Alteração de 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.

Disponibilizar idiomas para autores making-languages-available-to-authors

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

Alteração de nomes de idioma e países padrão changing-language-names-and-default-countries

Vários países utilizam o mesmo idioma, por exemplo, os EUA, o Reino Unido e a Austrália usam o inglês. Isto é indicado por um código que indica a língua 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), eles são usados para resolver o país para um código de idioma.

Para alterar as definições padrão:

Publicação de dicionários publishing-dictionaries

Incorpore seus dicionários ao processo de gerenciamento de versões dos aplicativos de 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 das strings de dicionário deve ser executado como parte do ciclo de vida normal do desenvolvimento de software.