Configurare le regole di traduzione configure-translation-rules
Scopri come definire le regole di traduzione per identificare i contenuti per la traduzione.
La storia finora story-so-far
Nel documento precedente del percorso di traduzione AEM headless, Configurare l’integrazione della traduzione, hai imparato a installare e configurare l’integrazione della traduzione e ora dovresti:
- Comprendere i parametri importanti del framework di integrazione della traduzione in AEM.
- Essere in grado di impostare la propria connessione al servizio di traduzione.
Ora che l’integrazione è configurata, questo articolo illustra il passaggio successivo per identificare il contenuto da tradurre.
Obiettivo objective
Questo documento ti aiuta a capire come utilizzare le regole di traduzione di AEM per identificare il contenuto per la traduzione. Dopo aver letto questo documento, dovresti:
- Comprendere come funzionano le regole di traduzione.
- Essere in grado di definire le tue regole di traduzione.
Regole di traduzione translation-rules
I frammenti di contenuto, che rappresentano il contenuto headless, possono contenere molte informazioni organizzate in campi strutturati. A seconda delle esigenze del progetto, è probabile che non tutte le informazioni all’interno di un Frammento di contenuto debbano essere tradotte.
Le regole di traduzione identificano il contenuto incluso o escluso nei progetti di traduzione. Quando il contenuto viene tradotto, AEM estrae o raccoglie il contenuto in base a queste regole. In questo modo solo il contenuto da tradurre viene inviato al servizio di traduzione.
Le regole di traduzione includono le seguenti informazioni:
- Percorso del contenuto a cui si applica la regola
- La regola si applica anche ai discendenti del contenuto
- Nomi delle proprietà che contengono il contenuto da tradurre
- La proprietà può essere specifica per un tipo di risorsa specifica o per tutti i tipi di risorsa
Poiché i modelli per frammenti di contenuto, che definiscono la struttura dei frammenti di contenuto, sono specifici del tuo progetto, è fondamentale impostare le regole di traduzione in modo che AEM conosca gli elementi dei modelli di contenuto da tradurre.
Creazione di regole di traduzione creating-rules
È possibile creare più regole per supportare requisiti di traduzione complessi. Ad esempio, potresti lavorare su un progetto che richiede la traduzione di tutti i campi del modello e su un altro in cui devono essere tradotti solo i campi descrizione mentre i titoli non vengono tradotti.
Le regole di traduzione sono progettate per gestire tali scenari. Tuttavia, in questo esempio viene illustrato come creare regole concentrandosi su una configurazione semplice e singola.
Una console Configurazione della traduzione è disponibile per la configurazione delle regole di traduzione. Per accedervi:
- Passa a Strumenti > Generale.
- Fai clic su Configurazione traduzione.
Nell’interfaccia utente di Configurazione della traduzione sono disponibili diverse opzioni per le regole di traduzione. Qui vengono evidenziati i passaggi più necessari e tipici necessari per una configurazione di base della localizzazione headless.
-
Fai clic su Aggiungi contesto, per aggiungere un percorso. Questo è il percorso del contenuto interessato dalla regola.
-
Utilizza il browser percorsi per selezionare il percorso richiesto e fai clic sul pulsante Conferma per salvare. Ricorda che i frammenti di contenuto, che contengono contenuto headless, si trovano in genere in
/content/dam/<your-project>.
-
AEM salva la configurazione.
-
Selezionare il contesto creato, quindi fare clic su Modifica. Viene aperto l’Editor regole di traduzione per configurare le proprietà.
-
Per impostazione predefinita, tutte le configurazioni vengono ereditate dal percorso padre, in questo caso
/content/dam. Deseleziona l'opzione Eredita da/content/damper aggiungere campi aggiuntivi alla configurazione. -
Una volta deselezionato, sotto la sezione Generale aggiungi i nomi delle proprietà dei modelli per frammento di contenuto precedentemente identificati come campi per la traduzione.
-
Immetti il nome della proprietà nel campo Nuova proprietà.
-
Le opzioni Traduci e Eredita vengono controllate automaticamente.
-
Fare clic su Aggiungi.
-
Ripeti questi passaggi per tutti i campi da tradurre.
-
Fai clic su Salva.
-
Hai configurato le regole di traduzione.
Utilizzo avanzato advanced-usage
È possibile configurare una serie di proprietà aggiuntive come parte delle regole di traduzione. Inoltre, è possibile specificare le regole manualmente come XML, consentendo una maggiore specificità e flessibilità.
Tali funzioni generalmente non sono necessarie per iniziare a localizzare il contenuto headless ma, se ti interessa, puoi avere maggiori informazioni nella sezione Risorse aggiuntive.
Passaggio successivo what-is-next
Ora cha hai completato questa parte del percorso di traduzione headless, dovresti:
- Comprendere come funzionano le regole di traduzione.
- Essere in grado di definire le tue regole di traduzione.
Approfondisci l'argomento e continua il percorso di traduzione headless AEM consultando il documento successivo Tradurre il contenuto dove verrà illustrato come l'integrazione e le regole interagiscono per tradurre contenuti headless.
Risorse aggiuntive additional-resources
Sebbene sia consigliabile passare alla parte successiva del percorso di traduzione headless consultando il documento Traduci contenuto, le seguenti sono alcune risorse aggiuntive e opzionali che approfondiscono alcuni concetti menzionati in questo documento, ma non sono necessarie per continuare il percorso headless.
- Identificazione del contenuto da tradurre - Scopri come le regole di traduzione identificano i contenuti da tradurre.