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

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

Правила синтаксического разбора файлов *.ini для проекта локализации приложений
  1. Исходные файлы
Назначение файлов: .ini файл - это файл конфигурации, который содержит данные настроек для некоторых приложений.

Пример исходного .ini файла:
;  Project

COM_INSTALLER="Менеджер установки"
COM_INSTALLER_DATABASE_VIEW_DEFAULT_TITLE="Проверка базы данных"
COM_INSTALLER_DISCOVER_VIEW_DEFAULT_TITLE="Поиск расширений"
COM_INSTALLER_INSTALL_VIEW_DEFAULT_TITLE="Установка расширений"
COM_INSTALLER_LANGUAGES_VIEW_DEFAULT_TITLE="Установить язык"
COM_INSTALLER_MANAGE_VIEW_DEFAULT_TITLE="Управление расширениями"
COM_INSTALLER_UPDATESITES_VIEW_DEFAULT_TITLE="Серверы обновлений"
COM_INSTALLER_UPDATE_VIEW_DEFAULT_TITLE="Обновление расширений"
COM_INSTALLER_WARNINGS_VIEW_DEFAULT_TITLE="Предупреждения"
  1. Анализ
Хотя INI файлы и приобрели популярность в Windows, они могут использоваться в любой ОС. Несложная структура этого формата позволяет легко обрабатывать их программно и имеет достаточно понятный вид для чтения и изменения человеком. Существуют текстовые редакторы, которые используют подсветку синтаксиса и фолдинг для этого формата, что облегчает редактирование INI файлов вручную.

Подробной официальной спецификации формата не существует.

INI файл может содержать:

  • пустые строки;

  • комментарии — от символа «;» (точка с запятой) до конца строки;

  • заголовки разделов — строки, состоящие из названия раздела, заключённого в квадратные скобки «[ ]»;

  • значения параметров — строки вида «ключ=значение».

Дополнительные соглашения:

  • комментарии – некоторые приложения (например, Samba) считают символом начала комментария как «;», так и «#».

  • обратный слэш – иногда допускается использование обратного слэша «\» для объявления следующей строки продолжением этой. В таком случае они будут обработаны как одна целая строка. Иногда возможно также применять «\» для ввода спецсимволов, например, '\n' для обозначения переноса строки.

  • одинаковые параметры – в большинстве случаев наличие двух одинаковых ключей в одной секции запрещено (при этом обрабатывается только последний ключ).

  • одинаковые имена секций – обычно при наличии нескольких секций с одинаковыми именами в файле обрабатывается лишь последняя из них. Некоторые приложения объединяют содержимое всех таких секций в одну.

Такие строки как комментарии игнорируются целевой программой - как и пустые строки. Обычно комментарии переводу не подлежат и игнорируются в рамках процедуры перевода.


Основные ключи с текстом рассмотрим на примерах ниже:
; Note : All ini files need to be saved as UTF-8

COM_INSTALLER="Менеджер установки"
Описание ключей:
  1. имя_ключа
a. Назначение: контекст.
b. Пример: COM_INSTALLER.
c.Пояснение: левая часть строки/пары ключ-значение.


2.исходное_значение | переведенное_значение

a. Назначение: исходная строка | строка перевода.
b. Пример: Менеджер установки.
c. Пояснение: правая часть строки/пары ключ-значение.

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