Ordnen Sie übersetzte Dokumentseiten anhand ihres gemeinsamen Inhalts und Zwecks zu und halten Sie anschließend die genaue URL jeder Sprache fest. Unterschiedliche Slugs sind kein Problem. Dieser Mac-Workflow hilft Redakteuren öffentlicher Dokumente, diese Zuordnung zu erstellen und korrekte Sprachlinks und Suchanmerkungen vorzubereiten.

Warum übereinstimmende Slugs nicht nötig sind

Angenommen, ein englisches Dokument erklärt, wie man ein Raster aus farbigen Quadraten anordnet. Die französische Übersetzung beschreibt dieselbe Aufgabe, aber die beiden Adressen enden unterschiedlich. Google erlaubt ausdrücklich lokalisierte Wörter in URLs und empfiehlt separate URLs für verschiedene Sprachversionen. Sie müssen die Übersetzungen nicht umbenennen, damit ihre Pfade übereinstimmen. Verwaltung mehrregionaler und mehrsprachiger Websites.

Es gibt zwei getrennte Fragen: „Sind diese URLs identisch?“ und „Sind diese Dokumente Übersetzungen voneinander?“ Der WHATWG-URL-Standard definiert die URL-Gleichheit durch den Vergleich serialisierter URLs. Dieser Vergleich stellt keine Übersetzungsbeziehung zwischen unterschiedlichen Adressen fest. Ermitteln Sie für diesen Workflow die Beziehung anhand der Dokumente und halten Sie sie anschließend ausdrücklich fest. URL-Standard, URL-Äquivalenz.

Die folgenden Beispiele sind synthetische Adressen öffentlicher Dokumente unter example.com; sie veranschaulichen eine vorgeschlagene Zuordnung und keine live abgerufenen Seiten. Ziel ist es, gleichwertige englische und französische Anleitungen miteinander zu verknüpfen und dabei die bestehende Adresse jeder Seite beizubehalten.

Erstellen Sie einen Zuordnungsdatensatz auf Ihrem Mac

Beginnen Sie mit einem Dokumentenpaar. Lassen Sie die Ausgangsseite und die vorgeschlagene Übersetzung in separaten Safari-Tabs geöffnet, daneben ein lokales Zuordnungsdokument. Sie benötigen den vollständigen Text beider Versionen und für die spätere Umsetzung Zugriff auf die Veröffentlichungseinstellungen, über die Sprachbeziehungen oder Seitenmetadaten gesteuert werden.

Erfassen Sie die genauen Adressen

Drücken Sie in Safari Command-L, um das Smart Search field auszuwählen, und anschließend Command-C, um die Adresse zu kopieren. Wiederholen Sie dies für die Übersetzung, nachdem sie vollständig geladen wurde. Apple dokumentiert beide Kurzbefehle. Wenn Sie die nach der Navigation erreichte Adresse festhalten, können Sie außerdem eine unerwartete Zielseite erkennen. Tastaturkurzbefehle und Gesten in Safari auf dem Mac.

Für eine kleine Sammlung genügt TextEdit. Erstellen Sie ein neues Dokument, wählen Sie Format > Make Plain Text und speichern Sie es als translation-map.txt. Beim Umwandeln eines bestehenden Rich-Text-Dokuments wird dessen Formatierung entfernt. Verwenden Sie deshalb für diesen Datensatz ein neues Dokument. Diese Schritte entsprechen Apples TextEdit-Anleitung. Dokumente in TextEdit auf dem Mac erstellen, öffnen und konvertieren.

Verwenden Sie eine stabile Dokument-ID, die die zugrunde liegende Aufgabe beschreibt. Der folgende vollständige Beispieldatensatz ist keine Konfigurationsdatei, die ein Veröffentlichungssystem automatisch einliest:

Dokument-ID: tile-grid
Aufgabe für Leser: Ein Raster aus vier Spalten mit farbigen Quadraten anordnen
Englische URL: https://example.com/en/docs/arrange-tiles
Französische URL: https://example.com/fr/guides/disposer-les-carres
Englischer Sprachcode: en
Französischer Sprachcode: fr
Prüfung des Umfangs: Gleiche Anleitungen, Abbildung und Dokumentausgabe
Zuordnungsentscheidung: Übersetzungspaar

Die ID dient als Anker, wenn sich Titel oder Slugs ändern. Führen Sie die Adressen als getrennte Felder und leiten Sie keine aus der anderen ab. Wenn Sie in diesem Beispiel /en/ durch /fr/ ersetzen, erhalten Sie eine ungeprüfte Adresse und übersehen den tatsächlichen Pfad der Übersetzung.

Prüfen Sie, ob die Dokumente dieselbe Aufgabe erfüllen

Vergleichen Sie Einleitung, Anleitungen, Beschriftungen der Abbildungen, Beispiele und Ausgabe. Übersetzte Titel müssen sich nicht Wort für Wort ähneln. Fragen Sie stattdessen, ob Leser, die zur anderen Sprache wechseln, gleichwertige Anleitungen für dieselbe Tätigkeit erhalten.

Nutzen Sie diese Entscheidungstabelle, bevor Sie eine Seite in die Zuordnung aufnehmen. Sie dient als redaktionelle Orientierung, um alternative Versionen desselben Inhalts zu ermitteln:

Was Sie vorfinden Zuordnungsentscheidung
Dieselben Rasteranleitungen und dieselbe Ausgabe, mit übersetztem Text Als Übersetzungspaar erfassen
Eine Seite behandelt Raster, die andere die Farbauswahl Als getrennte Dokumente führen
Eine Übersetzung beschreibt eine frühere Ausgabe Den Ausgabenunterschied klären, bevor Sie sie gruppieren
Nur die Navigation ist übersetzt Das Hauptdokument nicht als vollständig übersetzt erfassen
Es gibt kein entsprechendes Dokument Diese Sprache in der Zuordnung dieses Dokuments auslassen

Ein französischer Überblick, der auf mehrere Zeichenaktivitäten verweist, würde zum Beispiel die konkreten englischen Rasteranleitungen nicht ersetzen. Erfassen Sie die fehlende Übersetzung als offene Inhaltsaufgabe. Ein allgemeines Ziel kann weiterhin als Navigation nützlich sein, bietet aber nicht das gleichwertige Dokument, das diese Zuordnung erfordert.

Verknüpfen Sie die zugeordneten Seiten für Leser und Google

Ihr lokaler Datensatz ist die redaktionelle Quelle für die Beziehung. Auch die veröffentlichten Seiten benötigen eine Möglichkeit, sie auszudrücken. Beginnen Sie mit sichtbaren Sprachlinks, über die Leser direkt zur zugeordneten Entsprechung gelangen. Google empfiehlt Links zwischen Sprachversionen, damit Leser selbst wählen können, und rät von automatischen Weiterleitungen aufgrund einer vermuteten Sprache ab. Verwaltung mehrregionaler und mehrsprachiger Websites.

Für Suchanmerkungen unterstützt Google drei gleichwertige Methoden: HTML-Elemente, HTTP-Antwortheader und XML-Sitemaps. Wählen Sie eine Methode, die sich gut pflegen lässt. Jede Sprachversion sollte sich selbst und ihre Alternativen mit vollständig qualifizierten URLs angeben und wechselseitige Links enthalten. Google über lokalisierte Versionen Ihrer Seite informieren.

Bereiten Sie für HTML-Seiten die Alternativlinks vor

Der WHATWG-HTML-Standard legt fest, dass alternate mit einem anderen Wert für hreflang eine Übersetzung kennzeichnet. Hier sehen Sie einen HTML-Metadatenabschnitt für das synthetische Paar. Er gehört in das vorhandene head-Element jeder Seite. Es handelt sich nicht um ein vollständiges HTML-Dokument. HTML-Standard, Linktyp „alternate“.

<link rel="alternate" hreflang="en" href="https://example.com/en/docs/arrange-tiles">
<link rel="alternate" hreflang="fr" href="https://example.com/fr/guides/disposer-les-carres">

Fügen Sie dasselbe Paar auf beiden Seiten ein. Die Ziel-URLs bleiben unterschiedlich, einschließlich ihrer Slugs. Laut der Google-Dokumentation sind Rücklinks erforderlich; außerdem werden sprachspezifische Codes wie en und fr unterstützt. Google über lokalisierte Versionen Ihrer Seite informieren.

Verwenden Sie für PDFs eine unterstützte Veröffentlichungsmethode

Ein PDF kann den vorherigen Abschnitt nicht in ein HTML-head aufnehmen. Google dokumentiert HTTP-Link-Antwortheader für Dateien, die keine HTML-Dateien sind. Für ein synthetisches PDF-Paar würde das vollständige Headerfeld so aussehen: Google über lokalisierte Versionen Ihrer Seite informieren.

Link: <https://example.com/en/files/tile-grid.pdf>; rel="alternate"; hreflang="en", <https://example.com/fr/fichiers/grille-de-carres.pdf>; rel="alternate"; hreflang="fr"

Richten Sie dieses Feld für die Antwort jedes PDFs ein. RFC 8288 definiert die HTTP-Verknüpfungssyntax, einschließlich des Ziels in spitzen Klammern und des Parameters hreflang. Dies sind Antwortseinstellungen. Den Header in den sichtbaren Text des PDFs einzutragen, konfiguriert ihn nicht. RFC 8288: Web Linking.

Wenn Ihr Veröffentlichungssystem HTML-Metadaten oder Antwortheader nicht bearbeiten kann, unterstützt Google auch eine Sitemap mit Sprachanmerkungen. Jeder URL-Eintrag führt alle Versionen auf, einschließlich sich selbst. Verwenden Sie die dokumentierte Sitemap-Struktur über Ihr Veröffentlichungssystem oder dessen Betreuer. Eine lokale Zuordnungsdatei allein setzt keine dieser Methoden um. Google über lokalisierte Versionen Ihrer Seite informieren.

Halten Sie Übersetzungsbeziehungen getrennt von Weiterleitungen und Canonicals

Eine Sprachalternative, eine bevorzugte doppelte URL und eine verschobene Seite stehen für unterschiedliche Beziehungen. Wenn Sie sie auseinanderhalten, vermeiden Sie, dass eine gut gemeinte Änderung an der Zuordnung Leser von dem Dokument wegführt, das sie ausgewählt haben.

Mechanismus Dokumentierter Zweck Anwendung für diese Aufgabe
rel="alternate" mit hreflang Sprachalternativen kennzeichnen Die zugeordneten Übersetzungen verknüpfen
rel="canonical" Eine bevorzugte URL unter doppelten oder sehr ähnlichen Seiten kennzeichnen Doppelte Adressen innerhalb der jeweiligen Sprache behandeln
Location in einer Weiterleitungsantwort Das Ziel der Weiterleitung angeben Eine verschobene Adresse behandeln
Content-Language Die vorgesehene Sprachzielgruppe der Repräsentation beschreiben Die Zielgruppe der Antwort kennzeichnen
Content-Location Die Ressource angeben, die der enthaltenen Repräsentation entspricht Den Speicherort der Repräsentation beschreiben

Google empfiehlt bei Verwendung von hreflang ein Canonical in derselben Sprache oder, falls es keines gibt, den bestmöglichen Ersatz. Für diese eigenständigen übersetzten Dokumente ist ein Canonical, das auf die bevorzugte URL der jeweiligen Sprache verweist, eine einfache Umsetzung. Verweisen Sie das französische Canonical nicht auf Englisch, nur weil das Dokument zuerst auf Englisch verfasst wurde. So legen Sie eine Canonical-URL mit rel="canonical" und anderen Methoden fest.

RFC 9110 definiert Location in Weiterleitungsantworten, Content-Language und Content-Location getrennt voneinander. Letzteres sind Metadaten zur Repräsentation und kein Ersatz für die Ziel-URL. Keines dieser Felder führt für sich allein das Übersetzungspaar dieses Dokuments auf. Verwenden Sie für diese Beziehung weiterhin die Alternativlinks. RFC 9110: HTTP-Semantik.

Prüfen Sie beide Richtungen und pflegen Sie die Zuordnung

Gehen Sie die folgenden Prüfungen durch, bevor Sie die Zuordnung zur Umsetzung übergeben. Wiederholen Sie sie nach späteren Änderungen an der Veröffentlichung anhand der öffentlichen Ausgabe; ein korrekter Datensatz und korrekte veröffentlichte Metadaten sind zwei verschiedene Dinge.

  1. Öffnen Sie beide erfassten Adressen und vergleichen Sie den tatsächlichen Dokumentinhalt.
  2. Folgen Sie dem sichtbaren Sprachlink von Englisch zu Französisch und anschließend zurück. Prüfen Sie, ob jedes Ziel die konkrete Entsprechung ist.
  3. Vergleichen Sie die konfigurierten Alternativ-URLs Zeichen für Zeichen mit dem Zuordnungsdatensatz.
  4. Bestätigen Sie, dass beide Versionen dieselbe Übersetzungsgruppe angeben, einschließlich sich selbst.
  5. Prüfen Sie die Canonical-Einstellungen für jede Sprache separat.
  6. Aktualisieren Sie bei einer Adressänderung die Zuordnung und alle Verweise auf diese Adresse im Paar.

Gehen Sie bei der Bereinigung von URLs vorsichtig vor. RFC 9110 behandelt das Schema und den Hostnamen ohne Beachtung der Groß- und Kleinschreibung; andere Komponenten werden seinen Normalisierungsregeln zufolge unter Beachtung der Groß- und Kleinschreibung verglichen. Wandeln Sie einen Pfad nicht in Kleinbuchstaben um und entfernen Sie keinen abschließenden Schrägstrich, nur damit zwei Datensätze gleich aussehen. Behalten Sie das überprüfte Ziel bei. RFC 9110, Normalisierung und Vergleich von HTTP(S).

Für das synthetische Paar ist ein stabiler tile-grid-Datensatz das nützliche Ergebnis, der zwei genaue Adressen mit gleichwertigem Inhalt und funktionierenden Links in beide Richtungen verbindet. Bewahren Sie den Datensatz in den Wartungsnotizen des Dokuments auf, damit sich bei einer künftigen Übersetzung oder Änderung des Slugs die Beziehung gezielt aktualisieren lässt.

Quellen