Překlad JSON souborů: lokalizace softwaru bez chyb

Překlad aplikace často začíná souborem, který na první pohled připomíná seznam krátkých vět. Ve skutečnosti jde o propojenou součást produktu: stejné slovo může označovat tlačítko, stav objednávky nebo název oprávnění. U lokalizace JSON souborů proto nestačí přeložit hodnoty do jiného jazyka. Potřebujete zachovat strukturu, význam jednotlivých akcí a vazbu na to, co aplikace skutečně dělá. Tento postup pomůže připravit zadání tak, aby jazyková práce hladce navázala na vývoj.

Nejdřív určete, co se smí měnit

JSON je datový formát, nikoli překladatelská instrukce. Zadavatel musí určit, které hodnoty obsahují uživatelský text a které mají technickou funkci. Názvy klíčů, identifikátory, URL, měrné jednotky nebo hodnoty stavů se obvykle ponechávají podle dohody s vývojářem. I slovo, které vypadá jako běžná angličtina, může být součástí logiky programu.

Před zahájením připravte malý vzorek obsahující krátké popisky, delší nápovědu, odkaz i zprávu s proměnnou. Ověřte, že jej lze z překladatelského nástroje vrátit do aplikace. Tento jednoduchý zkušební průchod je užitečnější než pozdější ruční opravy tisíců řetězců. Zároveň se ukáže, zda soubor obsahuje komentáře nebo rozšíření, která čistý JSON nepodporuje a váš systém přesto používá.

Krátké texty potřebují více kontextu

Samostatné „Open“ může znamenat příkaz otevřít, označení otevřené položky nebo charakteristiku stavu. Překladatel tuto informaci ze samotného slova bezpečně neodvodí. Ke každé skupině řetězců proto přidejte obrazovku, účel a informaci, kdo text uvidí. Rozlišujte administrátora, koncového uživatele a pracovníka podpory. Stejná akce pro ně může vyžadovat jinou míru vysvětlení.

Pomáhají snímky obrazovek se zvýrazněným místem použití, krátké video průchodu aplikací nebo přístup do testovacího prostředí. U citlivých aplikací lze připravit anonymizované ukázky. Klíče srozumitelně pojmenované podle funkce jsou výhodou, ale nenahrazují skutečný kontext. Do poznámek přidejte také informaci, jestli se výraz zobrazuje samostatně, ve větě nebo jako součást navigace.

Proměnné a množné číslo patří do zadání

Zástupné symboly, například jméno uživatele nebo počet dokumentů, musí zůstat funkční. Překladatel potřebuje znát jejich zápis, typ hodnoty a přípustnou manipulaci. Pořadí se může v cílové větě změnit, samotný název proměnné však musí odpovídat aplikaci. Zvlášť označte značky formátování, vložené odkazy a sekvence pro zalomení řádku.

České množné číslo nelze spolehlivě vyřešit anglickou dvojicí jednotného a množného tvaru. Dokumentace Unicode ICU popisuje mechanismy výběru různých podob zprávy podle počtu nebo jiné hodnoty. Překlad tak může vyžadovat spolupráci vývojáře, nikoli pouhou změnu slov. Nedávejte překladateli úkol obejít chybějící funkci neobratnou větou, pokud lze správně upravit jazykovou logiku produktu.

Jedna akce má mít jednotný název

Před překladem si vyberte základní termíny produktu: pracovní prostor, účet, organizace, projekt, uložit nebo odeslat. Rozhodněte, zda některé názvy zůstávají v originále a zda uživatelům tykáte, nebo vykáte. Je vhodné určit také způsob oslovování v chybových hláškách a tón bezpečnostních upozornění. Humor, který funguje v uvítání, může v informaci o neúspěšné platbě působit nevhodně.

Glosář nesmí být jen seznam izolovaných ekvivalentů. U sporných pojmů popište jejich funkci a přidejte příklad. „Účet“ může být uživatelský profil, účet zákaznické společnosti i účetní položka. Pokud aplikace používá několik podobných konceptů, jejich odlišení se musí zachovat v rozhraní, nápovědě i dokumentaci podpory. Jinak uživatel ztratí orientaci při přechodu mezi jednotlivými částmi produktu.

Soubory předávejte jako řízenou verzi

Praktická předávka obsahuje zdrojový jazyk, cílové jazyky, seznam souborů, označení verze a kontaktní osobu pro dotazy. Určete, kdo smí během překladu měnit originál. Když vývoj pokračuje, je lepší dodat přehled změněných klíčů než opakovaně posílat celý export bez vysvětlení. Překladatel pak ví, co skutečně přibylo a kde došlo ke změně významu.

U větších projektů může pomoci výměnný formát XLIFF, který slouží k přenosu lokalizovatelných dat mezi nástroji. Není však automatickým řešením všech potíží. Nejprve ověřte podporovanou variantu exportu a opětovného importu ve vašem systému. Domluvte se, zda se vrací původní JSON, bilingvní soubor, seznam dotazů nebo také glosář. Výstup musí odpovídat tomu, co umí zpracovat další krok vašeho procesu.

Kontrola v aplikaci odhalí jiné chyby než korektura

Jazyková revize kontroluje význam, pravopis a terminologii. Test v aplikaci přidává délku tlačítek, zalamování, překrývání prvků a správné dosazování hodnot. Obě kontroly se doplňují. Text může být jazykově bezchybný a přesto uživateli nepomoci, když jeho konec zmizí mimo dialog nebo tlačítko označuje jinou akci, než jakou provede.

Připravte scénáře pro prázdný seznam, jednu položku, několik položek, chybu sítě, zamítnuté oprávnění a obnovení hesla. Zkontrolujte také e-maily a upozornění mimo hlavní aplikaci. U dat, částek a časů posuďte regionální nastavení, nikoli jen překlad textu. Nálezy evidujte s identifikátorem řetězce, screenshotem a popisem očekávaného výsledku. Oprava pak může být přesně dohledána a znovu otestována.

Modelový příklad a checklist před předáním

Představte si aplikaci pro správu smluv. Na třech místech používá anglické „Archive“. Jednou jde o archiv dokumentů, podruhé o tlačítko pro přesun a potřetí o stav záznamu. Společný překlad „Archiv“ by nefungoval všude. Správné zadání tyto situace rozliší a prověří, zda vývoj nesdílí jeden klíč mezi významově odlišnými místy. Pokud ano, je vhodné klíč rozdělit ještě před překladem.

• Označte jazyk, region a skutečné uživatele aplikace.
• Dodejte vzorek exportu a potvrďte úspěšný zpětný import.
• Sepište chráněné prvky, proměnné a omezení délky.
• Připojte screenshoty, glosář a návod k přístupu do testu.
• Určete verzi zdroje a způsob předávání dalších změn.
• Naplánujte jazykovou kontrolu i průchod hotovou aplikací.

Do rozpočtu zahrňte také vyjasnění dotazů a závěrečnou opravu nalezených problémů. Samotný počet slov nevystihuje náročnost stovek krátkých řetězců bez kontextu. Podstatné jsou i množné tvary, počet obrazovek, práce s technickými prvky a dostupnost referenční verze. Dobrá příprava dává všem stranám stejnou představu o tom, co bude skutečně hotové.

Při dlouhodobé spolupráci si stanovte pravidla pro převzetí nové verze. Vedle souboru předávejte informaci, které obrazovky se změnily a zda úprava ovlivňuje dříve schválené texty. Pouhé technické porovnání řetězců nemusí zachytit situaci, kdy se nezměnil text, ale jeho funkce. Stejná hláška se například přesunula z informačního panelu do potvrzení nevratné akce. Udržujte proto vazbu mezi jazykovou prací a změnami produktu. Odpovědná osoba také rozhodne, které nálezy brání vydání a které lze opravit v dalším cyklu. Tato dohoda usnadní plánování a zabrání tomu, aby se hotový překlad hodnotil jen podle existence souboru bez ověření, že uživatelé novou verzi skutečně pochopí a bezpečně dokončí své běžné úkoly.

Časté otázky k překladu JSON souborů

Stačí poslat pouze export bez aplikace?

Pro orientační posouzení ano. Pro přesnou lokalizaci připojte alespoň vysvětlení klíčů a obrázky hlavních obrazovek. U nejednoznačných textů bude jinak nutné kontext doplnit během práce.

Překládají se také názvy klíčů?

Pouze pokud to zadavatel výslovně určí a systém takovou změnu podporuje. Obvyklým předmětem překladu jsou uživatelské hodnoty, zatímco identifikátory slouží k propojení s aplikací.

Lze omezit překlad přesným počtem znaků?

Ano, omezení ale musí být známé předem. Někdy je lepší upravit rozložení rozhraní než zkrátit důležitou informaci tak, že uživatel přestane rozumět jejímu významu.

Jak objednat aktualizaci již přeložené verze?

Pošlete předchozí schválený výstup, nový zdroj a přehled změn. Uveďte, zda potřebujete pouze nové řetězce, nebo také revizi dřívější terminologie v celém produktu.

Připravujete aplikaci pro další jazyk? Přes kontaktní formulář pošlete vzorek JSON, cílové jazyky a několik obrazovek. Na jejich základě lze určit rozsah jazykové práce, potřebné podklady i vhodný způsob předání do vývoje.

Zdroje a další informace: Unicode ICU: formátování zpráv, OASIS: specifikace XLIFF 2.1.