.XML – Android Strings

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 lze specifikovat při nahrát a/nebo Stáhnout souboru. V závislosti na metodě nahrát/Stáhnout (API, CLI, Repo sync atd.) je lze specifikovat v dotaz parametrech `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 varianta XML specifická pro Android, kterou lze použít k načtení překládaný text obsah do aplikací pro Android. Jeho kořenovým elementem je <resources> s mnoha vnořenými elementy <string>, které ukládají řetězec čekající na překlad. Můžete použít Android Studio k vygenerování těchto souborů prostředků a použít Phrase ke správě překladu.

Android Studio používá vlastnost překládaný text k označení, zda obsah potřebuje být přeložen. Ve Phrase je tato vlastnost ignorována. Není třeba tyto Strings posílat do Phrase. Pokud by řetězec neměl být překládán, definujte jej v samostatném souboru prostředků se všemi nepřekládaný text (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 odpovídal požadavkům konkrétního formátu. Příklad: `$s' => '$@`

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

Identifikátor	unescape_linebreaks
Typ	boolean
Nahrání	Ano
Stažení	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	Uzavře 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ů odsazení

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

Identifikátor	unescape_tags
Typ	boolean
Nahrání	Ano
Stažení	Ne
Výchozí	false
Popis	Všechny znaky `<` budou převedeny na `<` a všechny znaky `>` budou převedeny 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` attribute 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` attribute do výsledného XML. Při vypnutí (výchozí) je atribut `Nástroje:ignorovat` z exportovaných souborů vynechán. To pomáhá udržovat soubory Zdroje čisté a zabraňuje 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č zabrání dodatečnému escapování obsahu.

Identifikátor	escape_android_chars
Typ	boolean
Nahrát	Ne
Stáhnout	Ano
Výchozí	false
Popis	Escapuje `@`, `?` a `záložka` Android special characters pomocí prefixu zpětného lomítka.

Identifikátor	unescape_android_chars
Typ	boolean
Nahrání	Ano
Stažení	Ne
Výchozí	false
Popis	Odstraňuje escapování `\\@`, `\\?`, `\\t` a `\\uXXXX` (Unicode znak s kódem XXXX).

Vzor kódu

<?xml version="1.0" encoding="UTF-8"?>
<resources>
    <string name=\"boolean_key\">--- true
</string>
    <string name="empty_string_translation"/>
    <!-- This is the beautiful description for this key! -->
    <string name=\"key_with_description\">Check it out! This key has a description! (At least in some formats)</string>
    <string name=\"key_with_line-break\">This translations contains
a line-break.</string>
    <string name=\"nested.deeply.key\">Hey, this key is nested even deeper.</string>
    <string name=\"nested.key\">This key is nested inside a namespace.</string>
    <string name="null_translation"/>
    <plurals name="pluralized_key">
        <item quantity=\"one\">Only one plural forms found.</item>
        <item quantity=\"other\">Hej, máte %s množných čísel!</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íč se zprávou.</string>
    <string name=\"unverified_key\">Tento překlad je neověřeno a čeká na něj. (V některých formátech také stáhnout tento stav)</string>
</resources>

Množná čísla pro soubory Android XML

Pro hodnoty množného čísla přiřadit speciální <plurals> tag takto:

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