Configurar regras de tradução configure-translation-rules
Saiba como definir regras de tradução para identificar o conteúdo a ser traduzido.
A história até agora story-so-far
No documento anterior da jornada de tradução do AEM headless, Configurar integração de tradução, você aprendeu a instalar e configurar sua integração de tradução e agora deve:
- Compreender os parâmetros fundamentais da estrutura de integração de tradução no AEM.
- Ser capaz de configurar sua própria conexão com o serviço de tradução.
Agora que sua integração está configurada, este artigo o orienta pela próxima etapa de identificação do conteúdo que deve ser traduzido.
- O sinalizador Traduzível cria regras de tradução automaticamente, sem necessidade de intervenção.
- O sinalizador Traduzível é usado somente se a configuração da estrutura de integração de tradução estiver definida como Habilitar campos do modelo de conteúdo para tradução.
- Habilitar essa opção na configuração de TIF substitui quaisquer regras de tradução criadas manualmente.|
Objetivo objective
Este documento ajuda você a entender como usar as regras de tradução do AEM para identificar o conteúdo da tradução. Depois de ler este documento, você deverá:
- Entenda o que as regras de tradução fazem.
- Ser capaz de definir suas próprias regras de tradução.
Regras de tradução translation-rules
Os fragmentos de conteúdo, que representam o conteúdo headless, podem conter muitas informações organizadas por campos estruturados. Dependendo das necessidades do projeto, é provável que nem todos os campos em um Fragmento de conteúdo precisem ser traduzidos.
As regras de tradução identificam o conteúdo que faz parte, ou não, dos projetos de tradução. Quando o conteúdo é traduzido, o AEM extrai ou obtém o conteúdo com base nessas regras. Dessa forma, somente o conteúdo que deve ser traduzido é enviado para o serviço de tradução.
As regras de tradução incluem as seguintes informações:
- O caminho do conteúdo ao qual a regra se aplica
- A regra também se aplica aos descendentes do conteúdo
- Os nomes das propriedades que contêm o conteúdo a ser traduzido
- A propriedade pode ser específica para um tipo de recurso específico ou para todos os tipos de recurso
Visto que os modelos de fragmentos de conteúdo, que definem a estrutura dos fragmentos de conteúdo, são exclusivos de seu próprio projeto, é vital configurar regras de tradução para que o AEM saiba quais elementos dos modelos de conteúdo devem ser traduzidos.
Criar regras de tradução creating-rules
Várias regras podem ser criadas para dar suporte a requisitos complexos de tradução. Por exemplo, um projeto no qual você está trabalhando pode exigir que todos os campos do modelo sejam traduzidos, enquanto em outro projeto apenas os campos de descrição devem ser traduzidos, e os títulos não devem ser traduzidos.
As regras de tradução são projetadas para lidar com tais cenários. No entanto, neste exemplo, ilustramos como criar regras com foco em uma configuração simples e única.
Existe um console de Configuração de tradução disponível para configurar regras de tradução. Para acessá-lo:
- Navegue até Ferramentas > Geral.
- Selecione Configurações de tradução.
Na interface de usuário da Configuração de tradução, há várias opções disponíveis para suas regras de tradução. Aqui destacamos as etapas mais necessárias e típicas de uma configuração básica de localização headless.
-
Selecione Adicionar Contexto para adicionar um caminho. Esse é o caminho do conteúdo que deve ser afetado pela regra.
-
Use o navegador de caminho para selecionar o caminho necessário e selecione Confirmar para salvar. Lembre-se, os fragmentos de conteúdo, que possuem conteúdo headless, geralmente estão localizados em
/content/dam/<your-project>.
-
Selecione o contexto criado e selecione Editar. Isso abre o editor de regras de tradução para configurar as propriedades.
-
Por padrão, todas as configurações são herdadas do caminho principal, neste caso:
/content/dam. Desmarque a opção Herdar de/content/dampara adicionar novos campos à configuração. -
Quando desmarcada, na seção Geral da lista, adicione os nomes de propriedade dos Modelos de fragmento de conteúdo que você identificou anteriormente como campos para tradução.
-
No campo Nova Propriedade, digite o nome da propriedade. Observe que as opções Traduzir e Herdar são verificadas automaticamente.
-
Selecione Adicionar.
-
Repita essas etapas para todos os campos que devem ser traduzidos.
-
Selecione Salvar.
-
Agora, você configurou as regras de tradução.
Uso avançado advanced-usage
Há várias propriedades adicionais que podem ser configuradas como parte das regras de tradução. Além disso, você pode especificar suas regras manualmente como XML, o que permite maior especificidade e flexibilidade.
Esses recursos geralmente não são necessários para começar a localização do seu conteúdo headless, mas você pode ler mais sobre eles na seção Recursos adicionais, caso esteja interessado.
O que vem a seguir what-is-next
Agora que você concluiu esta parte da jornada de tradução headless, você deve:
- Entenda o que as regras de tradução fazem.
- Ser capaz de definir suas próprias regras de tradução.
Desenvolva esse conhecimento e continue sua jornada de tradução AEM headless revisando a seguir o documento Traduzir conteúdo, onde você aprende como a integração e as regras funcionam juntas para traduzir conteúdo headless.
Recursos adicionais additional-resources
Embora seja recomendável seguir para a próxima parte da jornada de tradução headless revisando o documento Traduzir conteúdo, os recursos opcionais a seguir fornecerão uma explicação mais detalhada dos conceitos mencionados neste documento, porém, eles não são obrigatórios para continuar na jornada headless.
- Identificar conteúdo a ser traduzido - Saiba como as regras de tradução identificam o conteúdo que precisa ser traduzido.