Introdução à Tradução do AEM Headless getting-started

Saiba como organizar seu conteúdo headless e como funcionam as ferramentas de tradução do AEM.

A história até agora story-so-far

No documento anterior da jornada de tradução do AEM headless, Saiba mais sobre o conteúdo headless e como traduzir no AEM, você aprendeu a teoria básica do que seria um CMS headless e agora você deve:

Este artigo se baseia nesses fundamentos para que você entenda como o AEM armazena e gerencia conteúdo headless e como você pode usar as ferramentas de tradução do AEM para traduzir esse conteúdo.

Objetivo objective

Este documento ajuda você a entender como começar a traduzir conteúdo headless no AEM. Depois de ler esse documento, você deverá:

Requisitos e pré-requisitos requirements-prerequisites

Há vários requisitos antes de começar a traduzir o conteúdo do AEM headless.

Conhecimento knowledge

Ferramentas tools

Estrutura é fundamental content-structure

O conteúdo do AEM, seja ele headless ou páginas da web tradicionais, é orientado por sua estrutura. O AEM impõe poucos requisitos à estrutura de conteúdo, mas uma consideração cuidadosa da hierarquia de conteúdo como parte do planejamento do projeto pode tornar a tradução muito mais simples.

Como o AEM armazena conteúdo headless headless-content-in-aem

Para o especialista em tradução, não é importante entender em detalhes como o AEM gerencia conteúdo headless. Entretanto, familiarizar-se com os conceitos e a terminologia básicos será útil, pois você poderá usar as ferramentas de tradução do AEM mais tarde. Principalmente, você precisa entender seu próprio conteúdo e como ele é estruturado para traduzi-lo efetivamente.

Modelos de conteúdo content-models

Para que o conteúdo headless seja entregue de forma consistente em canais, regiões e idiomas, o conteúdo deve ser altamente estruturado. O AEM usa Modelos de conteúdo para aplicar essa estrutura. Pense nos Modelos de conteúdo como um tipo de modelo ou padrão para criar conteúdo headless. Como cada projeto tem suas próprias necessidades, cada projeto define seus próprios Modelos de fragmento de conteúdo. O AEM não possui requisitos ou estrutura fixos para esses modelos.

O arquiteto de conteúdo funciona no início do projeto para definir essa estrutura. Como especialista em tradução, você deve trabalhar em conjunto com o arquiteto de conteúdo para entender e organizar o conteúdo.

Como os Modelos de conteúdo definem a estrutura do seu conteúdo, é necessário saber quais campos de seus modelos devem ser traduzidos. Geralmente, você trabalha com o arquiteto de conteúdo para definir isso. Para navegar pelos campos de seus modelos de conteúdo, siga as etapas abaixo.

Anote o campo Nome da Propriedade para todos os campos que devem ser traduzidos. Essas informações serão necessárias posteriormente na jornada. Esses Nome da propriedade s são necessários para informar ao AEM quais campos do seu conteúdo devem ser traduzidos.

Fragmentos de conteúdo content-fragments

Os Modelos de conteúdo são usados pelos autores de conteúdo para criar o conteúdo headless real. Os autores de conteúdo selecionam em qual modelo basear seu conteúdo e, em seguida, criam fragmentos de conteúdo. Fragmentos de conteúdo são instâncias dos modelos e representam o conteúdo real que deve ser entregue de forma headless.

Se os Modelos de conteúdo são os padrões do conteúdo, os Fragmentos de conteúdo são o conteúdo real baseado nesses padrões. Os Fragmentos de conteúdo representam o conteúdo que deve ser traduzido.

Os Fragmentos de conteúdo são gerenciados como ativos no AEM como parte do Gerenciamento de ativos digitais (DAM). Isso é importante, pois todos estão localizados no caminho /content/dam.

Estrutura de conteúdo recomendada recommended-structure

Conforme recomendado anteriormente, trabalhe com seu arquiteto de conteúdo para determinar a estrutura de conteúdo apropriada para seu próprio projeto. No entanto, a seguinte estrutura é comprovada, simples e intuitiva, além de ser bastante eficaz.

Defina uma pasta base para o seu projeto em /content/dam.

/content/dam/<your-project>

O idioma em que o conteúdo é criado é chamado de raiz de idioma. No nosso exemplo, é o inglês e deve estar dentro deste caminho.

/content/dam/<your-project>/en

Todo o conteúdo do projeto que pode precisar ser localizado deve ser colocado na raiz de idioma.

/content/dam/<your-project>/en/<your-project-content>

As traduções devem ser criadas como pastas irmãs ao lado da raiz de idioma, com o nome da pasta representando o código ISO-2 do idioma. Por exemplo, o alemão teria o seguinte caminho.

/content/dam/<your-project>/de

A estrutura final pode ficar parecida com a seguinte.

/content
    |- dam
        |- your-project
            |- en
                |- some
                |- exciting
                |- headless
                |- content
            |- de
            |- fr
            |- it
            |- ...
        |- another-project
        |- ...

Você deve anotar o caminho específico do conteúdo, pois ele será necessário posteriormente para configurar a tradução.

Ferramentas de tradução do AEM translation-tools

Agora que você entendeu o que são Fragmentos de conteúdo e a importância da estrutura do conteúdo, podemos ver como traduzir esse conteúdo. As ferramentas de tradução do AEM são bastante poderosas, mas são simples de entender em nível superior.

Geralmente, você só configura o conector para a instância e as regras uma vez por projeto headless. Então, você usa projetos de tradução para traduzir seu conteúdo e manter suas traduções atualizadas continuamente.

O que vem a seguir what-is-next

Agora que você concluiu esta parte da jornada de tradução headless, você deve:

Desenvolva esse conhecimento e continue sua jornada de tradução AEM headless revisando a seguir o documento Configurar a integração de tradução, onde você aprenderá a conectar o AEM a um serviço de tradução.|

Recursos adicionais additional-resources

Embora seja recomendável que você passe para a próxima parte da jornada de tradução headless revisando o documento Configurar o conector de tradução, veja a seguir alguns recursos opcionais adicionais que fazem uma análise mais profunda de alguns conceitos mencionados neste documento, mas não são necessários para continuar na jornada headless.