Identificazione del contenuto da tradurre

Le regole di traduzione identificano il contenuto da tradurre per le pagine, i componenti e le risorse inclusi nei progetti di traduzione o esclusi da essi. Quando una pagina o una risorsa viene tradotta, AEM estrae questo contenuto in modo che possa essere inviato al servizio di traduzione.

Le pagine e le risorse sono rappresentate come nodi nell’archivio JCR. Il contenuto estratto è uno o più valori di proprietà dei nodi. Le regole di traduzione identificano le proprietà che contengono il contenuto da estrarre.

Le regole di traduzione sono espresse in formato XML e memorizzate nelle seguenti posizioni possibili:

• /libs/settings/translation/rules/translation_rules.xml
• /apps/settings/translation/rules/translation_rules.xml
• /conf/global/settings/translation/rules/translation_rules.xml

Il file si applica a tutti i progetti di traduzione.

Le regole includono le seguenti informazioni:

• Percorso del nodo a cui si applica la regola. La regola si applica anche ai discendenti del nodo.
• Nomi delle proprietà del nodo che contengono il contenuto da tradurre. La proprietà può essere specifica per un tipo di risorsa specifico o per tutti i tipi di risorsa.

Ad esempio, puoi creare una regola che traduca il contenuto aggiunto dagli autori a tutti i componenti Testo di base AEM pagine. La regola può identificare il nodo /content e la proprietà text per il componente foundation/components/text.

È stata aggiunta una console per la configurazione delle regole di traduzione. Le definizioni nell’interfaccia utente compileranno il file per tuo conto.

Per una panoramica delle funzioni di traduzione dei contenuti in AEM, consulta Traduzione di contenuti per siti multilingue.

Sintassi delle regole per pagine, componenti e risorse

Una regola è un elemento node con uno o più elementi secondari property e uno o più elementi secondari node:

<node path="content path">
          <property name="property name" [translate="false"]/>
          <node resourceType="component path" >
               <property name="property name" [translate="false"]/>
          </node>
</node>

Ciascuno di questi elementi node ha le seguenti caratteristiche:

• L'attributo path contiene il percorso del nodo principale del ramo a cui si applicano le regole.

• Gli elementi secondari property identificano le proprietà del nodo da tradurre per tutti i tipi di risorse:

  • L'attributo name contiene il nome della proprietà.
  • L’attributo facoltativo translate è uguale a false se la proprietà non è tradotta. Per impostazione predefinita, il valore è true. Questo attributo è utile quando si ignorano le regole precedenti.

• Gli elementi secondari node identificano le proprietà del nodo da tradurre per tipi di risorse specifici:

  • L'attributo resourceType contiene il percorso che viene risolto nel componente che implementa il tipo di risorsa.
  • Gli elementi secondari property identificano la proprietà del nodo da tradurre. Usa questo nodo nello stesso modo degli elementi secondari property per le regole del nodo.

La regola di esempio seguente fa sì che il contenuto di tutte le proprietà text sia tradotto per tutte le pagine sotto il nodo /content. La regola è efficace per qualsiasi componente che memorizza il contenuto in una proprietà text , come il componente Testo di base e il componente Immagine di base.

<node path="/content?lang=it">
          <property name="text"/>
</node>

L’esempio seguente traduce il contenuto di tutte le proprietà text e anche altre proprietà del componente Immagine di base. Se altri componenti hanno proprietà con lo stesso nome, la regola non si applica ad essi.

<node path="/content?lang=it">
      <property name="text"/>
      <node resourceType="foundation/components/textimage">
         <property name="image/alt"/>
         <property name="image/jcr:description"/>
         <property name="image/jcr:title"/>
      </node>
</node>

Sintassi delle regole per l’estrazione di risorse dalle pagine

Utilizza la sintassi della regola seguente per includere le risorse incorporate nei componenti o a cui si fa riferimento da essi:

<assetNode resourceType="path to component" assetReferenceAttribute="property that stores asset"/>

Ogni elemento assetNode ha le seguenti caratteristiche:

• Un attributo resourceType uguale al percorso che viene risolto nel componente.
• Un attributo assetReferenceAttribute che è uguale al nome della proprietà che memorizza il binario della risorsa (per le risorse incorporate) o il percorso della risorsa di riferimento.

L’esempio seguente estrae le immagini dal componente Immagine di base:

<assetNode resourceType="foundation/components/image" assetReferenceAttribute="fileReference"/>

Regole di sovrascrittura

Il file translation_rules.xml è costituito da un elemento nodelist con diversi elementi secondari node. AEM legge l'elenco dei nodi dall'alto verso il basso. Quando più regole eseguono il targeting dello stesso nodo, viene utilizzata la regola inferiore nel file. Ad esempio, le seguenti regole fanno sì che tutto il contenuto delle proprietà text sia tradotto, ad eccezione del ramo /content/mysite/en delle pagine:

<nodelist>
     <node path="/content%E2%80%9D%3E%20%20%20%20%20%20%20%20%20%20%20%3Cproperty%20name?lang=it="text" />
     </node>
     <node path=“/content/mysite/en”>
          <property name=“text” translate=“false" />
     </node> 
<nodelist>

Proprietà filtro

Puoi filtrare i nodi con una proprietà specifica utilizzando un elemento filter .

Ad esempio, le seguenti regole fanno sì che tutto il contenuto delle proprietà text sia tradotto, ad eccezione dei nodi in cui la proprietà draft è impostata su true.

<nodelist>
    <node path="/content%E2%80%9D%3E%20%20%20%20%20%3Cfilter%3E%20%20%20%3Cnode%20containsProperty?lang=it="draft" propertyValue="true" />
     </filter>
        <property name="text" />
    </node>
<nodelist>

Interfaccia utente delle regole di traduzione

È disponibile anche una console per configurare le regole di traduzione.

Per accedervi:

1. Passa a Strumenti, quindi Generale.

   

2. Seleziona Configurazione traduzione.

   

Da qui, è possibile Aggiungere contesto. Questo consente di aggiungere un percorso.

Quindi devi selezionare il tuo contesto e quindi fare clic su Modifica. Verrà aperto l’Editor regole di traduzione.

Puoi modificare 4 attributi tramite l’interfaccia utente: isDeep, inherit, translate e updateDestinationLanguage.

​​isDeepQuesto attributo è applicabile sui filtri dei nodi ed è true per impostazione predefinita. Controlla se il nodo (o i suoi predecessori) contiene tale proprietà con il valore della proprietà specificato nel filtro. Se false, controlla solo il nodo corrente.

Ad esempio, i nodi figlio vengono aggiunti a un processo di traduzione anche quando il nodo principale ha la proprietà draftOnly impostata su true per contrassegnare il contenuto in bozza. Qui isDeep entra in gioco e controlla se i nodi principali hanno la proprietà draftOnly come true ed esclude tali nodi figlio.

Nell’editor, è possibile controllare/deselezionare Is Deep nella scheda Filtri.

Ecco un esempio del file xml risultante quando Is Deep è deselezionato nell'interfaccia utente:

 <filter>
    <node containsProperty="draftOnly" isDeep="false" propertyValue="true"/>
</filter>

​​inheritQuesto è applicabile alle proprietà. Per impostazione predefinita ogni proprietà viene ereditata, ma se si desidera che alcune proprietà non vengano ereditate sull'elemento secondario, è possibile contrassegnare tale proprietà come false in modo che venga applicata solo a quel nodo specifico.

Nell'interfaccia utente, è possibile selezionare/deselezionare Eredita nella scheda Proprietà .

​​translateL'attributo translate viene utilizzato semplicemente per specificare se tradurre o meno una proprietà.

Nell'interfaccia utente, è possibile selezionare/deselezionare Traduci nella scheda Proprietà .

​​updateDestinationLanguageQuesto attributo viene utilizzato per proprietà che non hanno testo ma codici lingua, ad esempio jcr:language. L'utente non traduce il testo, ma le impostazioni internazionali della lingua dall'origine alla destinazione. Tali proprietà non vengono inviate per la traduzione.

Nell'interfaccia utente, è possibile controllare/deselezionare Traduci nella scheda Proprietà , ma per le proprietà specifiche che hanno codici lingua come valore.

Per chiarire la differenza tra updateDestinationLanguage e translate, ecco un semplice esempio di contesto con due sole regole:

Il risultato nel file xml sarà simile al seguente:

<property inherit="true" name="text" translate="true" updateDestinationLanguage="false"/>
<property inherit="true" name="jcr:language" translate="false" updateDestinationLanguage="true"/>

Modifica manuale del file delle regole

Il file translation_rules.xml installato con AEM contiene un set predefinito di regole di traduzione. Puoi modificare il file per supportare i requisiti dei tuoi progetti di traduzione. Ad esempio, puoi aggiungere regole per tradurre il contenuto dei componenti personalizzati.

Se modifichi il file translation_rules.xml , mantieni una copia di backup in un pacchetto di contenuto. L'installazione AEM service pack o la reinstallazione di alcuni pacchetti AEM può sostituire il file translation_rules.xml corrente con l'originale. Per ripristinare le regole in questa situazione, puoi installare il pacchetto che contiene la copia di backup.

Esempio di file delle regole di traduzione

<nodelist>
    <!-- translation rules for Geometrixx Demo site (example) -->
    <node path="/content/geometrixx?lang=it">
        <!-- list all node properties that should be translated -->
        <property name="jcr:title" /> <!-- translation workflows running on content saved in /content/geometrixx, will extract jcr:title values independent of the component. -->
        <property name="jcr:description" />
        <node resourceType ="foundation/components/image"> <!-- translation workflows running on content saved in /content/geometrixx, will extract alternateText values only for Image component. -->
            <property name="alternateText"/>
        </node>
        <node resourceType ="geometrixx/components/title">
            <property name="richText"/>
            <property name="jcr:title" translate="false"/> <!-- translation workflows running on content saved in /content/geometrixx, will not extract jcr:title for Title component, but instead use richText. -->
        </node>
        <node pathContains="/cq:annotations?lang=it">
            <property name="text" translate="false"/> <!-- translation workflows running on content saved in /content/geometrixx, will not extract text if part of cq:annotations node. -->
        </node>
    </node>
    <!-- translation rules for Geometrixx Outdoors site (example) -->
    <node path="/content/geometrixx-outdoors?lang=it">
        <node resourceType ="foundation/components/image">
            <property name="alternateText"/>
            <property name="jcr:title" />
        </node>
        <node resourceType ="geometrixx-outdoors/components/title">
            <property name="richText"/>
        </node>
    </node>
    <!-- translation rules for ASSETS (example) -->
    <node path="/content/dam?lang=it">
        <!-- configure list of metadata properties here -->
        <property name="dc:title" />
        <property name="dc:description" />
    </node>
    <!-- translation rules for extracting ASSETS from SITES content, configure all components that embed or reference assets -->
    <assetNode resourceType="foundation/components/image" assetReferenceAttribute="fileReference"/>
    <assetNode resourceType="foundation/components/video" assetReferenceAttribute="asset"/>
    <assetNode resourceType="foundation/components/download" assetReferenceAttribute="fileReference"/>
    <assetNode resourceType="foundation/components/mobileimage" assetReferenceAttribute="fileReference"/>
    <assetNode resourceType="wcm/foundation/components/image" assetReferenceAttribute="fileReference"/>
</nodelist>