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.

ProjektUžitečný výchozí bod
React + ViteZprávy v komponentách, extrakce a načítání katalogů.
Next.js PagesZprávy na stránkách a trasy zohledňující jazyk.
Moduly TypeScriptuStatická 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.
iOSProstředky pro Apple a nativní výběr jazyka.
AndroidAdresáře prostředků a vyhledávání řetězců.
FlutterMetadata ARB a generované zprávy.
MarkdownCesty k dokumentům a úvodní metadata.
Markdoc + Next.jsPřeložitelné vlastnosti značek a vykreslování dokumentů.
OpenAPIPopisy pro lidské čtenáře ve specifikaci API.
RailsYAML s jazykem v kořenovém klíči a vyhledávání ve frameworku.
LaravelSoubory 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.