Formáty CLI v0
Zvolte uspořádání jazyků odpovídající nainstalovanému staršímu parseru a ověřte znovu sestavený soubor v nativním formátu.
Vyberte skupinu podle dat, která chcete extrahovat, a souborů, které očekáváte na výstupu. Verze v0 vybírá parser podle typu skupiny; přípona souboru na tuto volbu nemá vliv. Katalog JSON a vícejazyčný katalog Xcode proto vyžadují odlišnou konfiguraci, i když oba obsahují textové řetězce.
Nejprve zvolte model výstupu #
Většina skupin zapisuje samostatné soubory pro jednotlivé jazyky a v cestě používá [locale]. CSV, katalogy řetězců Xcode, slovníky JSON a bloky Vue i18n mohou obsahovat více jazyků v jednom souboru. U sdíleného výstupu po překladu zkontrolujte cílovou i zdrojovou část.
| Skupina | Obsah | Dokumentovaný model výstupu |
|---|---|---|
json, json5, jsonc | Strukturované varianty JSON | Samostatné soubory pro jednotlivé jazyky |
json-dictionary | Hodnoty JSON obsahující objekty s klíči podle jazyka | Sdílený soubor |
yaml | Katalog YAML | Samostatné soubory pro jednotlivé jazyky |
yaml-root-key | YAML zanořený pod kořenovým klíčem výstupního jazyka | Samostatné soubory pro jednotlivé jazyky |
markdown, mdx, markdoc | Dokumenty ve formátu Markdown a příbuzných formátech | Samostatné soubory pro jednotlivé jazyky |
html, mjml | Značkování HTML a e-mailů | Samostatné soubory pro jednotlivé jazyky |
android | Prostředky XML pro Android | Samostatné soubory pro jednotlivé jazyky |
xcode-strings, xcode-stringsdict | Řetězce a prostředky pro tvary množného čísla na platformách Apple | Samostatné soubory pro jednotlivé jazyky |
xcode-xcstrings | Katalog řetězců Xcode | Sdílený soubor |
flutter | Katalog ARB | Samostatné soubory pro jednotlivé jazyky |
po | Gettext PO | Samostatné soubory pro jednotlivé jazyky |
properties | Soubory vlastností Java | Samostatné soubory pro jednotlivé jazyky |
csv | Vícejazyčné CSV | Sdílený soubor |
csv-per-locale | Jeden soubor CSV pro každý jazyk | Samostatné soubory pro jednotlivé jazyky |
xml, xliff | XML a XLIFF | Samostatné soubory pro jednotlivé jazyky |
srt, vtt | Titulky | Samostatné soubory pro jednotlivé jazyky |
php | Lokalizační pole PHP | Samostatné soubory pro jednotlivé jazyky |
typescript | Lokalizační obsah v TypeScriptu | Samostatné soubory pro jednotlivé jazyky |
vue-json | Bloky JSON ve Vue i18n s klíči podle jazyka | Sdílený soubor |
txt | Prostý text | Samostatné soubory pro jednotlivé jazyky |
Jde o původní sadu skupin, nikoli o seznam kompatibility s jinými nástroji. Některé položky mohly být přidány až po vydání starších verzí v0. Parsery pro TypeScript, PHP a Vue zpracovávají podporované lokalizační struktury; jejich přítomnost neznamená, že lze libovolně přepisovat spustitelný zdrojový kód.
Dispečer 0.138.10 obsahuje také ail, ejs, twig, dato a xcode-xcstrings-v2. U již nainstalovaného projektu ponechte dosavadní parser, dokud nezkontrolujete jeho vstup a výstup. Samotný výčet hodnot ve schématu nestačí: původní schéma uvádí také compiler, ale v této větvi zpracování pro něj neexistuje odpovídající načítací modul.
yaml-root-key znovu sestaví pouze kořenovou část vybraného jazyka. Nenastavujte stejný sdílený soubor YAML jako zdroj i cíl: zápis může přepsat jeho ostatní kořenové části. Použijte cestu pro konkrétní jazyk, například locales/[locale].yml. Toto chování se liší od slovníku JSON nebo bloku Vue, který nový jazyk výslovně začleňuje do původní struktury.
Nastavte konfiguraci pro reprezentativní soubor #
U JSON stejný vzor určuje zdrojový soubor i samostatné cílové soubory:
{
"buckets": {
"json": { "include": ["src/locales/[locale].json"] }
}
}Pro sdílený katalog Xcode v kombinaci s prostředky Androidu pro jednotlivé jazyky:
{
"buckets": {
"xcode-xcstrings": { "include": ["ios/Localizable.xcstrings"] },
"android": {
"include": ["android/app/src/main/res/values-[locale]/strings.xml"]
}
}
}Přizpůsobte zápis označení jazyků a adresáře prostředků Androidu dané aplikaci. Po prvním spuštění ověřte oba nativní formáty příslušnými nástroji pro sestavení a zkontrolujte, že aplikace načítá vybraný cílový jazyk. Samotné přijetí konfigurace ještě nepotvrzuje, že cesta funguje.
Vyhledejte soubory bez zahrnutí generovaného výstupu #
Cesty se vyhodnocují relativně k i18n.json; * hledá shody v rámci jedné úrovně. Rekurzivní ** je podporováno od verze 0.135.0. Ve výchozím nastavení vylučuje node_modules, .git, dist, build, .next a .turbo. Veškerý další generovaný obsah vylučte výslovně:
{
"buckets": {
"markdown": {
"include": ["docs/[locale]/*.md"],
"exclude": ["docs/[locale]/drafts/*.md"]
}
}
}Pro více balíčků zvolte sdílenou konfiguraci nebo konfiguraci pro jednotlivé balíčky podle jazyků a toho, kdo spravuje lokalizační engine. Přesně vymezené cesty zabrání tomu, aby se generovaný výstup nečekaně stal zdrojovým vstupem.
Zkontrolujte ochranná opatření pro jednotlivé formáty #
U katalogů typu klíč/hodnota použijte pravidla pro klíče podle toho, kdo odpovídá za jednotlivé hodnoty. Komentáře v JSONC a katalozích Xcode mohou obsahovat poznámky pro překladatele. Dokumenty s volnou strukturou a titulky nemusí tyto funkce využívat stejným způsobem.
Zkontrolujte, co parser znovu sestavil: klíče a hodnoty katalogu, značkování a odkazy v dokumentu, časové značky titulků nebo identifikátory nativních prostředků. Výstup přijměte až poté, co jej dokáže použít navazující parser nebo proces sestavení. Při migraci vycházejte z aktuální příručky formátů a seznamu podporovaných formátů nástroje, který zpracování spouští. Nepředpokládejte, že tato původní tabulka platí i nadále.