TypeScript

Překládejte hodnoty literálů ve statických jazykových modulech s výchozím exportem a zachovejte okolní syntaxi TypeScriptu.

Jazykový modul v TypeScriptu umožňuje uchovávat texty přímo u typů, které je popisují. Obslužný modul pro soubory typescript překládá hodnoty literálů ve statickém výchozím exportu. Text nahrazuje přímo na místě a zachovává klíče, importy, komentáře i okolní syntaxi typů. Zdrojový kód čte bez spuštění modulu.

Předejte obslužnému modulu statický katalog #

Jako výchozí export použijte přímo zapsaný objekt nebo pole:

typescript
export default {
  checkout: {
    title: "Complete your order",
    retries: 3,
  },
  steps: ["Review", "Confirm"],
} as const;

Mezi řetězcové jednotky patří checkout.title, steps[0] a steps[1]. Číselná hodnota zůstává beze změny. as const, satisfies i závorky kolem podporovaných výrazů mohou ve zdrojovém kódu zůstat.

Hodnoty určené k překladu zapisujte jako literály. Obslužný modul nedohledává deklaraci exportovaného identifikátoru ani nevyhodnocuje volání tovární funkce. Přeskakuje vypočítávané klíče vlastností, rozbalování, metody a hodnoty vzniklé vyhodnocením výrazů. Šablonové literály podporuje pouze bez vložených výrazů. Pokud z platného modulu nevzniknou žádné překladové úlohy, zkontrolujte nejprve strukturu výchozího exportu, než začnete hledat chybu překladu.

Cíleně zachovávejte přijaté hodnoty #

Změny se určují pro jednotlivé cesty v katalogu porovnáním s předchozí verzí zdroje. Existující cílový soubor poskytuje přijaté hodnoty pro nezměněné řetězce i pro ty, které se nepodařilo vyřešit jinak. Uzamčené cesty zachovávají aktuální zdrojový literál; cesty označené k zachování ponechávají existující cílovou hodnotu, pokud je dostupná. Tyto mechanismy nespouštějí kód, aby v něm hledaly další text.

Při nahrazování se používá stejný typ uvozovek jako u zdrojového literálu a přeložený obsah se pro tento typ odpovídajícím způsobem escapuje. Aktualizace klíčů zachovává nevybrané cílové hodnoty. Zdrojové položky, které v tomto částečném výsledku chybí, mohou být odstraněny, a to včetně prvků polí. Před načtením modulu proto zkontrolujte výsledné klíče i to, které prvky v polích zůstaly.

Nastavte výběr souborů #

CLI automaticky odvozuje typescript pro .ts, .mts a .cts, nikoli pro .js nebo .tsx. Jazykové moduly vyberte v konfiguraci CLI nebo přes GitHub.

Načtěte přeložený modul #

Tento formát je nezávislý na extrakci textů z Reactu. Extrakce čte podporovaná volání ve zdrojových souborech aplikace .ts a .tsx a vytváří z nich katalog; tento obslužný modul překládá již strukturovaný jazykový modul. Celý tento postup popisuje část Katalogy a typy pro React.

Po stažení zkontrolujte typovou správnost modulu a načtěte jej pomocí zavaděče katalogů aplikace. Porovnejte vybrané klíče s texty používanými na obrazovce a poté otestujte zástupné symboly. Každá z těchto kontrol odhaluje jiné problémy: neplatný modul nelze načíst, nevybraná dynamická hodnota zůstane nepřeložená a i platný překlad může vyjadřovat nesprávný význam.