Release 0.4.0: form_xml_to_html — HTML-прототипы управляемых форм 1С.

CLI -b/-o/-f/-p/-c; автор Michael BAG <mk@p7net.ru> (скрипт v0.1.0).

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
mihailkudravcev
2026-08-11 17:13:59 +03:00
parent a2c68fa5d5
commit 82e2d34c9e
7 changed files with 1114 additions and 2 deletions
+46 -1
View File
@@ -1,12 +1,14 @@
# export_1c_help
**Версия:** см. [`VERSION`](VERSION) (текущая: **0.3.12**) · [CHANGELOG](CHANGELOG.md)
**Версия:** см. [`VERSION`](VERSION) (текущая: **0.4.0**) · [CHANGELOG](CHANGELOG.md)
**Лицензия:** [MIT](LICENSE)
Выгрузка встроенной справки **любой** конфигурации 1С (`**/Ext/Help/ru.html`) в Markdown и публикация в wiki git-репозитория (Gitea / GitLab: `*.wiki.git`).
Дополнительно: публикация произвольных Markdown-статей в wiki через `export_docs.py` (спецификация: [`SPEC_EXPORT_DOCS.md`](SPEC_EXPORT_DOCS.md)).
Также: HTML-прототипы управляемых форм — `form_xml_to_html.py` (v0.1.0, Michael BAG <mk@p7net.ru>).
Зависимости: **Python 3.10+**, только стандартная библиотека.
---
@@ -223,6 +225,49 @@ python3 export_1c_help.py convert -c ../../crm3-26 -o ./out/wiki-md-crm3-26 --cl
---
## HTML-прототипы форм (`form_xml_to_html.py`)
Скрипт **v0.1.0**, автор **Michael BAG** <mk@p7net.ru>.
Собирает интерактивный HTML по `Ext/Form.xml` (вкладки, группы, поля, фильтр).
```bash
cd tools/export_1c_help
# объект конфигурации
python3 form_xml_to_html.py \
-b crm3-26 \
-o Справочник.Номенклатура \
-f ФормаЭлемента
# общая форма
python3 form_xml_to_html.py \
-b crm3-26.rhana \
-o Общие \
-f РК_ФормаНастроекРана
# параметры из JSON (форма всегда через -f)
python3 form_xml_to_html.py \
-c configs/form_prototype.crm3-26.json \
-f ФормаЭлемента
```
| Параметр | Описание |
|----------|----------|
| `-b` / `--base` | имя/путь каталога конфигурации (или её `src/`) |
| `-o` / `--object` | `Справочник.Номенклатура`, `Документ.X`, … или `Общие` |
| `-f` / `--form` | имя формы |
| `-p` / `--out-path` | корень вывода (по умолчанию `out/form-prototypes`) |
| `-c` / `--config` | JSON с `base`, `object`, `out_path`, `search_roots` (без формы) |
Путь к XML собирается автоматически. HTML:
`out/<конфа>/<тип>/<объект>/<форма>.html`
например `out/form-prototypes/crm3-26/Справочники/Номенклатура/ФормаЭлемента.html`.
---
## Репозиторий инструмента
- путь в монорепо: `tools/export_1c_help/`