.XML - Android (Řetězce)

Obsah je strojově přeložen z angličtiny s použitím Phrase Language AI.

Přípony souborů	.xml
API rozšíření	xml
Import	Ano
Export	Ano
Podpora plurálových tvarů	Ano
Podpora pro popis	Ano
Možnosti formátu Tyto možnosti, které lze specifikovat při nahrávání a/nebo stahování souboru. V závislosti na metodě nahrávání/stahování (API, CLI, synchronizace repozitáře atd.) mohou být specifikovány v parametrech dotazu `Nahrát`, `Stáhnout` nebo v konfiguračním souboru `phrase.yml`.	convert_placeholder escape_linebreaks unescape_linebreaks enclose_in_cdata indent_size indent_style unescape_tags include_tools_ignore include_tools_locale_definition escape_android_chars unescape_android_chars

Android XML je specifická varianta XML pro Android, která může být použita k načtení přeloženého obsahu do aplikací Android. Jeho kořenový prvek je <resources> s mnoha <string> prvky, které jsou pod ním a ukládají řetězce čekající na překlad. Můžete použít Android Studio k vygenerování těchto souborových zdrojů a použít Phrase k řízení překladu.

Android Studio používá vlastnost překládaný text k označení, zda je obsah potřeba přeložit. V Phrase je tato vlastnost ignorována. Není třeba tyto řetězce posílat do Phrase. Pokud by se řetězec neměl překládat, definujte ho v samostatném souboru s nepřekládanými řetězci (např. donottranslate.xml).

Možnosti formátu

Identifikátor	convert_placeholder
Typ	boolean
Nahrát	Ne
Stáhnout	Ano
Výchozí	false
Popis	Zástupný znak bude převeden tak, aby vyhovoval specifickým požadavkům formátu. Příklad: `$s' => '$@`

Identifikátor	escape_linebreaks
Typ	Booleovský typ
Nahrát	Ne
Stáhnout	Ano
Výchozí	false
Popis	Všechny zalomení řádků budou escapovány jako `\n`

Identifikátor	unescape_linebreaks
Typ	boolean
Nahrát	Ano
Stáhnout	Ne
Výchozí	false
Popis	Všechny `\n` budou importovány jako skutečné nové řádky

Identifikátor	enclose_in_cdata
Typ	boolean
Nahrát	Ne
Stáhnout	Ano
Výchozí	false
Popis	Zahrnuje překlady obsahující HTML tagy do CDATA

Identifikátor	indent_size
Typ	integer
Nahrát	Ne
Stáhnout	Ano
Výchozí	4
Popis	Určuje počet znaků pro odsazení

Identifikátor	indent_style
Typ	řetězec
Nahrát	Ne
Stáhnout	Ano
Výchozí	Prostor
Popis	Určuje znak odsazení. Povolené hodnoty jsou `prostor` a `záložka`.

Identifikátor	unescape_tags
Typ	boolean
Nahrát	Ano
Stáhnout	Ne
Výchozí	false
Popis	Všechny `<` znaky budou deescapovány na `<` a všechny `>` znaky budou deescapovány na `>` pro tagy.

Identifikátor	include_tools_locale_definition
Typ	boolean
Nahrát	Ne
Stáhnout	Ano
Výchozí	false
Popis	Zahrnout `nástroje:kód jazyka` atribut do výsledného XML.

Identifikátor	include_tools_ignore
Typ	boolean
Nahrát	Ne
Stáhnout	Ano
Výchozí	false
Popis	Zahrnout `nástroje:ignorovat` atribut do výsledného XML. Když je zakázáno (výchozí), atribut `nástroje:ignorovat` je vynechán z exportovaných souborů. To pomáhá udržovat soubory se zdroji čisté a vyhýbat se zahrnutí atributů pro potlačení lintu specifických pro vývoj.

Identifikátor	preserve_cdata
Typ	boolean
Nahrát	Ne
Stáhnout	Ano
Výchozí	false
Popis	Pokud obsah překladu již obsahuje tag CDATA, tento přepínač zabraňuje dalšímu escapování obsahu.

Identifikátor	escape_android_chars
Typ	boolean
Nahrát	Ne
Stáhnout	Ano
Výchozí	false
Popis	Escapuje `@`, `?` a `Tab` Android speciální znaky s prefixem zpětného lomítka.

Identifikátor	unescape_android_chars
Typ	boolean
Nahrát	Ano
Stáhnout	Ne
Výchozí	false
Popis	Deescapuje `\@`, `\?`, `\t` a `\uXXXX` (Unicode znak s kódem XXXX).

Vzor kódu

<?xml version="1.0" encoding="UTF-8"?>
<zdroje>
    <string name="boolean_key">--- true
</string>
    <string name="empty_string_translation"/>
    <!-- Toto je krásný popis pro tento klíč! -->
    <řetězec name="key_with_description">Podívejte se na to! Tento klíč má popis! (Alespoň v některých formátech)</string>
    <string name="key_with_line-break">Tato překlad obsahuje
řádkový zlom.</string>
    <string name="nested.deeply.key">Ahoj, tento klíč je vnořen ještě hlouběji.</string>
    <string name="nested.key">Tento klíč je vnořen uvnitř jmenného prostoru.</string>
    <string name="null_translation"/>
    <plurals name="pluralized_key">
        <item quantity="one">Nalezen pouze jeden plurální tvar.</item>
        <item quantity="other">Ahoj, máš %s pluralizací!</item>        
    </plurals>
    <string-array name="sample_collection">
        <item>první položka</item>
        <item>druhá položka</item>
        <item>třetí položka</item>
    </string-array>
    <string name="simple_key">Jen klíč s zprávou.</string>
    <string name="unverified_key">Tento překlad ještě nebyl ověřen a čeká na to. (V některých formátech také exportujeme tento stav)</string>
</resources>

Plurály pro XML soubory Androidu

Pro plurální hodnoty přiřaďte speciální <plurals> tag jako tento:

<plurals name="messages">
        <item quantity="one">Jedna zpráva přijata.</item>
        <item quantity="other">%s zpráv přijato.</item>        
</plurals>