Lokalizujte formátované interaktivní zprávy
Přeložte celou větu a ponechte její odkazy, komponenty a hodnoty pod kontrolou kódu Reactu.
„Než budete pokračovat, přečtěte si zásady“ je jedna věta, i když je slovo „zásady“ odkazem. Když ji překládáte jako celek, lze v jiném jazyce přesunout odkaz na správné místo, aniž by se řízení jeho cíle přesunulo mimo kód aplikace.
Metoda rich z balíčku pro React tento odkaz reprezentuje jako pojmenovaný slot. Katalog dodá větu a vykreslovací funkce v Reactu komponentu pro daný slot.
Vykreslete celou větu s odkazem #
Nainstalujte @lingo.dev/react do stávající aplikace v Reactu 19. Tento lokální příklad používá ukázkový španělský katalog a nevyžaduje odeslání požadavku na překlad:
npm install @lingo.dev/reactimport { computeKey, LingoProvider, useLingo } from "@lingo.dev/react";
const messages = {
[computeKey(
"Read the <policy>policy</policy> before continuing.",
"Notice before account creation",
)]: "Antes de continuar, lee la <policy>política</policy>.",
};
function ConsentNotice() {
const l = useLingo();
return (
<p>
{l.rich("Read the <policy>policy</policy> before continuing.", {
context: "Notice before account creation",
tags: {
policy: (children) => <a href="/policy">{children}</a>,
},
})}
</p>
);
}
export function App() {
return (
<LingoProvider locale="es" messages={messages}>
<ConsentNotice />
</LingoProvider>
);
}Odstavec by měl znít „Antes de continuar, lee la política.“ V přeložené větě se zmínka o zásadách přesune, ale odkaz stále směřuje na /policy. Zdrojový text zadaný přímo jako literál a kontext ve volání navíc umožňují zprávu při extrakci rozpoznat. computeKey vytvoří skutečný identifikátor testovacího příkladu, místo aby se spoléhalo na smyšlený hash.
Poskytovatel v současnosti používá syntaxi kontextu Reactu 19, přestože balíček deklaruje React 18/19 jako partnerské závislosti. Fungování v Reactu 18 ověřte samostatně. Nastavení poskytovatele a prvního katalogu popisuje průvodce rychlým startem s Reactem.
Ponechte hodnoty a chování v kódu #
Název policy označuje slot, nikoli HTML prvek dodaný překladatelem. Cíl i chování řídí jeho vykreslovací funkce. Cíl pro konkrétní jazyk určete v kódu podle známého mapování tras; obslužné funkce událostí ani libovolné atributy HTML do katalogu nevkládejte.
Pro proměnlivé hodnoty používejte pojmenované zástupné symboly:
const greeting = l.text("Welcome, {name}", {
context: "Greeting on the signed-in account page",
values: { name },
});
const countLabel = l.plural(
count,
{ one: "# item", other: "# items" },
{ context: "Number of items in the cart" },
);
const roleLabel = l.select(
role,
{ admin: "Administrator", other: "Member" },
{ context: "Account role label" },
);Tato volání patří do komponenty s const l = useLingo() a hodnotami aplikace pro name, count a role. text vrací prostý text, plural řeší gramatické tvary podle počtu a select vybírá podle přesné hodnoty selektoru se záložní variantou other. Zpracování formátovaného textu podporuje pojmenované značky a jednoduché dosazování hodnot; nepoužívá komplexní formátovač ICU určený pro prostý text. Pro tato rozhodnutí za běhu použijte množná čísla, data a čísla.
Zdrojový text ponechte statický. Pokud do zdrojového řetězce vložíte jméno osoby, vznikne pro každou osobu jiný zdrojový text, což znemožní spolehlivou extrakci. Kontext by měl vysvětlovat použití, například „Popisek role účtu“, protože identitu zprávy určuje zdrojový text společně s kontextem. Jakmile už překlady existují, měňte kontext uvážlivě.
Nahraďte lokální testovací data extrahovanými katalogy #
Po instalaci aktuální verze CLI spusťte:
lingo extract --src src --source-locale enPokud nepřepíšete výchozí cesty, příkaz zapíše locales/en.jsonc a lingo.d.ts. Zkontrolujte extrahovaný zdrojový text, kontext a klíč. Deklaraci zahrňte do konfigurace TypeScriptu aplikace. Extrakce podporuje rozpoznatelná volání zpráv; libovolné dynamicky generované zdrojové řetězce neodhalí.
Podle průvodce rychlým startem s CLI proveďte ověření a propojte lokalizační engine. Poté v .lingo/config.json vyberte tento skutečný zdroj locales/en.jsonc a požadované cílové jazyky. Pomocí tohoto souborového workflow katalog přeložte a stáhněte. Podle postupu načítání katalogu zpracujte JSONC, vyberte aktivní klíče z odpovídající revize zdroje a předejte poskytovateli cílové řetězce. Obecný překladač souborů nezachovává ve výstupu komentáře ze zdrojového katalogu.
Načtěte stejné oznámení se staženým španělským katalogem. U chybějících nebo prázdných položek se použije zdrojový text, proto kromě viditelného výstupu porovnejte i požadované cílové klíče.
Otestujte interakci i chybně formátované zprávy #
Otevřete odkaz na zásady pomocí klávesnice a zkontrolujte jeho přístupný název. Po přesunutí odkazu si přečtěte i okolní interpunkci. Úplný překlad musí zachovat význam věty i akci, kterou může čtenář provést.
V lokálních testovacích datech katalogu odeberte obslužnou funkci značky, vložte neznámou značku a jednu značku nechte neuzavřenou. Současná vykreslovací funkce ponechává neznámé nebo nespárované značky jako text; párování vnořených značek se stejným názvem má omezenou podporu. Nejde o nástroj pro vykreslování libovolného HTML ani o validátor, který odmítne každou chybně formátovanou zprávu.
U prostého textu prověřte chybějící hodnoty a chybně formátované komplexní zprávy ICU: nedosazené zástupné symboly nebo nenaformátovaná šablona mohou zůstat viditelné a ve vývojovém prostředí se zobrazí diagnostika. U zpráv s počty a rolemi otestujte kategorie množného čísla cílového jazyka a neznámou roli. Přesné chování, ze kterého tyto kontroly vycházejí, najdete v referenční dokumentaci k formátovanému textu a pokynech k testování v Reactu.