DocumentaçãoAEM 6.5Guia do usuário

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

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Desenvolvedor

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. Para 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.

CAUTION
Edite somente os dicionários criados para o seu projeto e localizados em /apps.
Dicionários do sistema AEM também estão disponíveis nesta ferramenta. Não altere os dicionários do sistema AEM, pois isso pode causar problemas com a interface AEM. Além disso, as alterações podem ser perdidas na atualização. Dicionários do sistema AEM localizados em /libs.
NOTE
Embora a ferramenta Translator tenha uma interface de interface clássica, ela é usada para tradução de frases, independentemente da interface em que essas frases são encontradas.

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

chlimage_1-205

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.

  1. Clique em Traduzir Dicionário.

    chlimage_1-206

  2. Selecione a opção Criar ou Adicionar dependendo da sua necessidade. Uma caixa de diálogo é aberta.

    chlimage_1-207

  3. Preencha os campos conforme necessário e clique em OK. chlimage_1-208

  4. Agora você pode clicar em OK ou ver o Dicionário de Destino.

    note note
    NOTE
    Para obter mais informações sobre projetos de tradução, leia Gerenciando projetos de tradução.

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.

  1. Usando o CRXDE Lite, adicione o nó raiz ( sling:Folder) do novo dicionário como a estrutura que contém as definições de idioma:

    /apps/<projectName>/i18n

    Por exemplo, /apps/myProject/i18n

  2. Adicione a estrutura de idioma necessária nesta raiz. Por exemplo:

    code language-shell 
    /apps/myProject/i18n [sling:Folder]
    - de.json [nt:file] [mix:language]
        + jcr:language = de
    - fr.json [nt:file] [mix:language]
        + jcr:language = fr
    note note
    NOTE
    Esta é a estrutura do módulo Sling i18n.

  3. Recarregue o tradutor e o caminho do dicionário (por exemplo, /apps/myProject/i18n) estará disponível no seletor suspenso na barra de ferramentas. Selecione essa opção para começar a adicionar strings e suas traduções.

    note note
    NOTE
    O tradutor só salvará traduções para idiomas que estejam realmente presentes sob o caminho (por exemplo, /apps/myProject/i18n).
    Verifique se eles correspondem aos idiomas mostrados na grade.

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.

CAUTION
Edite somente os dicionários criados para o seu projeto e localizados em /apps.
Não altere os dicionários do sistema AEM, pois isso pode causar problemas com a interface AEM. Além disso, as alterações podem ser perdidas na atualização. Dicionários do sistema AEM localizados em /libs.

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.

Fornecendo 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.

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 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 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

Modificando Cadeias de Caracteres

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.

  1. No menu suspenso Dicionários, selecione o dicionário ao qual está adicionando uma string. No menu suspenso, os dicionários são representados pelo caminho no repositório.

  2. Acima da tabela Strings e traduções, clique em Adicionar.

    chlimage_1-209

  3. Na caixa String da caixa de diálogo Adicionar string, digite a string em inglês. Na caixa Comentário, digite uma dica de tradução para o tradutor, se necessário.

  4. Clique em OK.

  5. Clique em Salvar.

    chlimage_1-210

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

  1. No menu suspenso Dicionários, selecione o dicionário que contém a sequência de caracteres a ser alterada.

  2. Clique duas vezes na sequência de caracteres a ser alterada.

  3. Na caixa de diálogo Editar string, selecione Modificar string ou Comentário (Cria uma cópia).

    chlimage_1-211

  4. Modifique a cadeia de caracteres ou o comentário e clique em OK.

  5. Clique em Salvar.

    chlimage_1-212

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

  1. No menu suspenso Dicionários, selecione o dicionário do qual você está removendo uma string.

  2. Clique em Remover.

    chlimage_1-213

  3. Clique em Salvar.

    chlimage_1-214

Pesquisando Strings searching-for-strings

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

  • Filtrar por texto: um padrão para corresponder à cadeia de caracteres em inglês, ao comentário ou às traduções. Somente itens que correspondem a todo ou parte do padrão aparecem na tabela.

  • Alterações: Qualquer, Modificado, Novo, Excluído: Mostra os itens que foram alterados e não foram salvos.

    • Qualquer um: mostra itens que foram modificados, adicionados ou removidos.
    • Modificado: mostra itens que foram alterados.
    • Novo: mostra itens que foram adicionados.
    • Excluído: mostra os itens que serão removidos.
    • Várias seleções: mostra itens que têm todas as propriedades selecionadas.

  • Tem Comentário: mostra itens que possuem comentários para tradutores.

  • Traduções ausentes: mostra itens em que pelo menos um idioma não tem uma tradução.

chlimage_1-215

  1. Na barra de pesquisa, selecione as opções de filtro.
  2. Para filtrar usando as opções, clique em Filtro.
  3. Para remover os filtros e ver todos os itens no dicionário, clique em Limpar.

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. Você também pode exportar o dicionário para traduzi-lo por terceiros.

  1. Selecione o dicionário específico do seu projeto, pois ele especifica o caminho no repositório que contém as traduções. Por exemplo, selecione Dicionários como:

    /apps/myProject/i18n

    note caution
    CAUTION
    Edite somente os dicionários criados para o seu projeto e localizados em /apps.
    Dicionários do sistema AEM também estão disponíveis nesta ferramenta. Não altere os dicionários do sistema AEM, pois isso pode causar problemas com a interface AEM. Além disso, as alterações podem ser perdidas na atualização. Dicionários do sistema AEM localizados em /libs.

  2. Para editar os textos traduzidos de uma das cadeias de caracteres, é possível:

    • Clique duas vezes no idioma apropriado para a string necessária para editar esse texto único:

    chlimage_1-216

    • Clique duas vezes nos campos Cadeia de caracteres ou Comentário da cadeia de caracteres necessária para abrir a caixa de diálogo Editar cadeia de caracteres, editar a(s) tradução(ões) conforme necessário e clicar em OK para fechar a caixa de diálogo:

    chlimage_1-217

  3. Clique em Salvar na barra de ferramentas para confirmar as alterações.

    note note
    NOTE
    Clicar em Redefinir e Atualizar (em vez de Salvar) reverte as alterações nos textos anteriores.

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.

  • Exporte um dicionário e inclua o inglês e os termos traduzidos de um idioma.
  • Exporte algumas ou todas as cadeias de caracteres em inglês.

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 de dicionário deve incluir o nó filho mix:language chamado fr. (Consulte Criando um Dicionário.)

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

  1. Abrir a ferramenta de Tradução http://<host>:<port>/libs/cq/i18n/translator.html

  2. Use o menu suspenso Dicionários para selecionar o dicionário a ser exportado.

  3. Clique em Exportar > Exportar completo XX Opções Xliff, onde XX é o código de idioma com duas letras, como DE ou FR.

    O arquivo XLIFF é aberto em uma nova guia ou janela.

  4. Use os comandos do navegador da Web para salvar a página como um arquivo em seu sistema de arquivos, como Arquivo > Salvar página como.

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

  1. Abra a ferramenta Tradução. http://<host>:<port>/libs/cq/i18n/translator.html
  2. Use o menu suspenso Dicionários para selecionar o dicionário a ser exportado.
  3. Se você estiver exportando um subconjunto das cadeias de caracteres, selecione os itens do dicionário que serão exportados. Selecionar nenhum item exporta todos os itens.
  4. Clique em Exportar > Exportar seleção como Xliff (somente strings).
  5. Na caixa de diálogo exibida, copie o texto e cole-o em um arquivo de texto.

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.

  1. Abrir a ferramenta de Tradução http://<host>:<port>/libs/cq/i18n/translator.html
  2. Clique em Importar > Traduções XLIFF.
  3. Selecione o arquivo a ser importado e clique em OK.

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:

  • de - Alemão
  • fr - Francês
  • it - Italiano
  • es - Espanhol
  • ja - Japonês
  • pt-br - Português do Brasil
  • zh-cn - Chinês simplificado
  • zh-tw - Chinês tradicional (suporte limitado)
  • ko-kr - Coreano

Use o procedimento a seguir para adicionar ou remover idiomas.

  1. Usando o CRXDE Lite, crie um nó:

    /etc/languages

  2. Neste nó, crie uma propriedade:

    • Nome: languages

    • Tipo: Multi-String

    • Valor: a lista de idiomas que você deseja exibir. Por exemplo:

      • fr
      • es
    note note
    NOTE
    Os códigos de idioma devem estar em minúsculas.

  3. Clique em Salvar tudo no CRXDE Lite e recarregue o conversor. A grade será atualizada para mostrar os idiomas definidos.

    note note
    NOTE
    O tradutor só salvará traduções para idiomas que sejam presentes no dicionário (ou seja, abaixo do caminho do dicionário, como /apps/myProject/i18n).
    Verifique se eles correspondem aos idiomas mostrados na grade.

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

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

  1. Para alterar a lista de idiomas disponíveis em Preferências do console Segurança:

    1. Crie uma sobreposição no código do aplicativo para:

      code language-none 
              /libs/cq/security/widgets/source/widgets/security/Preferences.js
 and update as required.

  2. Para disponibilizar o idioma em Preferências do console Sites, você precisa fazer as seguintes alterações em seu aplicativo:

    1. Crie uma sobreposição para a estrutura em:

      /libs/cq/security/content/tools/userProperties

    2. Na sobreposição, atualize a lista de idiomas em:

      items/common/items /lang/options

  3. Salve tudo e recarregue o console apropriado.

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.

NOTE
Para localizações conforme gerenciado pelo tradutor acima, somente o idioma exato funciona. Se o menu suspenso de preferências de idioma usar en_uk, deverá haver um dicionário en_uk no repositório.

Para alterar as definições default:

  1. Uma lista de idiomas é armazenada em:

    /libs/wcm/core/resources/languages

    Sobrepor copiando-o em:

    /apps/wcm/core/resources/languages

    Em seguida, altere ou estenda a lista lá. A propriedade defaultCountry em um nó de idioma (por exemplo, ja) deve conter o código completo, como ja_jp, que definiria jp como o país padrão do idioma ja.

  2. Atualize o Gerenciador de Idiomas WCM do CQ.

    • Lista de idiomas:

      O caminho para a lista de idiomas no repositório. Defina isso no local usado para sobrepor:

      code language-none 
             /apps/wcm/core/resources/languages

    Você pode fazer isso usando o Console da Web OSGi:

    code language-shell 
    https://<hostname>:<port-number>/system/console/configMgr/com.day.cq.wcm.core.impl.LanguageManagerImpl

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:

  • Os dicionários estão disponíveis para componentes em seu ambiente de publicação.
  • As alterações nas cadeias de caracteres da interface do usuário do componente são implantadas junto com as traduções atualizadas.

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.

NOTE
Não use a funcionalidade de publicação regular, ou replicação, para dicionários. Em vez disso, os dicionários devem ser tratados da mesma forma que o código e a configuração. Isso inclui usar o controle do código-fonte para rastrear alterações e usar pacotes de conteúdo para aplicar alterações ao autor e à publicação.
NOTE
Ao usar o Dispatcher, você precisa invalidar páginas em cache para incluir novas cadeias de caracteres de dicionário em cadeias de caracteres de componentes renderizadas.
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2