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.

SkupinaObsahDokumentovaný model výstupu
json, json5, jsoncStrukturované varianty JSONSamostatné soubory pro jednotlivé jazyky
json-dictionaryHodnoty JSON obsahující objekty s klíči podle jazykaSdílený soubor
yamlKatalog YAMLSamostatné soubory pro jednotlivé jazyky
yaml-root-keyYAML zanořený pod kořenovým klíčem výstupního jazykaSamostatné soubory pro jednotlivé jazyky
markdown, mdx, markdocDokumenty ve formátu Markdown a příbuzných formátechSamostatné soubory pro jednotlivé jazyky
html, mjmlZnačkování HTML a e-mailůSamostatné soubory pro jednotlivé jazyky
androidProstředky XML pro AndroidSamostatné soubory pro jednotlivé jazyky
xcode-strings, xcode-stringsdictŘetězce a prostředky pro tvary množného čísla na platformách AppleSamostatné soubory pro jednotlivé jazyky
xcode-xcstringsKatalog řetězců XcodeSdílený soubor
flutterKatalog ARBSamostatné soubory pro jednotlivé jazyky
poGettext POSamostatné soubory pro jednotlivé jazyky
propertiesSoubory vlastností JavaSamostatné soubory pro jednotlivé jazyky
csvVícejazyčné CSVSdílený soubor
csv-per-localeJeden soubor CSV pro každý jazykSamostatné soubory pro jednotlivé jazyky
xml, xliffXML a XLIFFSamostatné soubory pro jednotlivé jazyky
srt, vttTitulkySamostatné soubory pro jednotlivé jazyky
phpLokalizační pole PHPSamostatné soubory pro jednotlivé jazyky
typescriptLokalizační obsah v TypeScriptuSamostatné soubory pro jednotlivé jazyky
vue-jsonBloky JSON ve Vue i18n s klíči podle jazykaSdílený soubor
txtProstý textSamostatné 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:

json
{
  "buckets": {
    "json": { "include": ["src/locales/[locale].json"] }
  }
}

Pro sdílený katalog Xcode v kombinaci s prostředky Androidu pro jednotlivé jazyky:

json
{
  "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ě:

json
{
  "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.