Guida introduttiva alla traduzione in AEM headless getting-started

Scopri come organizzare i contenuti headless e come funzionano gli strumenti di traduzione di AEM.

Percorso affrontato finora story-so-far

Nel documento precedente del percorso di traduzione in AEM headless Scopri i contenuti headless e come tradurre in AEM, hai appreso le conoscenze di base su cosa si intende con CMS headless e ora dovresti:

Questo articolo si basa su questi elementi fondamentali che ti consentono di comprendere come AEM memorizza e gestisce i contenuti headless, e come puoi utilizzare gli strumenti di traduzione di AEM per tradurre quei contenuti.

Obiettivo objective

Questo documento ti aiuta a capire come iniziare a tradurre il contenuto headless in AEM. Dopo la lettura dovresti:

Requisiti e prerequisiti requirements-prerequisites

Ci sono diversi requisiti prima di iniziare a tradurre il contenuto AEM headless.

Conoscenza knowledge

Strumenti tools

La struttura è la chiave content-structure

Il contenuto di AEM, sia esso headless o costituito da pagine web tradizionali, è basato sulla sua struttura. AEM impone pochi requisiti alla struttura dei contenuti, ma un’attenta considerazione della gerarchia dei contenuti come parte della pianificazione del progetto può rendere la traduzione molto più semplice.

Come AEM archivia i contenuti headless headless-content-in-aem

Per lo specialista della traduzione, non è importante comprendere in modo approfondito come AEM gestisce i contenuti headless. Tuttavia, conoscere i concetti e la terminologia di base sarà utile in seguito all’utilizzo di strumenti di traduzione AEM. Ma soprattutto, devi comprendere i contenuti e come sono strutturati per tradurli in modo efficace.

Modelli di contenuto content-models

Affinché i contenuti headless possano essere distribuiti in modo coerente tra canali, aree geografiche e lingue diverse, i contenuti devono essere estremamente strutturati. AEM utilizza i modelli di contenuto per applicare questa struttura. Pensa ai modelli di contenuto come a un tipo di modello o pattern per la creazione di contenuti headless. Poiché ogni progetto ha le proprie esigenze, ogni progetto definisce i propri modelli di frammenti di contenuto. AEM non ha requisiti o struttura fissi per tali modelli.

L’architetto dei contenuti all’inizio del progetto si occupa della definizione di questa struttura. Il persnale esperto di traduzione, dovrebbe collaborare strettamente con l’architetto dei contenuti per comprendere e organizzare i contenuti.

Poiché i modelli di contenuto definiscono la struttura del contenuto, è necessario sapere quali campi dei modelli devono essere tradotti. In genere si lavora con l’architetto dei contenuti per deciderlo. Per sfogliare i campi dei modelli di contenuto, effettua le seguenti operazioni.

Prendi nota del campo Nome proprietà per tutti i campi che devono essere tradotti. Queste informazioni saranno necessarie più avanti nel percorso. Questi Nome proprietà sono necessari per informare l'AEM su quali campi del contenuto devono essere tradotti.

Frammenti di contenuto content-fragments

I modelli di contenuto vengono utilizzati dagli autori dei contenuti per creare il contenuto headless effettivo. Gli autori dei contenuti selezionano il modello su cui basare i propri contenuti e quindi creano frammenti di contenuto. I frammenti di contenuto sono istanze dei modelli e rappresentano il contenuto effettivo da distribuire senza problemi.

Se i modelli di contenuto sono i pattern per il contenuto, i frammenti di contenuto sono il contenuto effettivo basato su tali pattern. I frammenti di contenuto rappresentano il contenuto da tradurre.

I frammenti di contenuto sono gestiti come risorse in AEM come parte della gestione delle risorse digitali (DAM). Questo è importante, in quanto si trovano tutti sotto il percorso /content/dam.

Struttura dei contenuti consigliata recommended-structure

Come precedentemente consigliato, collabora con l’architetto dei contenuti per determinare la struttura appropriata per il tuo progetto. Tuttavia la seguente è una struttura collaudata, semplice e intuitiva che è abbastanza efficace.

Definire una cartella di base per il progetto in /content/dam.

/content/dam/<your-project>

La lingua in cui viene creato il contenuto è denominata lingua root. Nel nostro esempio è inglese e dovrebbe essere sotto questo percorso.

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

Tutti i contenuti di progetto che potrebbero essere localizzati devono essere posizionati sotto la lingua root.

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

Le traduzioni devono essere create come cartelle di pari livello accanto alla lingua root con il nome della cartella che rappresenta il codice della lingua ISO-2. Ad esempio, il percorso per il tedesco è il seguente.

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

La struttura finale può avere un aspetto simile al seguente.

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

È necessario prendere nota del percorso specifico del contenuto, in quanto sarà necessario in seguito per configurare la traduzione.

Strumenti di traduzione AEM translation-tools

Ora che conosci i frammenti di contenuto e l’importanza della struttura dei contenuti, possiamo vedere come tradurre tali contenuti. Gli strumenti di traduzione in AEM sono abbastanza potenti, ma sono semplici da comprendere ad alto livello.

In genere il connettore viene configurato una sola volta per l’istanza e le regole per progetto headless. Poi utilizzi i progetti di traduzione per tradurre i contenuti e tenerne aggiornate le traduzioni su base continua.

Passaggio successivo what-is-next

Ora cha hai completato questa parte del percorso di traduzione headless, dovresti:

Approfondisci l'argomento e continua il tuo percorso di traduzione headless AEM consultando il documento Configura l'integrazione della traduzione dove verrà illustrato come connettere AEM a un servizio di traduzione.|

Risorse aggiuntive additional-resources

Mentre si consiglia di procedere alla parte successiva del percorso di traduzione headless consultando il documento Configurare il connettore di traduzione, ci sono risorse aggiuntive e facoltative che approfondiscono alcuni concetti menzionati in questo documento, ma che non sono necessarie per continuare nel percorso headless.