export_1c_help

Версия: см. VERSION (текущая: 0.1.0) · CHANGELOG
Лицензия: MIT

Выгрузка встроенной справки конфигурации 1С (**/Ext/Help/ru.html) в Markdown и публикация в Gitea Wiki.

Зависимости: Python 3.10+, только стандартная библиотека.

---

Быстрый старт

cd tools/export_1c_help

# конвертация в каталог
python3 export_1c_help.py convert \
  -s ../../crm3-26/src \
  -o ./out/wiki-md \
  --clean

# конвертация + push в wiki-репозиторий Gitea
python3 export_1c_help.py push \
  -s ../../crm3-26/src \
  --wiki-url https://git.p7net.ru/1c/crm3_26.wiki.git \
  -o ./out/wiki-md

Проверка версии:

python3 export_1c_help.py --version

---

Команды

convert

Читает src/, пишет Markdown-дерево wiki:

Файл	Назначение
Home.md	оглавление по типам метаданных
_Sidebar.md	боковая навигация (объекты без форм)
«Заголовок».md / %D0%….md	страницы справки (кириллица в git — percent-encoded, как хранит Gitea)
manifest.json	карта meta_key → title / filename

Параметр	Описание
-s / --src	каталог src выгрузки конфигурации
-o / --out	каталог результата
--objects-only	без справки форм (Forms/*/Ext/Help)
--keep-empty	не пропускать почти пустые страницы
--clean	очистить --out перед записью (кроме .git)

push

Выполняет convert, затем git clone / обновление wiki-репозитория (обычно *.wiki.git), коммит и git push.

Параметр	Описание
--wiki-url	URL wiki git, напр. https://git.p7net.ru/1c/crm3_26.wiki.git
--work-dir	локальный clone wiki
--dry-run	только convert
--keep-unmanaged	не удалять чужие .md в wiki
-m / --message	сообщение коммита

Для push нужны права записи в wiki (HTTPS + credential helper / token).

---

Как устроены ссылки

В HTML справки 1С:

Catalog.ВидыНоменклатуры/Help
Document.ЗаказКлиента.Form.ФормаДокумента/Help

В wiki:

[[Виды номенклатуры]]
[[текст|Виды номенклатуры]]

Ключ метаданных (Catalog.ВидыНоменклатуры) стабилен и пишется в подвал страницы и в manifest.json.

---

Репозиторий

Отдельный git-репозиторий (подмодуль монорепозитория миграции):

• путь в дереве проекта: tools/export_1c_help/
• remote (ожидаемый): https://git.p7net.ru/tools/export_1c_help.git