Gettext
Překládejte cílové hodnoty v souborech PO se zachováním kontextu zpráv a identity zdroje a s ohledem na omezení rekonstrukce množných tvarů.
Gettext uchovává zdrojové znění i překlad v jedné položce. Obslužný modul pro soubory po čte msgid a zapisuje překlad do msgstr, zdroj přitom ponechává na místě. Pomocí msgctxt také rozlišuje stejná slova použitá v různých situacích.
Kontext odlišuje zprávy #
Například tyto položky mohou mít různé překlady slova „Back“:
msgctxt "checkout navigation"
msgid "Back"
msgstr ""
msgctxt "product surface"
msgid "Back"
msgstr ""Jde o samostatné jednotky, přestože mají shodné msgid. Kontext se předává také jako nápověda pro překlad. Řádky s komentáři a příznaky se u položek zachovávají. To ale neznamená, že se každý komentář interpretuje jako instrukce nebo že se aktualizují příznaky kontroly.
Specializovaný parser zpracovává podporovaná pole PO v uvozovkách a navazující řádky. Používejte vstupy v kódování UTF-8; libovolná starší kódování parser nepřevádí. Automatické vyhledávání .pot nespadá do vymezeného rozsahu odvozování .po v CLI.
Rekonstrukce množných tvarů má svá omezení #
U položky s množnými tvary se z msgid a msgid_plural stanou samostatné textové jednotky pro jednotné a množné číslo. Obslužný modul vytvoří alespoň dvě cílové pozice. Pokud jich stávající překlad obsahuje více, nezměněné položky si zachovají schválené tvary. Změní-li se některý z prvních dvou cílových tvarů, do dalších pozic se vloží nová hodnota množného čísla, nikoli samostatně vygenerované tvary.
Před kompilací zkontrolujte výstup s množnými tvary. Pokud jazyk vyžaduje několik odlišných tvarů, musí každá pozice obsahovat správné znění a hlavička Plural-Forms tomu musí odpovídat. Přednost mají stávající cílové hlavičky; při prvním výstupu se převezme zdrojová hlavička a hodnota Language se změní na cílový jazyk. Obslužný modul nepřepisuje Plural-Forms podle cílového jazyka.
Aktualizace a serializace #
Změny se určují porovnáním s předchozím zdrojem podle kontextu, identity zprávy a jednotky pro jednotné či množné číslo. Zachované hodnoty msgstr se přebírají ze stávajících cílových položek. Změna identity zdroje může vést k tomu, že se zpráva považuje za novou, i když by její schválený překlad byl stále použitelný.
Při rekonstrukci se zachovávají zdrojová pole, řádky s komentáři i okolní rozvržení položek a nahrazují se hodnoty msgstr a příslušná hlavička. Formátování hodnot překladu v uvozovkách se může změnit. Kromě syntaktické analýzy souboru ověřte také počty zpráv a metadata množných tvarů.
Nastavte a zkompilujte katalog #
CLI odvozuje po z .po. Zdrojové katalogy vyberte v konfiguraci CLI nebo přes GitHub.
Výstup zkompilujte nebo importujte pomocí nástrojů Gettext dané aplikace. Poté otestujte různé počty pro množné tvary i vyhledávání podle kontextu. Opakující se hodnoty množných tvarů a hlavičky zkontrolujte i tehdy, když syntaktická analýza proběhne úspěšně: právě ony určují, co aplikace zobrazí pro jednotlivé počty.