Справочный центр

Правила разбора файлов
*.xml

Правила синтаксического разбора файлов *.xml для проекта локализации приложений
Исходные файлы

Назначение файлов:
В общем случае .xml файл — это текстовый файл в формате XML (от англ. eXtensible Markup Language — расширяемый язык разметки), который описывает структуру документа, данные в этом документе и частично описывает поведение программ, читающих XML-документы.
Android xml - формат локализации для веб-приложений и приложений для телефонов, Android Studio, сервисов Google Play.

Пример исходного .xml файла:
<?xml version="1.0" encoding="utf-8"?>
<resources>
    <!--Короткое имя приложения-->
    <string name="app_name">Mix</string>
    <string name="ChatWithManager">Chat with your manager</string>
    <string name="selectTypeTicket">Topic of appeal</string>
    <string-array name="months_short">
        <item>Jan</item>
        <item>Feb</item>
        <item>Mar</item>
        <item>Apr</item>
        <item>May</item>
        <item>Jun</item>
        <item>Jul</item>
        <item>Aug</item>
        <item>Sep</item>
        <item>Oct</item>
        <item>Nov</item>
        <item>Dec</item>
    </string-array>
</resources>
  1. Анализ
Формат языка разрабатывался с расчетом его широкого применения в Интернете. Первоначально он планировался как замена языка разметки HTML, но в результате получил более широкое распространение. Язык называется расширяемым из-за возможности свободного расширения разметки, применяя ее к непосредственным задачам и потребностям использования. В настоящее время XML широко распространен в Интернете, применяется в документообороте, на его основе создано множество дополнительных форматов.

Документ начинается с указания версии синтаксиса и кодировки файла:
<?xml version="1.0" encoding="utf-8"?>
Разметка всегда начинается символом < и заканчивается символом >. Наряду с символами < и >, специальную роль для разметки играет также символ &. Угловые скобки обозначают границы элементов (тегов), инструкций обработки и некоторых других последовательностей. Значение элемента помещается между одноименными тегами (имя закрывающего тега совпадает с именем открывающего, но предваряется символом «/»).

В элементе атрибуты могут использоваться только в начальном теге и теге пустого элемента. Атрибуты заключены в символы «"».

Комментарии не относятся к символьным данным документа. Комментарий начинается последовательностью «<!--» и заканчивается последовательностью «-->», внутри не может встречаться комбинация символов «--».

Также может содержать дополнительную секцию описания типов используемых данных (DTD-описание), которое начинается с ключа [CDATA].

Основные ключи с текстом рассмотрим на примере ниже:
<?xml version="1.0" encoding="utf-8"?>
<resources>
    <!--Короткое имя приложения-->
    <string name="app_name">Mix</string>
    <string name="ChatWithManager">Chat with your manager</string>
    <string name="selectTypeTicket">Topic of appeal</string>
    <string-array name="months_short">
        <item>Jan</item>
        <item>Feb</item>
        <item>Mar</item>
        <item>Apr</item>
        <item>May</item>
        <item>Jun</item>
        <item>Jul</item>
        <item>Aug</item>
        <item>Sep</item>
        <item>Oct</item>
        <item>Nov</item>
        <item>Dec</item>
    </string-array>
</resources>
Описание ключей:

1. Атрибут name

a. Назначение: контекст.
b. Пример: ChatWithManager.
c. Пояснение: уникальный идентификатор.

2. Значение элемента string и/или элемента item внутри элемента string-array

a. Назначение: исходная строка | строка перевода
b. Пример: Chat with your manager.
c. Пояснение: строка с текстом.

Процесс перевода:
1. Чтобы получить локализованное приложение, необходимо перевести .xml файлы на нужные языки.
2. Мы предлагаем воспользоваться для перевода нашим онлайн-сервисом alingvo. Сервис:
  • загружает исходные файлы
  • преобразует их в строки для перевода
  • предоставляет удобный для переводчика интерфейс
  • формирует целевые файлы локализации