Vývojářské nástroje
Překládejte soubory, volejte API ze svého serveru a vykreslujte vícejazyčné aplikace pomocí balíčků pro JavaScript.
Lokalizace propojuje dva druhy kódu: kód, který vytváří překlady, a kód, který je používá. Server může při změně záznamu požádat o přeložený obsah. Při sestavení aplikace lze shromáždit přeložené soubory. Komponenta Reactu může číst existující katalog, aniž by vůbec odeslala požadavek na překlad.
Začněte částí, kterou právě implementujete. Každá sekce vás provede celou první úlohou a poté popíše rozhraní a pravidla potřebná pro další práci.
API #
API použijte, pokud už máte obsah na serveru a chcete, aby server rozhodoval, kdy požádat o překlad, kam ho uložit a kdy ho použít. Odešlete obsah ve formátu JSON nebo nahrané soubory jako překladovou úlohu, spusťte ji a načtěte každý dokončený výstup v cílovém jazyce. Fáze překladu a kontroly řídí engine.
V návodu Odešlete první požadavek odešlete malý objem dat a přeložená data uložíte lokálně. Dozvíte se, jaký přihlašovací údaj použít, jak vybrat lokalizační engine, co znamenají pole odpovědi a co zkontrolovat před napojením na úložiště aplikace.
CLI #
CLI použijte, pokud máte obsah v souborech. Nastavte cesty ke zdrojovým souborům a cílové jazyky, odešlete vybraný obsah ke zpracování a stáhněte cílové soubory do projektu. CLI si zaznamenává výchozí stav zdrojů, aby při dalších spuštěních mohlo zpracovat jen změny, místo aby každý soubor považovalo za nový.
Návod Přeložte první soubor vás provede instalací, ověřením identity, konfigurací a stažením výsledků. Stejné CLI umí také extrahovat explicitně definované zprávy v Reactu do katalogů; extrakce probíhá lokálně a neodesílá požadavky na překlad.
JavaScript #
Balíčky pro JavaScript nabízejí serverové klienty, vykreslování zpráv v Reactu a směrování podle jazyka. Pro odesílání požadavků na překlad zvolte klienta, pro zprávy, které už má aplikace k dispozici, knihovnu pro vykreslování. K vykreslování v prohlížeči nepotřebujete klíč API pro překlad.
Dokumentace pro React obsahuje příklad lokálního vykreslení první zprávy a popisuje načítání katalogů, gramatické varianty, formátovaný text i integraci s konkrétními frameworky. Určování jazyka pomocí URL a samotný přeložený text jsou dvě oddělené oblasti. Referenční dokumentace ke směrování proto vysvětluje, jak zajistit soulad mezi zvoleným jazykem a načtenými zprávami.
Zapojte stávající projekt #
Sekce Formáty vysvětluje, co jednotlivé obslužné moduly překládají a znovu sestavují. Podívejte se také na seznam formátů nástroje, který modul volá: modul dostupný pro serverovou integraci nemusí být v CLI nakonfigurován jako formát souboru.
Pro projekty používající i18n.json nebo LingoDotDevEngine je k dispozici referenční dokumentace pro verze CLI v0 a SDK v0. Během plánování migrace zůstaňte u nainstalované verze; konfigurace, uchovávaný stav i návratové hodnoty se mohou mezi generacemi měnit.
Pro asistenta, který pracuje s lokálními soubory nebo konfigurací účtu, použijte MCP. Pro překlad propojený s repozitářem, CMS nebo centrem nápovědy použijte Integrace. Každé připojení určuje, jak se práce spouští, s jakými oprávněními probíhá a kam se vracejí výsledky.