Glosář dává lokalizačnímu enginu přesnou kontrolu nad konkrétními termíny — buď vynutí přesný překlad, nebo překlad úplně zakáže. Termíny v glosáři mají přednost před vlastním úsudkem modelu, takže je engine používá konzistentně v každém požadavku.
Glosář patří organizaci: je to pojmenovaný kontejner s termíny, který se k lokalizačnímu enginu připojuje. Jeden glosář může řídit každý engine, který ho potřebuje, a jeden engine jich může používat několik.
Jak to funguje#
| Objekt | Pole |
|---|---|
| Glosář | Název, popis a zdrojové jazyky, které pokrývá. Obsahuje libovolný počet termínů. |
| Termín | Zdrojový jazyk, cílový jazyk, zdrojový text, cílový text, typ, nápověda. |
Když engine zpracovává požadavek na překlad, načítá relevantní termíny ze všech připojených glosářů pomocí sémantického vyhledávání — porovnává význam vstupního textu s uloženými zdrojovými termíny, ne přesné řetězce.
| Pole | Popis |
|---|---|
| Zdrojový jazyk | Jazyk zdrojového textu nebo * pro libovolný zdroj |
| Cílový jazyk | Jazyk cílového textu nebo * pro libovolný cíl |
| Zdrojový text | Termín ve zdrojovém jazyce |
| Cílový text | Povinný překlad (nebo stejný termín u nepřekládaných výrazů) |
| Typ | custom_translation nebo non_translatable |
| Nápověda | nepovinné upřesnění kontextu pro rozlišení významu termínu (např. "podstatné jméno, funkce produktu") |
Glosáře patří organizaci#
| Akce | Efekt |
|---|---|
| Vytvořit glosář | Existuje na úrovni organizace a nepoužije se nikde, dokud ho nepřipojíte |
| Připojit ho k enginu | Pro překlady tohoto enginu budou k dispozici všechny jeho termíny |
| Připojit ho k několika enginům | Stejné termíny řídí všechny — upravíte je jednou a každý engine se podle nich zařídí |
| Připojit několik glosářů k jednomu enginu | Jejich termíny se spojí do jednoho fondu pro načítání |
| Odpojit ho od enginu | Engine ho přestane používat. Glosář i jeho termíny zůstanou zachované. |
| Smazat glosář | Nelze, pokud ho stále používá nějaký engine — nejdřív ho odpojte. Smazáním se smažou i jeho termíny. |
| Smazat engine | Glosáře i termíny zůstanou. Patří organizaci, ne enginu. |
Pořadí připojení nehraje žádnou roli. Když dva připojené glosáře definují stejný zdrojový text pro stejnou dvojici jazyků, může vyhrát kterýkoli z nich — mějte jeden termín jen na jednom místě.
Glosáře spravujete v části Glossaries v postranním panelu organizace. Na kartě Glossary enginu vidíte termíny, které právě používá, a můžete glosáře připojovat nebo odpojovat.
Zdrojové jazyky#
Glosář určuje, které zdrojové jazyky pokrývá. custom_translation, jehož zdrojový jazyk mezi nimi není, se při zápisu odmítne — ve všech cestách včetně dashboardu, API, použitého návrhu enginu a provisioningu. Kontrola používá stejné benevolentní párování jazyků jako při čtení, takže glosář pokrývající en přijme termín en-US.
Když zdrojové jazyky necháte prázdné, glosář přijme jakýkoli zdrojový jazyk.
Nepřekládané termíny jsou výjimkou: není tu žádný překlad zdrojového jazyka, ke kterému by se vázaly. Ukládají se také jen jednou proti zástupnému cílovému jazyku bez ohledu na to, jaký cíl pošlete — termín je chráněný ve všech jazycích, takže kopie pro jednotlivé jazyky by byly duplicitní.
Typy glosářů#
Vlastní překlady#
Vynuťte pro termín konkrétní překlad. Engine vždy použije váš překlad místo překladu modelu.
| Zdrojový text | Cílový text | Zdrojový jazyk | Cílový jazyk |
|---|---|---|---|
| Deploy | Bereitstellen | en | de |
| 911 | 112 | en | de |
| workspace | espace de travail | en | fr |
Vlastní překlady použijte pro:
- Produktovou terminologii se zavedenými překlady
- Kulturní adaptace (tísňová čísla, měrné jednotky)
- Termíny, u kterých model opakovaně volí nesprávné synonymum
Nepřekládané výrazy#
Zabraňte tomu, aby se termín překládal. Engine ponechá zdrojový text beze změny v každém cílovém jazyce.
| Zdrojový text | Cílový text | Typ |
|---|---|---|
| Lingo.dev | Lingo.dev | non_translatable |
| OAuth | OAuth | non_translatable |
| GraphQL | GraphQL | non_translatable |
Nepřekládané výrazy použijte pro:
- Názvy značek a produktů
- Technické protokoly a standardy
- Vlastní jména, která mají zůstat ve zdrojovém jazyce
Sémantické párování#
Termíny v glosáři se párují podle významu, ne podle přesného porovnání řetězců. Když engine přijme požadavek na překlad, vygeneruje embeddingy pro vstupní text a najde termíny se sémanticky podobným zdrojovým textem.
To znamená, že termín pro "Deploy" se spáruje i s "Deploying", "deployment" a "deploy your application" — bez samostatných záznamů pro každou variantu.
Pole nápovědy
Pole nápovědy použijte k rozlišení termínů s více významy. Například termín pro "bank" s nápovědou "financial institution" se nespáruje s "river bank" ve vstupním textu.
Zástupné jazyky#
Nastavte zdrojový nebo cílový jazyk na *, aby se termín použil pro všechny dvojice jazyků.
Běžné vzory:
| Zdrojový text | Zdrojový jazyk | Cílový jazyk | Případ použití |
|---|---|---|---|
| Lingo.dev | * | * | Nikdy nepřekládejte název značky v žádném jazyce |
| API | en | * | Ponechte "API" nepřeložené ve všech cílových jazycích |
| Deploy | en | de | Použijte pro tento anglický termín konkrétní německý překlad |
Zástupné termíny a termíny pro konkrétní jazyk se kombinují — navzájem se nepřepisují.
Párování jazyků#
Termíny v glosáři se párují i napříč regionálními variantami, nejen podle přesných kódů jazyků. Termín de se použije pro de-DE; termín de-DE se použije pro požadavek s obecným de. Sesterské varianty jako de-DE a de-AT nikdy termíny nesdílejí. Když odpovídá více možností, vyhraje výchozí region podle CLDR. Stejná pravidla řídí i hlasy značky, pravidla a konfigurace modelů. Úplné chování včetně pravidla bezpečnosti skriptů pro vlastní překlady najdete v části Locale Resolution.
Glosář vs. pravidla vs. hlasy značky#
Každý z nich má v konfiguraci engine jinou roli:
| Glosář | Pravidlo | Hlas značky | |
|---|---|---|---|
| Řídí | Jednotlivé termíny | Jazykové konvence | Celkový tón a styl |
| Granularita | Po termínech | Po pravidlech | Text pro konkrétní jazyk |
| Párování | Sémantické (podle významu) | Zahrnou se všechna odpovídající pravidla | Jeden text s nejlepší shodou |
| Priorita | Nejvyšší – má přednost před úsudkem modelu | Střední – vede model | Nejnižší – nastavuje kontext |
| Příklad | "Deploy" → "Bereitstellen" | "Abbreviate Straße to Str." | "Use informal du, technical tone" |
Všechny tři jsou kontejnery na úrovni organizace, které engine používá po připojení: glosáře obsahují termíny, rulesets obsahují pravidla a hlas značky obsahuje jeden text pro každý jazyk.
Priorita pravidel
Termíny v glosáři mají v hierarchii enginu nejvyšší prioritu. Pokud je termín v glosáři v konfliktu s pravidlem, vyhrává glosář. Pravidla navrhujte tak, aby glosář doplňovala, ne duplikovala.
Použití glosářů s API#
Termíny v glosáři se použijí automaticky, když zavoláte localize endpoint. Engine z glosářů, které používá, načte pro dvojici zdrojového a cílového jazyka sémanticky relevantní termíny a zahrne je do promptu. Nejsou potřeba žádné další parametry.
| Volání | Účel |
|---|---|
POST /glossaries | Vytvořit glosář pro organizaci |
GET /organizations/:id/glossaries | Vypsat glosáře organizace s počty termínů a enginů |
GET /glossaries/:id/glossary-items | Vypsat termíny glosáře seskupené podle zdrojového textu |
POST /glossary-items s glossaryId | Přidat termín do glosáře |
PUT /engines/:id/glossaries | Nahradit sadu glosářů, které engine používá |
DELETE /engines/:id/glossaries/:glossaryId | Přestat používat jeden glosář v enginu |
GET /engines/:id/glossary-items | Vypsat všechny termíny, které engine právě používá |
ownerEngineId na POST /glossary-items stále funguje — zapisuje do výchozího glosáře enginu. Upřednostněte glossaryId.
Přístup#
org:glossary:read a org:glossary:edit řídí glosáře i termíny v nich; připojení glosáře k enginu navíc vyžaduje na tomto enginu i oprávnění engine:edit. Oprávnění pro konkrétní glosář dává někomu právo číst a upravovat jen jeden glosář místo všech glosářů v organizaci. Viz Roles & Permissions.
Správa glosářů přes MCP#
Pokud používáte Lingo.dev MCP server, váš AI coding assistant může glosáře a jejich termíny spravovat přímo:
"Create a glossary called Product terms covering English, and
apply it to the web engine.""Add a term: translate 'workspace' to 'espace de travail'
for English to French.""Mark 'GraphQL' as non-translatable for all locales."