.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, 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.) je lze specifikovat v parametrech dotazu `nahrát`, `Stáhnout` nebo v konfiguračním souboru `phrase.yml`.	convert_placeholder escape_linebreaks unescape_linebreaks enclose_in_cdata velikost_odstupu 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 vnořeny a ukládají řetězce čekající na překlad. Můžete použít Android Studio k vygenerování těchto souborů s prostředky 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 řetězec neměl být přeložen, definujte ho v samostatném souboru s prostředky se všemi 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 na formát. Příklad: `$s' => '$@`

Identifikátor	escape_linebreaks
Typ	Booleovský typ
Nahrát	Ne
Stáhnout	Ano
Výchozí	false
Popis	Všechny řádkové zlomy budou převedeny na `\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írá překlady obsahující HTML tagy do CDATA

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

Identifikátor	indent_style
Typ	řetěz\|ec
Nahrát	Ne
Stáhnout	Ano
Výchozí	Space
Popis	Specifikuje znak pro odsazení. Povolené hodnoty jsou `space` a `tab`.

Identifikátor	unescape_tags
Typ	boolean
Nahrání	Ano
Stažení	Ne
Výchozí	false
Popis	Všechny `<` znaky budou de-escapovány na `<` a všechny `>` znaky budou de-escapovány na `>` pro tagy.

Identifikátor	include_tools_locale_definition
Typ	boolean
Nahrát	Ne
Stáhnout	Ano
Výchozí	false
Popis	Zahrnout `tools:locale` atribut do výsledného XML.

Identifikátor	include_tools_ignore
Typ	boolean
Nahrát	Ne
Stáhnout	Ano
Výchozí	false
Popis	Zahrnout `tools:ignore` atribut do výsledného XML. Když je zakázáno (výchozí), atribut `tools:ignore` 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ání	Ano
Stažení	Ne
Výchozí	false
Popis	De-escapuje `\@`, `\?`, `\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">Podívejte se na to! This key has a description! (Alespoň v některých formátech)</string>
    <string name="key_with_line-break">Tento 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 takto:

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