Řetězce Apple

Překládejte hodnoty v tabulkách řetězců Apple se zachováním vyhledávacích klíčů a escapováním znovu sestaveného textu.

Tabulka řetězců Apple přiřazuje pevným vyhledávacím klíčům zobrazovaný text. Obslužná rutina pro soubory xcode-strings překládá hodnoty na pravé straně, zachovává klíče a zapisuje escapované řetězcové literály zpět do souboru .strings pro příslušný jazyk.

Klíče a hodnoty #

Například:

text
/* Checkout heading */
"checkout.title" = "Complete your order";
"delivery.estimate" = "Delivery within %d days";

Obě hodnoty na pravé straně představují textové jednotky. checkout.title a delivery.estimate zůstávají vyhledávacími klíči. Komentáře se zachovávají u příslušných položek, obslužná rutina ale jejich obsah nepřevádí na pokyny pro překlad. Pokud je krátký popisek nejednoznačný, využijte možnosti předávání kontextu, které překladové workflow podporuje.

Klíče a hodnoty v uvozovkách, znaky přiřazení a středníky patří k podporované syntaxi tabulek řetězců. Analyzátor dekóduje podporované escape sekvence; ve výstupu se escapují uvozovky, zpětná lomítka, znaky nového řádku, tabulátory a znaky návratu vozíku. Při nahrazování hodnot se zachovávají okolní komentáře i rozestupy mezi položkami.

Slučování a umístění prostředků #

Z předchozího zdroje se podle klíčů určuje, které hodnoty se změnily. Existující cíl poskytuje překlady, které se mají zachovat. Aktuální zdroj určuje sadu položek a komentáře. Při změně zpráv používejte běžné aktualizace zdroje; po změně pokynů pro překlad můžete záměrně obnovit celý soubor. Viz Rozsahy CLI.

Jazykové prostředky umístěte tam, odkud je aplikace načítá, například do en.lproj/Localizable.strings a de.lproj/Localizable.strings. Zdroj v Base.lproj má při odvozování cest jiný význam než adresář pojmenovaný podle jazyka. Cílové umístění zkontrolujte ve zvoleném nástroji; samotný překlad tabulky nenastavuje vývojový jazyk aplikace ani zařazení prostředků.

Nastavení a načtení tabulky řetězců #

CLI odvozuje xcode-strings z .strings. Pravidla pro výběr a cesty najdete v části Konfigurace CLI, informace o spravovaném výstupu do repozitáře v části GitHub.

Načtěte cílovou tabulku v aplikaci a otestujte specifikátory formátu se skutečnými hodnotami. Pro prostředky s výběrem tvarů množného čísla použijte stringsdict. Pokud projekt používá Katalogy řetězců, řiďte se místo toho pravidly pro slučování jejich sdílených souborů: přejmenováním samostatného katalogu pro každý jazyk by vzniklo jiné uspořádání prostředků.