HTML
Übersetze HTML-Text und -Attribute, ohne den übrigen Quelltext zu verändern, und setze die Dokumentsprache auf die Zielsprache.
HTML bettet lesbaren Text in eine Struktur ein, die auch Links, Verhalten und Informationen zur Barrierefreiheit enthält. Der html-Handler wählt unterstützte Textabschnitte und beschreibende Attribute aus und fügt ihre Übersetzungen für eine Zielsprache in den ursprünglichen Quelltext ein. Eine mehrsprachige Seite teilt er dabei nicht in separate Sprachbereiche auf.
Dokumentstruktur der Eingabe beibehalten #
Dokumente behalten ihren ursprünglichen Doctype und ihre expliziten Elemente. Fragmente bleiben Fragmente: Die Übersetzung fügt keine umschließenden <html>-, <head>- oder <body>-Elemente hinzu. Kommentare, unveränderte Attribute, die verwendeten Anführungszeichen und Leerraum außerhalb der übersetzten Abschnitte bleiben genau so erhalten, wie sie im Quelltext stehen.
Bei einem expliziten <html>-Element wird der vorhandene lang-Wert durch die Zielsprache ersetzt. Fehlt das lang-Attribut, wird es hinzugefügt. So wird beispielsweise <html lang="en"> für Französisch zu <html lang="fr">. Ein Fragment ohne explizites <html>-Element erhält nicht eigens eines, nur um die Sprache anzugeben.
Dieses Fragment enthält zum Beispiel sichtbaren Text und Text für die Barrierefreiheit:
<section>
<h2>Delivery options</h2>
<p>Read the <a href="/delivery">delivery policy</a>.</p>
<img src="/truck.svg" alt="Delivery truck" />
<input placeholder="Enter your address" aria-label="Delivery address" />
</section>Überschrift, Absatz, Linkbeschriftung, Alternativtext des Bildes, Platzhalter des Eingabefelds und ARIA-Beschriftung sind unterstützte Texte. Linkziel und Bildquelle bleiben strukturelle Eigenschaften. Die Übersetzung dieses Fragments erstellt weder lokalisierte Links noch ersetzt sie Bilddateien.
Attribute und Bereiche auswählen #
Zu den standardmäßig unterstützten Attributen gehören alt und title bei Bildern, placeholder und title bei Eingabefeldern und Textbereichen, ausgewählte title-Attribute, das Meta-Attribut content und ARIA-Beschriftungsattribute. Kontrolliere Metadaten sorgfältig: Die Auswahl eines Attributs anhand seines Namens stellt nicht sicher, dass jeder Wert Fließtext ist. Über konfigurierte Regeln für Komponenteneigenschaften lassen sich weitere Attribute für benannte Elemente auswählen.
Inhalte von Skripten, Styles, vorformatiertem Code, Code, mathematischen Ausdrücken, Templates sowie noscript- und textarea-Elementen sind von der regulären Textextraktion ausgeschlossen. Ein übersprungenes Element kann dennoch ein unterstütztes beschreibendes Attribut enthalten. Bei SVG werden unterstützte title-, desc- und text-Inhalte gezielt ausgewählt, statt beliebige Zeichnungsdaten zu übersetzen.
Inline-Markup und {{...}}-Tokens werden während der Textübersetzung durch Platzhalter geschützt. Bei der Rekonstruktion werden sie in den übersetzten Abschnitten wiederhergestellt. Kontrolliere die Elementstruktur des Ergebnisses und rendere die Variablen mit repräsentativen Werten aus deiner Anwendung.
Wiederverwendung und Ausgabe mit erhaltenem Quelltext #
Für die Wiederverwendung müssen der vorherige Quell- und Zieltext in ihrer Text- und Platzhalterstruktur einander entsprechen. Der Handler kontrolliert diese Zuordnung und kann ein nicht eindeutig zuordenbares Paar ablehnen. Halte den akzeptierten Zieltext mit seiner Quellversion verknüpft, statt nicht zusammengehörige gerenderte Seiten zu vergleichen.
Nur die übersetzten Abschnitte und das Sprachattribut des expliziten <html>-Elements ändern sich. Der übrige Quelltext wird direkt in das Ergebnis kopiert. Der Handler bereinigt kein nicht vertrauenswürdiges HTML. Behalte die eigenen Sicherheits- und Rendering-Kontrollen deiner Anwendung bei.
Führt eine fehlerhafte Verschachtelung dazu, dass der Parser Text über nicht zusammengehöriges Markup hinweg zusammenfasst, lehnt der Handler das Dokument ab, statt einen mehrdeutigen Zieltext zu schreiben. Korrigiere die Verschachtelung und versuche es erneut. Bei zulässigerweise ausgelassenen HTML-Tags muss kein Dokumentgerüst ergänzt werden.
HTML-Dateien in der CLI oder GitHub App konfigurieren #
Die CLI und die GitHub App leiten html aus .html und .htm ab. Wähle die Quelldateien in .lingo/config.json aus und achte darauf, dass generierte Zieldateien nicht von den Mustern für Quelldateien erfasst werden:
{
"sourceLocale": "en",
"targetLocales": ["fr"],
"files": [
{ "pattern": "pages/en/**/*.html", "format": "html" },
{ "pattern": "pages/en/**/*.htm", "format": "html" }
]
}Die explizite Angabe von format ist bei diesen Dateiendungen optional. Verknüpfe das Projekt über die CLI-Konfiguration mit deiner Organisation und Lokalisierungs-Engine oder gib die Engine für die GitHub App an. Für jede Zielsprache entsteht eine separate Datei, etwa pages/fr/index.html. HTML unterstützt keine Übersetzung, die auf einzelne Schlüssel beschränkt ist.
Rendere das Dokument oder Fragment nach dem Abruf in der Anwendung, die es verwendet. Vergleiche Links und Attribute ohne Textinhalt und sieh dir den Text für die Barrierefreiheit zusammen mit dem sichtbaren Text an. Wenn ein CMS das HTML bereitstellt, befolge die Anweisungen des jeweiligen Konnektors zur Feldauswahl und zum Zurückschreiben. Konnektoren können unterschiedliche Eingaben akzeptieren, auch wenn die HTML-Verarbeitung Teil ihrer Implementierung ist.