Konfigurieren von Übersetzungsregeln configure-translation-rules

Erfahren Sie, wie Sie Übersetzungsregeln definieren, um zu übersetzende Inhalte zu identifizieren.

Die bisherige Entwicklung story-so-far

Im vorherigen Dokument der Tour durch die AEM Headless-Übersetzung, Übersetzungs-Integration konfigurieren, haben Sie gelernt, wie Sie Ihre Übersetzungs-Integration installieren und konfigurieren. Sie sollten jetzt:

  • die wichtigen Parameter des Translation Integration Framework in AEM verstehen.
  • In der Lage sein, Ihre eigene Verbindung zu Ihrem Übersetzungsdienst einzurichten.

Nachdem Sie Ihre Integration eingerichtet haben, führt Sie dieser Artikel durch den nächsten Schritt, um herauszufinden, welche Inhalte übersetzt werden müssen.

CAUTION
Dieser Schritt der Dokumentations-Tour ist nur erforderlich, wenn Sie die Markierung Übersetzbar für Inhaltsfragmente nicht verwenden.
  • Die Markierung Übersetzbar erstellt automatisch Übersetzungsregeln für Sie und erfordert kein Eingreifen.
  • Die Markierung Übersetzbar wird nur verwendet, wenn die Konfiguration des Übersetzungsintegrations-Frameworks auf Inhaltsmodellfelder für die Übersetzung aktivieren festgelegt ist.
  • Durch Aktivierung dieser Option in der TIF-Konfiguration werden alle manuell erstellten Übersetzungsregeln ersetzt.|

Ziel objective

In diesem Dokument erfahren Sie, wie Sie die Übersetzungsregeln von AEM zur Identifizierung Ihres Übersetzungsinhalts nutzen. Nach dem Lesen dieses Dokuments sollten Sie Folgendes können:

  • Verstehen, was die Übersetzungsregeln bewirken.
  • Eigene Übersetzungsregeln definieren können.

Übersetzungsregeln translation-rules

Inhaltsfragmente, die Ihre Headless-Inhalte darstellen, können viele Informationen enthalten, die durch strukturierte Felder organisiert sind. Entsprechend Ihren Projektanforderungen müssen wahrscheinlich nicht alle Felder in einem Inhaltsfragment übersetzt werden.

Übersetzungsregeln identifizieren die Inhalte, die in Übersetzungsprojekten enthalten oder von diesen ausgeschlossen sind. Wenn Inhalte übersetzt werden, extrahiert AEM den Inhalt oder sammelt ihn anhand dieser Regeln. Auf diese Weise werden nur Inhalte an den Übersetzungs-Service gesendet, die übersetzt werden müssen.

Die Übersetzungsregeln umfassen die folgenden Informationen:

  • Den Pfad der Inhalte, auf die die Regel angewendet wird
    • Die Regel gilt auch für die nachfolgenden Elemente der Inhalte
  • Die Namen der Eigenschaften, die die zu übersetzenden Inhalte enthalten
    • Die Eigenschaft kann sich speziell auf einen bestimmten Ressourcentyp oder auf alle Ressourcentypen beziehen

Da Inhaltsfragmentmodelle, die die Struktur Ihrer Inhaltsfragmente definieren, für Ihr eigenes Projekt eindeutig sind, ist es wichtig, Übersetzungsregeln einzurichten. So weiß AEM, welche Elemente Ihrer Inhaltsmodelle übersetzt werden sollen.

TIP
Im Allgemeinen stellt die Inhaltsarchitektin bzw. der Inhaltsarchitekt der Person, die auf die Übersetzung spezialisiert ist, die Eigenschaftsnamen aller Felder zur Verfügung, die für die Übersetzung benötigt werden. Diese Namen sind erforderlich, um Übersetzungsregeln zu konfigurieren. Als Übersetzungsspezialist können Sie diese Eigenschaftsnamen selbst finden, wie zuvor in dieser Tour beschrieben.

Erstellen von Übersetzungsregeln creating-rules

Sie können mehrere Regeln erstellen, um komplexe Übersetzungsanforderungen zu unterstützen. Beispielsweise müssen für ein Projekt, an dem Sie arbeiten, alle Felder des Modells übersetzt werden, für ein anderes müssen nur Beschreibungsfelder übersetzt werden, während Titel unübersetzt bleiben.

Übersetzungsregeln sind für solche Szenarien konzipiert. In diesem Beispiel veranschaulichen wir jedoch, wie Regeln erstellt werden, indem wir uns auf eine einfache, einzelne Konfiguration konzentrieren.

Es gibt eine Übersetzungskonfigurations-Konsole, die zum Konfigurieren von Übersetzungsregeln verfügbar ist. So können Sie darauf zugreifen:

  1. Gehen Sie zu  Tools  >  Allgemein.
  2. Wählen Sie Übersetzungskonfiguration aus.

In der Benutzeroberfläche der Übersetzungskonfiguration stehen verschiedene Optionen für Ihre Übersetzungsregeln zur Verfügung. Hier werden die wichtigsten und typischsten Schritte hervorgehoben, die für eine einfache Headless-Lokalisierungskonfiguration erforderlich sind.

  1. Wählen Sie zum Hinzufügen eines Pfads Kontext hinzufügen aus. Dies ist der Pfad der Inhalte, die von der Regel betroffen sind.
    Kontext hinzufügen

  2. Verwenden Sie den Pfad-Browser, um den erforderlichen Pfad auszuwählen und wählen Sie Bestätigen aus, um ihn zu speichern. Denken Sie daran, dass Inhaltsfragmente, die Headless-Inhalte enthalten, sich im Allgemeinen unter /content/dam/<your-project> befinden.
    Pfad auswählen

  3. Wählen Sie den erstellten Kontext und dann Bearbeiten aus. Dadurch wird der Editor für Übersetzungsregeln geöffnet, in dem die Eigenschaften konfiguriert werden können.
    Editor für Übersetzungsregeln

  4. Standardmäßig werden alle Konfigurationen vom übergeordneten Pfad übernommen, in diesem Fall /content/dam. Deaktivieren Sie die Option Übernehmen von/content/dam, um der Konfiguration zusätzliche Felder hinzuzufügen.

  5. Ist diese Option deaktiviert, fügen Sie im Abschnitt Allgemein der Liste die Eigenschaftsnamen der Inhaltsfragmentmodelle hinzu, die Sie zuvor als zu übersetzende Felder identifiziert haben.

    1. Geben Sie den Eigenschaftsnamen in das Feld Neue Eigenschaft ein. Die Optionen Übersetzen und Übernehmen werden automatisch aktiviert.
    2. Wählen Sie Hinzufügen.
    3. Wiederholen Sie diese Schritte für alle Felder, die Sie übersetzen müssen.
    4. Wählen Sie Speichern aus.
      Eigenschaft hinzufügen

Sie haben jetzt Ihre Übersetzungsregeln konfiguriert.

Erweiterte Verwendung advanced-usage

Es gibt verschiedene weitere Eigenschaften, die als Teil Ihrer Übersetzungsregeln konfiguriert werden können. Darüber hinaus können Sie Ihre Regeln manuell als XML spezifizieren, was mehr Spezifität und Flexibilität ermöglicht.

Solche Funktionen sind im Allgemeinen nicht erforderlich, um mit der Lokalisierung Ihrer Headless-Inhalte zu beginnen. Sie finden jedoch weitere Informationen dazu im Abschnitt Zusätzliche Ressourcen, wenn Sie Interesse haben.

Wie geht es weiter what-is-next

Nachdem Sie nun diesen Teil der Headless-Übersetzungs-Tour abgeschlossen haben, sollten Sie:

  • Verstehen, was die Übersetzungsregeln bewirken.
  • Eigene Übersetzungsregeln definieren können.

Bauen Sie auf diesem Wissen auf und setzen Sie Ihre Tour durch die AEM-Headless-Übersetzung fort, indem Sie als Nächstes das Dokument Übersetzen von Inhalten lesen, in dem Sie erfahren, wie Ihre Integration und Ihre Regeln zusammenarbeiten, um Headless-Inhalte zu übersetzen.

Zusätzliche Ressourcen additional-resources

Es wird empfohlen, mit dem nächsten Teil der Headless-Übersetzungs-Tour fortzufahren, indem Sie das Dokument Inhalte übersetzen lesen. Im Folgenden finden Sie einige zusätzliche optionale Ressourcen, die einige in diesem Dokument erwähnte Konzepte vertiefen. Sie sind jedoch nicht erforderlich, um mit der Headless-Tour fortzufahren.

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab