Jak bezpečně aktualizovat jeden klíč nebo termín

Přeložte znovu vybranou část, zachovejte okolní obsah a zkontrolujte zamýšlenou opravu i to, co zůstalo beze změny.

Cílená oprava má dva znaky úspěchu: vybraný obsah se zlepší a ostatní schválený obsah zůstane nedotčený. Uložte si stávající překlad i odpovídající revizi zdroje, abyste mohli ověřit obojí.

Tento návod použijte, když znáte konkrétní klíč nebo termín, který chcete opravit. U běžných změn zdroje postupujte podle návodu na zachování překladů při aktualizacích. U již odeslané práce nejprve zkontrolujte její stav obnovení, než požádáte o další zpracování.

Do porovnání zahrňte i schválený sousední obsah #

Ukázkový katalog může obsahovat:

json
{
  "account": {
    "invitation": "Approval is required before access is granted.",
    "support": "Contact support"
  }
}

Předpokládejme, že je třeba opravit pouze překlad account.invitation. Uložte si překlad i revizi zdroje včetně schváleného znění account.support, které chcete zachovat.

Zvolte způsob opravy znění #

Potřebujete-li přesnou jednorázovou opravu, upravte cílovou hodnotu přímo, zkontrolujte ji v aplikaci a uložte ověřený katalog do repozitáře. Běžné aktualizace zdroje mohou tuto úpravu zachovat, dokud se zdrojový text dané zprávy nezmění.

Před opětovným generováním nejprve doplňte informace, které překlad potřebuje k vytvoření jiného výsledku. Přidejte schválený termín do glosáře příslušného engine, opravte opakovaně používanou instrukci v jeho pravidlech nebo upřesněte kontext JSONC dané zprávy. Poté znovu vygenerujte dotčené klíče. Pokud zdroj i instrukce zůstanou stejné, může nové generování vrátit stejné znění.

Vymezte výběr termínu podle jeho významu #

Než vyberete zprávy, definujte význam termínu. Například „workspace“ může v produktu označovat sdílený prostor pro projekty, zatímco jiná pasáž popisuje fyzický pracovní prostor. Do glosáře zaznamenejte zamýšlený význam v produktu a cílový termín schválený týmem. Poté vyberte pouze zprávy, které termín používají v tomto významu. Podrobněji se tomuto rozhodování věnuje část Vymezení termínů.

Vyberte existující cílový klíč pomocí CLI #

V nakonfigurovaném projektu, který používá tento zdroj JSON na cestě locales/en/account.json:

bash
lingo push "locales/en/account.json" --key "account.invitation" --wait

U formátu JSON příkaz --key znovu vygeneruje vybrané jednotky, i když se zdrojový text nezměnil. Aktualizuje tyto klíče pro každý nakonfigurovaný jazyk, pro který již existuje cílový soubor, a sloučí nové hodnoty s obsahem tohoto souboru.

Před novým generováním si uložte stávající opravy: překlady zachycené tímto příkazem push mohou být u vybraných klíčů nahrazeny. Chcete-li odhalit úpravy překladů provedené po odeslání, vynechte --wait a před stažením výsledků zkontrolujte lingo pull --dry-run. Řešení konfliktů popisuje část Klasifikace ručních úprav při příkazu pull.

Nové generování klíčů ponechává výchozí stav celého zdroje beze změny, ať už výsledky stáhne push --wait, nebo samostatný příkaz pull. Neodeslané běžné úpravy zdroje se proto stále odešlou při pozdějším běžném příkazu push.

Vzory klíčů podporují přesné klíče, předpony objektů a zástupné znaky * pro celé segmenty. Vzor auth.login může zahrnout auth.login.title, aniž by odpovídal auth.login_url. Zástupné znaky uzavřete do uvozovek a pro zadání více vzorů opakujte --key.

JSONC, TypeScript a PHP se při takto vymezeném novém generování chovají stejně. YAML a YAML s jazyky na kořenové úrovni mohou vybrané překlady ponechat beze změny. Pro přesnou opravu upravte překlad přímo, nebo si před novým generováním celého souboru uložte schválené překlady. Část Rozsahy CLI popisuje chování jednotlivých formátů a určuje zápis klíčů.

Najděte klíče nebo soubory dotčené termínem #

Najděte zdrojové zprávy, které používají termín v zamýšleném významu, a zkontrolujte jejich kontext. Pomocí --key v příkazu uvedeném výše vyberte jejich podporované klíče. U formátů, které vyžadují nové generování celého souboru, si uložte schválené překlady a znovu zpracujte dotčené zdrojové soubory, například:

sh
lingo push 'docs/en/workspaces.md' --force --wait

Použijte cestu ke zdroji, která je již vybraná v konfiguraci. Tím nahradíte překlady daného souboru pro nakonfigurované cílové jazyky. Porovnejte celou přepsanou zprávu nebo celý soubor včetně textu kolem termínu.

Ověřte změny, zachování obsahu i použití #

Porovnejte obsah na každé změněné cílové cestě s uloženou verzí. V uvedeném příkladu musí pozvánka zachovat požadavek na schválení před získáním přístupu a zpráva podpory musí odpovídat schválenému výchozímu znění. Pokud chybí okolní obsah nebo došlo k nečekaným přepisům, před přijetím výsledků zkontrolujte rozsah a výchozí stav.

Zkontrolujte proměnné a nastavení klíčů: uzamčení kopíruje zdrojový text, zachování ponechává cílovou hodnotu a ignorování odstraňuje obsah z výstupu formátu, který tuto funkci podporuje.

Načtěte výstup v běhovém prostředí, které jej používá. U dokumentů zkontrolujte změněnou pasáž, odkazy a komponenty. Než nahradíte ruční úpravy, vyřešte konflikty při příkazu pull. Poté uložte schválené překlady do repozitáře spolu s odpovídající revizí zdroje a souborem Lockfile.