---
title: "Правило именования и расположения ini-файлов"
type: guide
api: [api7]
tags: [guide, api7, name]
sources:
  - name_for_ini.html
---

*Инструкция по созданию справки HTML для приложений > Локальная справка для приложений*


## Правило именования и расположения ini-файлов

В %ProgramData%\ASCON\HelpServer должен быть помещен ini-файл приложения. Имя файла может быть задано в одном из следующих форматов:
•<App ID>_<major версия>_<локаль>.ini
•<helpId>_<major версия>_<локаль>.ini
Пример:
```vb
APP_Gayka1_v23_ru-Ru.ini или Gayka1_v23_ru-Ru.ini
Ini-файл должен быть в кодировке UTF-8 and UTF-16LE with BOM encoded configuration files are supported.
Структура ini-файла
Help]
формируемый путь для строки браузера:
path=/<App ID>/<major версия>/<локаль>/
или
path=/<HelpId>/<major версия>/<локаль>/
путь к справке:
root=J:\Test Lib\Help\Gayka1_ru-Ru.zip
Пример содержания ini-файла
[Help]
path=/Gayka1/22/ru-RU/
root=J:\Test Lib\Help\Gayka1_ru-Ru.zip
Если в системе установлено несколько локализаций, то рекомендуется создавать разные ini-файлы на каждый язык.
Например:
Gayka1_v22_ru-RU.ini
Gayka1_v22_en-US.ini
```


## Правило именования и расположения файлов справки

| | Zip-архив со справкой приложения и БД соответствия идентификаторов и страниц html рекомендуется располагать в каталоге приложения в папке Help. |
| --- | --- |
Поиск справки выполняется по следующему правилу:
<helpId>_<локаль>.zip
Если ключ helpid не задан в манифесте приложения, то поиск справки выполняется по правилу:
<application ID>_<локаль>.zip
