Formáty

Najděte modul pro zpracování souborů, který přeloží váš text a zachová strukturu, kterou vaše aplikace potřebuje.

Jazykový soubor obsahuje víc než jen slova. Klíče propojují zprávy s kódem, zástupné symboly přijímají hodnoty z aplikace a struktura určuje, jak má framework výsledek načíst. Dokument k tomu přidává nadpisy, odkazy, příklady a metadata. Při překladu souborů je potřeba změnit jazyk, aniž by se tyto vazby narušily.

Lingo.dev používá modul pro zpracování daného formátu, který vybere text k překladu a znovu sestaví výsledek. Modul vybírejte podle toho, co soubor představuje. Katalog Rails i specifikace OpenAPI mohou mít příponu .yml, překlad všech řetězců by ale v každém z nich způsobil jiné problémy: kořenový klíč jazyka v Rails se musí změnit, zatímco identifikátory operací API musí zůstat beze změny.

Najděte svůj formát #

ZdrojTyp moduluReference
Katalog JSON s vnořenou strukturoujsonJSON
JSON s kontextovými komentářijsoncJSONC
Katalog YAMLyamlYAML
YAML s jedním kořenovým klíčem jazykayaml-root-keyYAML s kořenovým klíčem jazyka
Statický jazykový modul v TypeScriptutypescriptTypeScript
Statické pole jazykových řetězců v PHPphpPHP
Dokument ve formátu MarkdownmdMarkdown
Markdown s komponentami JSXmdxMDX
Dokument ve formátu MarkdocmarkdocMarkdoc
OpenAPI 3.x ve formátu YAMLyaml-openapiOpenAPI
XML se zdroji pro AndroidandroidAndroid
Balíček aplikačních zdrojů pro FlutterflutterFlutter ARB
Tabulka řetězců Applexcode-stringsApple strings
Soubor plist s tvary množného čísla pro Applexcode-stringsdictApple stringsdict
Vícejazyčný katalog Applexcode-xcstringsKatalogy řetězců Apple
Katalog Gettext POpoGettext
Dokument XLIFF pro výměnu datxliffXLIFF
Titulky SubRipsrtSubRip
Prostý text překládaný po řádcíchtxtProstý text
Dokument nebo fragment HTMLhtmlHTML
Tabulka CSV se sloupcem pro každý jazykcsvCSV
Balíček prostředků Java propertiespropertiesJava properties
Vybraná pole v Payload CMSpayloadPayload

Referenční dokumentace popisuje zavedené nástroje pro zpracování souborů včetně jejich omezení při extrakci a rekonstrukci. CLI a GitHub App podporují výše uvedených 22 nakonfigurovaných typů s výjimkou Payload. HTML se rozpoznává podle .html a .htm; výstup zachovává nedotčené části zdroje a u explicitně uvedeného prvku <html> nastavuje atribut lang na cílový jazyk. V konfiguraci repozitáře výslovně vyberte požadovanou variantu YAML nebo formát Android. Stejně jako Apple String Catalogs uchovává i CSV všechny jazyky ve zdrojovém souboru. Rychlý start s CLI vás na příkladu jednoho souboru provede celým postupem od nastavení až po získání výsledku; GitHub popisuje spravované workflow pro repozitář.

Aktuální připojení k poskytovatelům vybírají a zapisují obsah podle vlastních integračních kontraktů.

Pokud chcete přeložit přímo strukturovaná data, odešlete vložený JSON. Pokud chcete nahrát zdrojové soubory a zachovat jejich formáty, postupujte podle části Souborové dokumenty. Oba způsoby používají stejný životní cyklus překladové úlohy.

Uchovávejte zdrojovou revizi spolu s jejími překlady #

Inkrementální překlad souborů porovnává aktuální zdroj s jeho předchozí verzí a využívá odpovídající existující cílový soubor. Díky těmto vstupům si nezměněné zprávy zachovají schválené znění, zatímco nové nebo změněné zprávy se přeloží.

Díky klíčům má toto porovnání smysl: checkout.title a account.title mohou obsahovat totožný anglický text, a přesto si zachovat odlišné překlady. Při párování se zohledňují také pozice v polích, čísla titulkových bloků, pozice řádků v prostém textu a struktura dokumentu. Přesunutí položky nebo změna uspořádání přeloženého dokumentu může tyto vazby změnit, proto cílové soubory uchovávejte společně se zdrojovou revizí, ze které vznikly.

Většina formátů vytváří samostatný soubor pro každý cílový jazyk. Katalogy řetězců Apple naopak slučují jazyky do zdrojového souboru. Artefakt Payload nebo katalog řetězců může obsahovat některé cílové hodnoty, zatímco jiné v něm stále chybí. Kontrolujte proto samotné cílové položky, nejen to, zda soubor existuje.

Řiďte výběr textu a výstup odděleně #

Vyloučení textu z překladu může mít několik významů. Uzamčená hodnota v katalogu se přebírá ze zdroje, zachovaná hodnota z existujícího cílového souboru a ignorovaná hodnota může z výstupu zmizet. Dostupné možnosti určuje formát a rozhraní, přes které překlad voláte.

Pro JSON/JSONC, YAML, YAML s kořenovým klíčem jazyka, PHP a TypeScript použijte rozsahy klíčů v CLI. Částečná aktualizace zachová stávající znění v cílovém souboru mimo vybraný rozsah. Zpracování položek, které jsou pouze ve zdroji, a pozic v polích ale závisí na formátu. Celý výsledek zkontrolujte podle referenční dokumentace daného formátu.

I kontextová metadata mají svá konkrétní pravidla. Komentář @context v JSONC popisuje následující řetězcovou hodnotu. @message.description v ARB popisuje příslušnou zprávu. msgctxt v Gettext rozlišuje zprávy a poskytuje kontext. Běžné komentáře mohou zůstat zachovány i po opětovném sestavení souboru, aniž by sloužily jako instrukce pro překlad. Anotace @src a @orphan v Reactu patří do jeho workflow údržby katalogu.

Po získání souboru jej načtěte v systému, který ho používá. Kromě významu překladu zkontrolujte i vybraný jazyk, proměnné, tvary množného čísla, odkazy a chráněná data. S dokončením tohoto postupu vám pomohou průvodci pro webové aplikace, nativní zdroje a statický obsah.