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.

Inhoudsfragmenten en vertaalregels content-fragments

De vertaalregels die in dit document worden beschreven zijn op de Fragmenten van de Inhoud slechts van toepassing als de ModelGebieden van de Inhoud voor Vertaling optie niet op het niveau van de het kader van de vertaalintegratie zijn geactiveerd.

Als laat de ModelGebieden van de Inhoud voor Vertaling optie toe actief is, AEM zal het Vertaalbare gebied op Modellen van het Fragment van de Inhoudgebruiken om te bepalen als het gebied moet worden vertaald en creeert automatisch vertaalregels dienovereenkomstig. Deze optie vervangt de vertaalregels die u hebt gemaakt en vereist geen interventie of extra stappen.

Als u vertaalregels voor het vertalen van uw Fragmenten van de Inhoud wilt gebruiken, laat de ModelGebieden van de Inhoud voor Vertaling optie op de configuratie van het het kader van de vertaalintegratie toe moet worden onbruikbaar gemaakt en u moet de hieronder geschetste stappen volgen om uw regels tot stand te brengen.

Overzicht overview

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 inhoud bevatten die moet worden geëxtraheerd.

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 tekstcomponenten op uw pagina's toevoegen. De regel kan de node /content en de eigenschap text voor de component core/wcm/components/text/v2/text identificeren.

Er is a consoledie voor het vormen vertaalregels is toegevoegd. De definities in UI zullen het dossier voor u bevolken.

Voor een overzicht van de eigenschappen van de inhoudsomzetting in AEM, zie Vertaal Inhoud voor Meertalige Plaatsen.

Syntaxis van regels voor pagina's, componenten en Assets rule-syntax-for-pages-components-and-assets

Een regel is een node -element met een of meer onderliggende property -elementen en nul of meer onderliggende 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 heeft de volgende kenmerken:

De volgende voorbeeldregel zorgt ervoor dat de inhoud van alle text -eigenschappen wordt vertaald voor alle pagina's onder de /content -node. De regel is effectief voor elke component die inhoud in een eigenschap text opslaat, zoals de tekstcomponent.

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

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

<node path="/content">
      <property name="text"/>
      <node resourceType="core/wcm/components/image/v2/image">
         <property name="image/alt"/>
         <property name="image/jcr:description"/>
         <property name="image/jcr:title"/>
      </node>
</node>

Regelsyntaxis voor het uitnemen van Assets 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 uit de afbeeldingscomponent geëxtraheerd:

<assetNode resourceType="core/wcm/components/image/v2/image" assetReferenceAttribute="fileReference"/>

Regels overschrijven overriding-rules

Het translation_rules.xml -bestand bestaat uit een nodelist -element met verschillende onderliggende 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 zorgen er bijvoorbeeld voor dat alle inhoud in text -eigenschappen wordt vertaald, behalve 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 element filter .

De volgende regels zorgen er bijvoorbeeld voor dat alle inhoud in text -eigenschappen wordt omgezet, behalve de knooppunten waarvoor de eigenschap draft is ingesteld op true .

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

UI voor omzettingsregels translation-rules-ui

Een console is ook beschikbaar voor het vormen van vertaalregels.

Toegang tot dit bestand:

In de interface met vertaalregels kunt u:

Er zijn vier attributen die u via UI kunt veranderen:

isDeep isdeep

isDeep 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.

Onderliggende knooppunten worden bijvoorbeeld toegevoegd aan een vertaaltaak, zelfs als de eigenschap draftOnly van het bovenliggende knooppunt is ingesteld op true om de conceptinhoud te markeren. Hier wordt isDeep afgespeeld en wordt gecontroleerd of de bovenliggende knooppunten de eigenschap draftOnly true hebben en of deze onderliggende knooppunten worden uitgesloten.

In de redacteur, kunt u controleren/uncheck is Diep in de Filters tabel.

Hier is een voorbeeld van resulterende XML wanneer Diep is ongecontroleerd in UI:

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

erven inherit

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

In UI, kunt u controleren/uncheck erven in Eigenschappen tabel.

vertalen translate

translate wordt gebruikt om eenvoudig op te geven of een eigenschap al dan niet moet worden omgezet.

In UI, kunt u controleren/uncheck vertalen in het Eigenschappen lusje.

updateDestinationLanguage updatedestinationlanguage

updateDestinationLanguage 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 UI, kunt u controleren/uncheck in het lusje van Eigenschappen om deze waarde te wijzigen, maar voor de specifieke eigenschappen die taalcodes als waarde hebben.

Voor meer duidelijkheid over het verschil tussen updateDestinationLanguage en translate is dit 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 translation_rules.xml -bestand 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 translation_rules.xml -bestand bewerkt, moet u een reservekopie bewaren in een inhoudspakket. Als u bepaalde AEM opnieuw installeert, wordt het huidige translation_rules.xml -bestand vervangen door het origineel. Om uw regels in deze situatie te herstellen, kunt u het pakket installeren dat uw reservekopie bevat.

Voorbeeld omzettingsregels-bestand example-translation-rules-file

<?xml version="1.0" encoding="UTF-8"?><nodelist>
  <node path="/content">
    <property name="addLabel"/>
    <property name="allowedResponses"/>
    <property name="alt"/>
    <property name="attachFileLabel"/>
    <property name="benefits"/>
    <property name="buttonLabel"/>
    <property name="chartAlt"/>
    <property name="confirmationMessageToggle"/>
    <property name="confirmationMessageUntoggle"/>
    <property name="constraintMessage"/>
    <property name="contentLabel"/>
    <property name="denyText"/>
    <property name="detailDescription"/>
    <property name="emptyText"/>
    <property name="helpMessage"/>
    <property name="image/alt"/>
    <property name="image/jcr:description"/>
    <property name="image/jcr:title"/>
    <property name="jcr:description"/>
    <property name="jcr:title"/>
    <property name="heading"/>
    <property name="label"/>
    <property name="main"/>
    <property name="listLabel"/>
    <property name="moreText"/>
    <property name="pageTitle"/>
    <property name="placeholder"/>
    <property name="requiredMessage"/>
    <property name="resetTitle"/>
    <property name="subjectLabel"/>
    <property name="subtitle"/>
    <property name="tableData"/>
    <property name="text"/>
    <property name="title"/>
    <property name="navTitle"/>
    <property name="titleDivContent"/>
    <property name="toggleLabel"/>
    <property name="transitionLabel"/>
    <property name="untoggleLabel"/>
    <property name="name"/>
    <property name="occupations"/>
    <property name="greetingLabel"/>
    <property name="signInLabel"/>
    <property name="signOutLabel"/>
    <property name="pretitle"/>
    <property name="cq:panelTitle"/>
    <property name="actionText"/>
    <property name="cq:language" updateDestinationLanguage="true"/>
    <node pathContains="/cq:annotations">
      <property name="text" translate="false"/>
    </node>
    <node path="/content/wknd"/>
  </node>
  <node path="/content/forms">
    <property name="text" translate="false"/>
  </node>
  <node path="/content/dam">
    <property name="dc:description"/>
    <property name="dc:rights"/>
    <property name="dc:subject"/>
    <property name="dc:title"/>
    <property name="defaultContent"/>
    <property name="jcr:description"/>
    <property name="jcr:title"/>
    <property name="pdf:Title"/>
    <property name="xmpRights:UsageTerms"/>
    <property name="main"/>
    <property name="adventureActivity"/>
    <property name="adventureDescription"/>
    <property name="adventureDifficulty"/>
    <property name="adventureGearList"/>
    <property name="adventureGroupSize"/>
    <property name="adventureItinerary"/>
    <property name="adventurePrice"/>
    <property name="adventureTitle"/>
    <property name="adventureTripLength"/>
    <property name="adventureType"/>
    <node pathContains="/jcr:content/metadata/predictedTags">
      <property name="name"/>
    </node>
  </node>
  <assetNode assetReferenceAttribute="fragmentPath" resourceType="cq/experience-fragments/editor/components/experiencefragment"/>
  <assetNode assetReferenceAttribute="fragmentVariationPath" resourceType="core/wcm/components/experiencefragment/v1/experiencefragment"/>
  <assetNode assetReferenceAttribute="fileReference" resourceType="dam/cfm/components/contentfragment"/>
  <assetNode resourceType="docs/components/download"/>
  <assetNode resourceType="docs/components/image"/>
  <assetNode assetReferenceAttribute="fileReference" resourceType="foundation/components/image"/>
  <assetNode assetReferenceAttribute="asset" resourceType="foundation/components/video"/>
  <assetNode assetReferenceAttribute="fileReference" resourceType="foundation/components/download"/>
  <assetNode assetReferenceAttribute="fileReference" resourceType="core/wcm/components/download/v1/download"/>
  <assetNode assetReferenceAttribute="fileReference" resourceType="wcm/foundation/components/image"/>
  <assetNode assetReferenceAttribute="fragmentPath" resourceType="core/wcm/components/contentfragment/v1/contentfragment"/>
  <assetNode assetReferenceAttribute="fileReference" resourceType="core/wcm/components/image/v2/image"/>
</nodelist>