HTML
Překládejte text a atributy HTML se zachováním ostatních částí zdrojového kódu a nastavením jazyka dokumentu na cílový jazyk.
HTML zasazuje čitelný text do struktury, která nese také odkazy, chování a informace o přístupnosti. Obslužná rutina html vybírá podporované textové úseky a popisné atributy a jejich překlady do jednoho cílového jazyka vkládá přímo do původního zdrojového kódu. Vícejazyčnou stránku nerozděluje na samostatné jazykové oblasti.
Zachovejte strukturu vstupního dokumentu #
Dokumenty si zachovávají původní deklaraci doctype i explicitně uvedené elementy. Fragmenty zůstávají fragmenty: při překladu se nepřidávají obalové elementy <html>, <head> ani <body>. Komentáře, neměněné atributy, způsob použití uvozovek a bílé znaky mimo překládané úseky zůstávají přesně tak, jak jsou zapsané ve zdrojovém kódu.
U explicitně uvedeného elementu <html> se stávající hodnota lang nahradí cílovým jazykem. Pokud atribut lang chybí, doplní se. Například <html lang="en"> se při překladu do francouzštiny změní na <html lang="fr">. Do fragmentu bez explicitně uvedeného elementu <html> se tento element nepřidává jen kvůli nastavení jazyka.
Tento fragment například obsahuje viditelný text i text pro přístupnost:
<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>Nadpis, odstavec, text odkazu, alternativní text obrázku, zástupný text vstupního pole a popisek ARIA patří mezi podporované texty. Cíl odkazu a zdroj obrázku zůstávají součástí struktury. Překlad tohoto fragmentu nevytváří lokalizované odkazy ani nenahrazuje obrazové soubory.
Výběr atributů a oblastí #
Mezi standardně podporované atributy patří alt a title u obrázků, placeholder a title u vstupních a víceřádkových textových polí, vybrané atributy title, atribut content u metadat a atributy popisků ARIA. Metadata pečlivě zkontrolujte: výběr atributu podle názvu nezaručuje, že každá jeho hodnota je běžný text. Pomocí nakonfigurovaných pravidel pro vlastnosti komponent lze do výběru přidat atributy konkrétních pojmenovaných elementů.
Obsah skriptů, stylů, předformátovaného kódu, kódu, matematických výrazů, šablon a elementů noscript a textarea se do běžné extrakce textu nezahrnuje. I vynechaný element ale může mít podporovaný popisný atribut. U SVG se cíleně vybírá podporovaný obsah title, desc a text namísto překladu libovolných dat kresby.
Vložené značky a tokeny {{...}} jsou během překladu textu chráněny zástupnými symboly. Při opětovném sestavení se v přeložených úsecích obnoví. Zkontrolujte strukturu elementů ve výsledku a vykreslete jej s proměnnými naplněnými reprezentativními hodnotami z aplikace.
Opětovné použití a zachování zdrojového kódu ve výstupu #
Pro opětovné použití musí struktura textu a zástupných symbolů v předchozím zdroji odpovídat struktuře v předchozím překladu. Obslužná rutina kontroluje jejich vzájemný soulad a nejednoznačnou dvojici může odmítnout. Přijatý překlad uchovávejte spolu s příslušnou revizí zdroje, místo abyste porovnávali nesouvisející vykreslené stránky.
Mění se pouze přeložené úseky a jazykový atribut explicitně uvedeného elementu <html>; ostatní zdrojový kód se kopíruje přímo do výsledku. Obslužná rutina neprovádí bezpečnostní čištění nedůvěryhodného HTML. Ponechte v aplikaci vlastní bezpečnostní kontroly i kontroly vykreslování.
Pokud chybné vnoření způsobí, že parser spojí text z nesouvisejících značek, obslužná rutina dokument odmítne, místo aby zapsala nejednoznačný překlad. Opravte vnoření a zkuste to znovu. Pokud jsou značky HTML vynechány v souladu s pravidly, není nutné doplňovat základní strukturu dokumentu.
Nastavte soubory HTML v CLI nebo GitHub App #
CLI a GitHub App odvozují html z .html a .htm. Vyberte zdrojové soubory v .lingo/config.json a zajistěte, aby se na generované cílové soubory nevztahovaly vzory pro výběr zdrojů:
{
"sourceLocale": "en",
"targetLocales": ["fr"],
"files": [
{ "pattern": "pages/en/**/*.html", "format": "html" },
{ "pattern": "pages/en/**/*.htm", "format": "html" }
]
}Explicitní nastavení format je pro tyto přípony nepovinné. Propojte projekt se svou organizací a lokalizačním engine pomocí konfigurace CLI nebo zadejte engine pro GitHub App. Každý cílový jazyk má samostatný soubor, například pages/fr/index.html. HTML nepodporuje překlad omezený na konkrétní klíče.
Po načtení vykreslete dokument nebo fragment v prostředí, které jej používá. Porovnejte odkazy a netextové atributy a spolu s viditelným textem zkontrolujte i text pro přístupnost. Pokud HTML dodává CMS, řiďte se instrukcemi příslušného konektoru pro výběr polí a zpětný zápis; konektory mohou přijímat různé vstupy, i když je zpracování HTML součástí jejich implementace.