JavaScript a React
Překládejte obsah na serveru, vykreslujte katalogy zpráv v Reactu a propojte svou aplikaci se směrováním podle jazyka.
JavaScriptové aplikace pracují s překlady na dvou místech. Server odesílá obsah do lokalizačního engine a ukládá výsledek. Uživatelské rozhraní načítá přeložené zprávy a vykresluje je se správnými hodnotami, gramatikou a formátováním. Vyberte si balíček podle toho, kterou část aplikace vytváříte.
Překládejte ze svého serveru #
Podle průvodce JavaScript API vytvářejte překladové úlohy pomocí nativního fetch, sledujte jejich průběh a stahujte dokončené soubory. Klíč API uchovávejte na serveru a identifikátor každé úlohy ukládejte spolu s revizí zdroje, kterou úloha překládá.
Pro aplikace využívající LingoDotDevEngine je určena samostatná referenční příručka SDK v0. Najdete v ní dokumentaci synchronního API i dávkového zpracování na straně klienta.
Vykreslujte zprávy v Reactu #
React uchovává zdrojovou zprávu i její kontext v komponentě. Katalog dodává přeloženou šablonu a běhové prostředí do ní vkládá hodnoty a vytváří prvky Reactu, které řídí vaše aplikace. K vykreslování nepotřebujete klíč k překladovému API.
Začněte s jednou přeloženou komponentou a lokálním katalogem. Jak aplikace poroste, přejděte k extrakci a načítání katalogů. Postupy pro Next.js Pages a TanStack Start propojují tyto katalogy s požadavky, trasami a přepínáním jazyka. Pokud používáte vlastní směrovač, locale-router vám poskytne základní logiku pro rozhodování o URL a jazykových preferencích.
Připojte aplikaci Payload #
Plugin pro Payload CMS zpřístupňuje schéma polí a upozorňuje Lingo.dev na změny zdrojového obsahu. Integrace s Payload určuje, který obsah překládat a kam překlady zapisovat zpět.
Ukázkové projekty #
Tyto repozitáře ukazují, jak zdrojové soubory zapadají do načítání v aplikaci. Než si některý projekt přizpůsobíte, prostudujte si jeho verze závislostí a konfiguraci. Některé projekty používají jinou generaci balíčků, než jakou popisují tyto příručky. Ve forku nejprve připojte vlastní projekt Lingo.dev a teprve poté odesílejte úlohy k překladu.
| Projekt | Užitečný výchozí bod |
|---|---|
| React + Vite | Zprávy v komponentách, extrakce a načítání katalogů. |
| Next.js Pages | Zprávy na stránkách a trasy zohledňující jazyk. |
| Moduly TypeScriptu | Statická exportovaná jazyková data. Použijte strukturu výchozího exportu, kterou podporuje obslužný modul TypeScriptu; z nepodporovaných exportů se nemusí získat žádné překladové jednotky. |
| iOS | Prostředky pro Apple a nativní výběr jazyka. |
| Android | Adresáře prostředků a vyhledávání řetězců. |
| Flutter | Metadata ARB a generované zprávy. |
| Markdown | Cesty k dokumentům a úvodní metadata. |
| Markdoc + Next.js | Přeložitelné vlastnosti značek a vykreslování dokumentů. |
| OpenAPI | Popisy pro lidské čtenáře ve specifikaci API. |
| Rails | YAML s jazykem v kořenovém klíči a vyhledávání ve frameworku. |
| Laravel | Soubory prostředků a načítání ve frameworku. |
Nativní prostředky a dokumenty využívají CLI a příslušné obslužné moduly formátů. Samotné zařazení do této sbírky příkladů neznamená, že potřebují běhové prostředí Reactu.