.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 určit při nahrání a/nebo Stáhnout souboru. V závislosti na metodě nahrát/Stáhnout (API, CLI, Repo sync atd.) je lze určit v parametrech dotaz `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 obsahu do aplikací pro Android. Jejím kořenovým elementem je <resources> s četnými elementy <string> vnořenými pod ním, které ukládají Strings čekající na překlad. K vygenerování těchto souborů prostředků můžete použít Android Studio a k správě překladu použít Phrase.

Android Studio používá vlastnost překládaný text k označení, zda obsah vyžaduje překlad. Ve službě Phrase je tato vlastnost ignorována. Tyto Strings není třeba nahrát 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 `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 `ignorovat` atribut do výsledného XML. Při vypnutí (výchozí) je atribut `ignorovat` z exportovaných souborů vynechán. To pomáhá udržovat soubory se zdroji č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` speciální znaky Android pomocí předpony 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"/>
    <!-- Toto je krásný popis pro tento klíč! -->
    <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\">Hej, tento klíč je vnořen ještě hlouběji.</string>
    <string name=\"nested.key\">This key is nested inside a namespace.</string>
    <string name="null_translation"/>
    <plurals name="pluralized_key">
        <item quantity=\"one\">Nalezen pouze jeden tvar množného čísla.</item>
        <item quantity="other">Hej, máš %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 není ještě neověřeno a čeká na něj."},{"translation_9":"(V některých formátech také tento stav stáhnout)</string> (V některých formátech také tento stav stáhnout)</string>
</resources>

Množná čísla pro soubory Android XML

Pro hodnoty množného čísla přiřaďte 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>