Lokalizace statického obsahu

Přiřaďte přeložené dokumenty a katalogy k souborům, které načítá váš web nebo vykreslovací nástroj, a pak ověřte strukturu, odkazy i výsledný výstup.

Strom zdrojových souborů vašeho webu už propojuje články s trasami, metadaty, navigací a vykreslovacím nástrojem. Přeložené soubory přidejte tam, odkud je tento systém dokáže načíst. Prvním užitečným výsledkem je jedna úplná stránka v cílovém jazyce na správné trase, s funkčními odkazy a stejnými ukázkami kódu jako ve zdroji.

Roztřiďte soubory podle systému, který je zpracovává #

Oddělte delší textové dokumenty od strukturovaných katalogů a specializovaných zdrojů. Markdown, MDX a Markdoc potřebují vykreslovací nástroj a schéma. Katalogy ve formátech JSON, YAML, TypeScript a PHP potřebují načítací modul. PO a XLIFF se napojují na vlastní systémy pro práci se zprávami. SRT patří do workflow pro časovaná média.

Z každé skupiny vyberte jeden reprezentativní zdroj a určete výstupní cestu i načítací modul, který ho bude zpracovávat. Generované cílové soubory ukládejte mimo cesty odpovídající vzorům pro výběr zdrojů. Zachovejte ID dokumentů, URL, ukázky kódu, klíče katalogů a atributy komponent, jejichž hodnoty řídí chování.

V přehledu Formáty vyberte odpovídající modul pro zpracování. Běžný YAML se liší od YAML s jazykem v kořenovém klíči i od OpenAPI YAML. .xml samo o sobě neidentifikuje zdroj pro Android. Stejná přípona ještě neznamená, že modul rozumí struktuře vašeho dokumentu.

Dodržujte adresářovou konvenci webu #

U načítacího modulu svého projektu ověřte následující možnosti uspořádání:

WebCo zjistit před překladem
DocusaurusKteré zdrojové dokumenty se ukládají jako soubory do i18n/<locale>/docusaurus-plugin-content-docs/current/ a které verzované dokumenty nebo řetězce motivu mají samostatné vstupy.
NextraZda nainstalované řešení načítá stránky pro jednotlivé jazyky, slovníky, nebo jiný strom obsahu; každý vstup namapujte samostatně.
HugoKteré soubory v content/<locale>/ představují jazykové varianty téhož obsahu a jak se vyhodnocují odkazy mezi jazyky.
AstroKteré kolekce obsahu a slovníky uživatelského rozhraní pro jednotlivé jazyky poskytují obsah pro každou trasu.
VitePressKterý prefix jazykového adresáře a která konfigurace navigace generují přeložené stránky.
MkDocsKterý modul i18n a jaké uspořádání dokumentace podle jazyků používá nainstalovaný projekt.

V příkladu pro Docusaurus se zdrojovými dokumenty v docs/ nainstalujte a propojte CLI z kořenového adresáře projektu:

sh
npm install --global @lingo.dev/cli
lingo login
lingo init --source en --targets es --files 'docs/**/*.md' --yes
lingo link

V .lingo/config.json ponechte ID organizace a lokalizačního engine. Protože tyto zdrojové cesty neobsahují jazyk, nahraďte položku souboru výslovně zadanou šablonou výstupu:

json
{
  "pattern": "docs/**/*.md",
  "sourceRoot": "docs",
  "targetPath": "i18n/[locale]/docusaurus-plugin-content-docs/current/[path]"
}

Pro docs/setup/install.md se [path] změní na setup/install.md, takže španělský výstup se uloží do i18n/es/docusaurus-plugin-content-docs/current/setup/install.md. Ověřte, že nainstalovaný modul v dané verzi tento adresář načítá. Část Konfigurace vysvětluje ověřování šablon a pravidla pro kolize.

Pečlivě vybírejte viditelná pole dokumentu k překladu #

U Markdownu vyberte ze záhlaví metadata, která čtenáři vidí, například název a popis. Metadata určující identitu a publikování ponechte beze změny. U MDX a Markdoc určete také vlastnosti komponent určené čtenářům, například nadpis upozornění. Vlastnosti řídící chování a názvy komponent patří do schématu aplikace.

Použijte správný modul pro zpracování a nepředpokládejte, že všechny soubory z rodiny Markdown jsou zaměnitelné. Dokument Markdoc uložený jako .md vyžaduje výslovné nastavení formátu markdoc, aby se zpracoval jako Markdoc. Omezení výběru a rekonstrukce najdete v dokumentaci pro Markdown, MDX a Markdoc. Ohraničené bloky kódu zachovejte jako spustitelný podklad pro ověření; překládejte okolní vysvětlení, ne samotné příkazy.

Spusťte doplnění chybějících souborů:

sh
lingo push --backfill-missing --wait

Po dokončení sestavte web a otevřete vygenerovanou cílovou trasu. Zkontrolujte název, popis, tělo dokumentu, vlastní komponenty, blok kódu a odkaz. Pokud se ID nadpisů odvozují z textu, vyzkoušejte přímo i odkazy na přeložené fragmenty. I zachovaná URL musí vést na existující cíl. Průvodce použitím Markdoc s Next.js uvádí příklad načítání podle jazyka.

Dodržujte pravidla strukturovaných katalogů #

Překládejte řetězcové hodnoty v JSON a obecném YAML a pomocí nastavení klíčů příslušného modulu chraňte ID, koncové body a další nejazyková data. U obecného YAML v konfiguraci zdrojů aktuálního CLI výslovně nastavte format: "yaml": samotné odvození formátu z přípony neumožní odeslat nenakonfigurovaný zdroj YAML. Použijte yaml-root-key, pokud je jazyk kořenovým klíčem, a yaml-openapi, pokud má struktura podobu dokumentu OpenAPI. U TypeScriptu a PHP se držte podporovaných podob katalogů; překlad souboru nezajišťuje bezpečné vyhodnocení libovolného zdrojového kódu.

U PO zachovejte identifikátory zpráv, kontext, strukturu množných čísel a krok kompilace, který používá cílový systém. U XLIFF zachovejte strukturu zdroje, cíle a zástupných symbolů podporované varianty. Ověřte import nebo sestavení v systému, který soubory skutečně zpracovává, ne jen existenci výstupního souboru.

Soubory .txt s prostým textem, například popisy aplikací v obchodech s aplikacemi, se překládají řádek po řádku a zachovávají původní členění řádků. Do vzoru pro výběr souborů zahrňte .txt, jako v příkladu metadata/en/*.txt, nebo nastavte "format": "txt": obecný vzor jako docs/en/**/* tyto soubory nevybere. Viz Prostý text. Tabulka CSV s jedním sloupcem pro každý jazyk se překládá přímo v souboru: do vzoru zahrňte .csv nebo nastavte "format": "csv", jak popisuje část CSV. Aktuální CLI nenabízí mezi konfigurovatelnými formáty samostatný soubor CSV pro každý jazyk, WebVTT ani Java .properties. Referenční příručka formátů CLI v0 je určena uživatelům, kteří mají nainstalovanou starší verzi a využívají tyto dřívější pracovní postupy; uvedené příkazy a konfigurace platí pouze pro danou verzi. Podle referenční příručky k migraci zvolte podporovaný postup, aby tyto zdroje nebyly bez upozornění vynechány.

Kontrolujte titulky společně s médiem #

U SRT přeložte text titulků a porovnejte jejich pořadová čísla a časování se zdrojem. Přehrajte reprezentativní scény s titulky v cílovém jazyce. Přímo v používaném přehrávači ověřte délku textu ke čtení, zalomení řádků, kontext mluvčích a formátovací značky. Zachované časové značky ještě neznamenají, že lze přeložený titulek v daném intervalu přečíst. Požadavky na soubor najdete v části SubRip; nenahrazujte ho formátem WebVTT jen proto, že oba formáty slouží pro titulky.

Rozšiřujte překlad na základě ověřeného postupu publikování #

Uchovávejte konfiguraci, zdroje, přijaté cílové soubory a soubor Lockfile pro CLI pohromadě. Po změně odstavce použijte lingo push --wait pro běžné zpracování změn a pak v cílovém souboru porovnejte tento odstavec i nezměněnou část. Předchozí zdroj uchovávejte společně s odpovídajícím překladem; změna struktury dokumentů může znejasnit, co lze znovu použít. Poziční vzor používá jiná pravidla pro plánování v rámci vymezeného rozsahu. Před rozsáhlým opětovným překladem použijte workflow odhadu a odhady berte jako podklad pro plánování, ne jako cenové nabídky.

Pokud potřebujete chránit ruční opravy cílových souborů před přepsáním při rozdílech mezi verzemi, odešlete požadavek bez --wait a před stažením zkontrolujte lingo pull --dry-run; přímý zpětný zápis při čekání tento kontrolní krok vynechává. Postupujte podle části Zachování zkontrolovaných překladů.

Jakmile se jedna skupina správně sestaví, zvolte GitHub App nebo postupy pro CI. V tomto cyklu zachovejte sestavení webu, ověření schématu, kontrolu odkazů i kontrolu obsahu; lingo check nepotvrzuje úplnost dokumentu. Výsledkem každé aktualizace by měla být čitelná cílová stránka a revize zdroje, kterou tým může použít při další změně.