Te vertalen inhoud identificeren identifying-content-to-translate

De vertaalregels identificeren de inhoud om voor pagina's, componenten, en activa te vertalen die in, of van, vertaalprojecten inbegrepen zijn. Wanneer een pagina of element wordt vertaald, extraheert AEM deze inhoud zodat deze naar de vertaalservice kan worden verzonden.

Pagina's en elementen worden weergegeven als knooppunten in de JCR-opslagplaats. De inhoud die wordt geëxtraheerd, is een of meer eigenschapwaarden van de knooppunten. De vertaalregels identificeren de eigenschappen die de te extraheren inhoud bevatten.

De omzettingsregels worden uitgedrukt in het formaat van XML en in deze mogelijke plaatsen opgeslagen:

Het bestand is van toepassing op alle vertaalprojecten.

De regels omvatten de volgende informatie:

U kunt bijvoorbeeld een regel maken die de inhoud vertaalt die auteurs aan alle AEM basistekstcomponenten op uw pagina's toevoegen. De regel kan de /content en de text eigenschap voor de foundation/components/text component.

Er is een console dat is toegevoegd voor het vormen van vertaalregels. De definities in UI zullen het dossier voor u bevolken.

Voor een overzicht van de vertaalfuncties voor inhoud in AEM raadpleegt u Inhoud vertalen voor meertalige sites.

De Syntaxis van de regel voor Pagina's, Componenten, en Activa rule-syntax-for-pages-components-and-assets

Een regel is een node element met een of meer onderliggende elementen property elementen en nul of meer onderliggende elementen node elementen:

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

Elk van deze node elementen hebben de volgende kenmerken:

De volgende voorbeeldregel veroorzaakt de inhoud van allen text eigenschappen die moeten worden vertaald voor alle pagina's onder de /content knooppunt. De regel is effectief voor elke component die inhoud in een text eigenschap, zoals de component Foundation Text en de component foundation Image.

<node path="/content">
          <property name="text"/>
</node>

In het volgende voorbeeld wordt de inhoud van alle text eigenschappen, en ook andere eigenschappen van de component van het stichtingsbeeld vertalen. Als andere componenten eigenschappen met dezelfde naam hebben, is de regel niet op hen van toepassing.

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

Regelsyntaxis voor het uitnemen van elementen van pagina's rule-syntax-for-extracting-assets-from-pages

Gebruik de volgende regelsyntaxis om elementen op te nemen die zijn ingesloten in of waarnaar wordt verwezen vanuit componenten:

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

Elk assetNode element heeft de volgende kenmerken:

In het volgende voorbeeld worden afbeeldingen geëxtraheerd uit de basiscomponent Image:

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

Regels overschrijven overriding-rules

Het bestand translate_rules.xml bestaat uit een nodelist element met meerdere onderliggende elementen node elementen. AEM leest de nodenlijst van boven naar beneden. Wanneer de veelvoudige regels de zelfde knoop richten, wordt de regel die lager in het dossier is gebruikt. De volgende regels veroorzaken bijvoorbeeld alle inhoud in text eigenschappen die moeten worden vertaald, met uitzondering van de /content/mysite/en vertakking van pagina's:

<nodelist>
     <node path="/content”>
           <property name="text" />
     </node>
     <node path=“/content/mysite/en”>
          <property name=“text” translate=“false" />
     </node>
<nodelist>

Filtereigenschappen filtering-properties

U kunt knooppunten met een specifieke eigenschap filteren met een filter element.

De volgende regels veroorzaken bijvoorbeeld alle inhoud in text te vertalen eigenschappen, behalve de knooppunten die de eigenschap hebben draft instellen op true.

<nodelist>
    <node path="/content”>
     <filter>
   <node containsProperty="draft" propertyValue="true" />
     </filter>
        <property name="text" />
    </node>
<nodelist>

Interface voor vertaalregels translation-rules-ui

Een console is ook beschikbaar voor het vormen van vertaalregels.

Toegang tot dit bestand:

Vanaf hier kunt u Context toevoegen. Zo kunt u een pad toevoegen.

Selecteer vervolgens de context en klik op Bewerken. Hiermee opent u de Editor voor de vertaalregels.

Er zijn vier kenmerken die u kunt wijzigen via de gebruikersinterface: isDeep, inherit, translate en updateDestinationLanguage.

isDeep Dit kenmerk is van toepassing op knooppuntfilters en is standaard true. Het controleert of de knoop (of zijn voorouders) die bezit met de gespecificeerde bezitswaarde in de filter bevat. Indien false, wordt alleen het huidige knooppunt gecontroleerd.

Bijvoorbeeld, worden de kindknopen toegevoegd in een vertaalbaan zelfs wanneer de ouderknoop bezit draftOnly is ingesteld op true om concepten te markeren. hier isDeep komt in spel en controleert als de ouderknopen bezit hebben draftOnly als true en sluit die onderliggende knooppunten uit.

In de Editor kunt u in- of uitschakelen Is Deep in de Filters tab.

Hier is een voorbeeld van de resulterende xml wanneer Is diep is uitgeschakeld in de gebruikersinterface:

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

erven Dit is van toepassing op eigenschappen. Standaard wordt elke eigenschap overgeërfd, maar als u wilt dat een eigenschap niet op het onderliggende element wordt overgeërfd, kunt u die eigenschap als onwaar markeren, zodat deze alleen op dat specifieke knooppunt wordt toegepast.

In de UI kunt u controleren/uncheck Overnemen in de Eigenschappen tab.

vertalen Het attribuut translate wordt gebruikt eenvoudig om te specificeren of om een bezit al dan niet te vertalen.

In de UI kunt u controleren/uncheck Vertalen in de Eigenschappen tab.

updateDestinationLanguage Dit kenmerk wordt gebruikt voor eigenschappen die geen tekst maar taalcodes hebben, bijvoorbeeld jcr:language. De gebruiker vertaalt geen tekst maar de taallandinstelling van bron tot doel. Dergelijke eigenschappen worden niet verzonden voor vertaling.

In de UI kunt u controleren/uncheck Vertalen in de Eigenschappen , maar voor de specifieke eigenschappen die taalcodes als waarde hebben.

Ter verduidelijking van het verschil tussen updateDestinationLanguage en translateHier is een eenvoudig voorbeeld van een context met slechts twee regels:

Het resultaat in de xml ziet er als volgt uit:

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

Het bestand Regels handmatig bewerken editing-the-rules-file-manually

Het bestand translatie_rules.xml dat met AEM is geïnstalleerd, bevat een standaardset vertaalregels. U kunt het bestand bewerken ter ondersteuning van de vereisten van uw vertaalprojecten. U kunt bijvoorbeeld regels toevoegen zodat de inhoud van uw aangepaste componenten wordt vertaald.

Als u het bestand translatie_rules.xml bewerkt, moet u een reservekopie bewaren in een inhoudspakket. Het installeren AEM de dienstpakken of het opnieuw installeren van bepaalde AEM pakketten kunnen het huidige vertaling_rules.xml- dossier met origineel vervangen. Om uw regels in deze situatie te herstellen, kunt u het pakket installeren dat uw reservekopie bevat.

Voorbeeld omzettingsregels-bestand example-translation-rules-file

<nodelist>
    <!-- translation rules for Geometrixx Demo site (example) -->
    <node path="/content/geometrixx">
        <!-- 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">
            <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">
        <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">
        <!-- 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>