mihailkudravcevexport_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