Prostý text
Překládejte textové soubory řádek po řádku a zachovejte každý řádek na stejném místě jako ve zdroji.
Soubory s prostým textem, například popisy aplikací v obchodech a poznámky k vydání, neobsahují značky ani klíče. Modul pro zpracování souborů txt překládá každý řádek samostatně a zapisuje překlad na původní místo. Cílový soubor tak má stejný počet řádků jako zdrojový.
Řádky a jednotky #
Například:
Plan your trips offline.
• Download maps for any region
• Share routes with friendsZ každého řádku s textem vznikne jedna překladová jednotka, jejímž klíčem je číslo řádku. V tomto příkladu se překládají řádky 1, 3 a 4. Prázdné řádky ani řádky obsahující pouze mezery nebo tabulátory netvoří překladové jednotky a kopírují se beze změny.
Mezery a tabulátory na začátku a na konci řádku zůstávají mimo překladovou jednotku, takže se při překladu zachová odsazení i koncové mezery. Překládá se pouze text mezi nimi.
Sestavení výstupu #
Při sestavování výstupu se nahradí text každého řádku v aktuálním zdrojovém souboru. Vše ostatní se zachová bajt po bajtu: prázdné řádky, odsazení, zakončení jednotlivých řádků (LF nebo CRLF, včetně jejich kombinací) i to, zda soubor končí znakem nového řádku. Cílový soubor má proto stejný počet řádků jako zdrojový.
Mezery a zalomení řádků na začátku a na konci překladu se odstraní. Každé zalomení uvnitř překladu se nahradí jednou mezerou, takže překlad nikdy nepřidá další řádek. Pokud je překlad prázdný, sestavení výstupu pro daný jazyk selže.
Překlad se znovu použije podle nezměněného textu řádku a jeho pozice v souboru, stejně jako u titulkových bloků ve formátu SubRip. Změna odsazení řádku nevyžaduje nový překlad. Při přidání nebo odebrání řádků si řádek s textem, který se v souboru vyskytuje jen jednou, zachová svůj překlad. Řádek s textem, který se vyskytuje vícekrát, se přeloží znovu. Z cílového souboru s jiným počtem řádků, než má předchozí zdrojový soubor, nelze znovu použít žádný text. Předchozí zdrojový soubor proto uchovávejte společně s odpovídajícím schváleným cílovým souborem.
Nastavení a kontrola textu #
CLI a GitHub App odvozují txt z .txt. Soubor .txt může spadat pouze pod položku souborů, jejíž vzor končí na .txt, například metadata/en/*.txt, nebo která nastavuje "format": "txt". Položka s "format": "txt" vybírá pouze soubory .txt. Obecný vzor, například docs/en/**/*, přeskakuje soubory .txt, takže soubory jako LICENSE.txt nebo requirements.txt se nepřekládají. Pozdější položka, která výslovně uvádí .txt, je ale stále může vybrat. Obecná položka s "format": "txt" obdobně přeskakuje obrázky a další soubory kromě textových. Podrobnosti o výběru souborů najdete na stránkách Konfigurace CLI nebo GitHub. V CLI nelze omezit rozsah podle klíčů, protože čísla řádků označují pozice, nikoli stabilní klíče.
Každý řádek se překládá jako samostatná jednotka. I odstavec zalomený do více řádků se tedy překládá řádek po řádku. Pokud cílový jazyk vyžaduje změnu slovosledu ve větě, ponechte každý odstavec na jednom řádku. Překlad zkontrolujte tam, kde se bude používat: stránka aplikace v obchodě nebo pole s omezenou délkou může odmítnout překlad, který je delší než zdrojový text.