Klíče se používají k identifikaci překládaných textů textových řetězců v softwarovém kódu. Díky tomu může Phrase odkazovat na tento klíč (jako kódové jméno pro překládaný textový řetězec) vždy jen jednou namísto pokaždé, když je tento řetězec třeba přeložit.
Ke klíči může být přiřazeno více překladů, z nichž každý odpovídá jinému kódu jazyka daného projektu. Funkce je podobná funkci primárního klíče v relačních databázích, přičemž překlady jsou atributem klíče. Klíče jsou uloženy v souborech opakovaného zdroje a slouží k identifikaci zdrojových a cílových jazyků.
Používání klíče umožňuje platformám pro správu lokalizace prezentovat překládaný text překladatelům bez nutnosti předkládat kód.
Klíče obvykle není nutné do projektu přidávat, protože jsou ideálně vytvořeny při nahrání souboru zdroje prostřednictvím záložky na stránce projektu.
Abyste zabránili nahrávání nebo vytváření klíčů, použijte funkci blokování klíčů. Pokud blokovaný klíč již existuje, nelze jej v editoru přeložit.
Chcete-li vyloučit klíče z exportu, použijte funkci vyloučení klíčů. Vyloučené klíče také nelze překládat v editoru.
Klíče v projektu lze kopírovat výběrem možnosti Více/Duplikovat klíč v oddílu stránky projektu nebo v horní části podokna Strings editoru.
Lze propojit různé překladové klíče se stejnými hodnotami v jednom nebo více projektech a automatizovat aktualizace obsahu. Propojené klíče se používají k zajištění konzistentnosti napříč projekty a odstranění opakujících se zakázek na totožném obsahu.
Změny klíčů lze vrátit z okna aktivity v postranním panelu editoru Strings.
Poznámka
Při práci s repozitáři (GitHub, GitLab atd.) a odstraňování klíčů musí být klíče odstraněny z Phrase i z úložiště, aby byly odstraněny trvale. Zabráníte tak náhodnému odstranění klíčů v důsledku chyb nebo nehod ve Phrase nebo úložišti.
Názvy klíčů musí být v rámci jednoho projektu unikátní.
Pro pojmenování klíčů existuje více strategií:
-
Popisný
Původní text je identifikován pomocí funkce. To může ztížit identifikaci textu při čtení kódu, ale zůstane tak konstantní.
Příklad:
-
Zdrojové řetězce (nedoporučuje se)
Samotný původní text se použije jako klíč, což usnadňuje identifikaci použití textu. To je riskantní, protože pokud se původní text změní, naruší se významové spojení s překladem.
Příklad:
Pokud nejsou klíče nahrány, lze je vytvořit ručně.
Klíč vytvoříte takto:
-
Na záložce klikněte na Přidat klíč.
Otevře se okno Přidat klíč.
-
Na záložce zadejte , , všechny dostupné a .
-
V případě potřeby povolte plurálové tvary na záložce .
-
V případě potřeby vyberte vyloučené jazyky na záložce .
-
V případě potřeby uveďte technické podrobnosti v záložce .
Například je možné nastavit limit počtu znaků pro překlady v . Pokud je nastaven, limit počtu znaků se při úpravě překladů příslušného klíče zobrazí v ukazateli v editoru Strings.
-
Klikněte na Uložit.
Klíč se přidá do projektu a lze jej zobrazit na záložce .
Odstraněním klíče z editoru nebo záložky se odstraní všechny související překlady tohoto klíče, tento krok je nevratný.
V projektech s více než 10 000 klíči se neuvedené klíče nebudou při dalším nahrávání počítat.
Blokování zabraňuje přidání celých klíčů do projektu. Pokud se v nahraném souboru objeví název blokovaného klíče, tento klíč se vynechá a do projektu se nepřidá.
Blokování se používá k vynechání klíčů z projektu, a tedy ze zpracování.
Obvykle blokované klíče:
-
Formát data a času.
-
Klíče obsahující konfiguraci.
-
Klíče způsobující problémy při správě.
Blokované klíče můžete spravovat v samostatném souboru, který se dále nezpracovává ani neudržuje.
Tyto klíče mohou způsobit problémy a v případě použití by měly být při vytvoření projektu zablokovány.
-
activemodel.errors* -
number.format* -
number.currency* -
number.percentage* -
datetime.prompts*
Klíč zablokujete takto:
-
Na stránce projektu vyberte záložku .
-
Klikněte na Přidat klíč do seznamu blokovaných klíčů.
Otevře se okno .
-
Zadejte název klíče nebo regulárního výrazu (regexp) a klikněte na Uložit.
Klíč je přidán do seznamu.
Tip
Chatboti umělé inteligence mohou být při generování a ověřování regexpu velmi efektivní.
Použijte Nástroje jako Regex101 k testování regexpu s různými vstupy.
Klíče lze později upravit kliknutím na nebo odstranit pomocí
.
Některé klíče může být nutné z určitých jazyků vyloučit a lze je označit jako vyloučené. Tyto klíče se nahrávají a existují v projektu, ale ignorují se.
Vyloučené překlady jsou:
-
Vyloučené z exportu souvisejícího jazyka.
-
Vyloučené ze zpráv souvisejících jazyků.
Pokud je obsah prázdný, nepočítá se jako nepřeložený.
-
Viditelné, ale nelze je editovat v překladovém editoru.
Možnosti vyloučení:
-
Vyloučit jeden překlad v jazyce v překladovém editoru.
-
Vyloučit více překladů v jazyce v překladovém editoru.
-
Vyloučit více překladů výběrem jazyků při vytváření nebo úpravě klíče.