# Changelog

All notable changes to **export_1c_help** are documented in this file.

## [0.5.0] - 2026-08-14

### Added

- `form_wiki_export.py` — полный обход `**/Ext/Form.xml`, генерация HTML-прототипов
  и wiki-страниц с префиксом `form_` для просмотра в Gitea wiki (iframe + вложение).
- Отдельный manifest `manifest.export_forms.json` и маркеры `export_forms:*` в
  `Home.md` / `_Sidebar.md` — обновление без затрагивания страниц `export_docs` и справки.
- Конфиг: `configs/form_wiki.crm3-26.json`.
- Префикс имён страниц: `wiki_prefix` в JSON и `--wiki-prefix` в CLI
  (по умолчанию `form_`; в примере конфига — `forms_`).
- В именах `form_*` / `forms_*` — русские типы объектов (`Справочники`, `Общие_формы`),
  а не английские каталоги выгрузки (`Catalogs`, `CommonForms`).
- Ссылки в `form_INDEX` / страницах форм: кириллица без percent-encoding (`%D0%…`).

---

## [0.4.4] - 2026-08-12

### Changed

- `form_xml_to_html` **v0.2.3**: DataPath · тип — readonly поле (выделение) + кнопка ⎘
  для копирования в буфер обмена.

---

## [0.4.3] - 2026-08-12

### Fixed

- `form_xml_to_html` **v0.2.2**: очистка форматированных заголовков 1С
  (`<link>`, `<bgcolorstyle>`, `<img>`) — «Сегменты (Метизы)» вместо сырой разметки.

---

## [0.4.2] - 2026-08-12

### Changed

- `form_xml_to_html.py` **v0.2.1**: в `placeholder` полей — DataPath и тип данных
  (атрибуты формы + метаданные объекта/констант).

---

## [0.4.1] - 2026-08-12

### Added

- `form_xml_to_html.py` **v0.2.0**:
  - `-O/--out-file` — файл вывода, если не задан `-p`
  - `-T/--elements-tree` — текстовое дерево элементов
  - `-M/--text-maket` — ASCII-макет «как в окне»
  - `-t/--text-only` — выгрузка текста в `-O` без HTML
  - без `-O`: `-T`/`-M` идут в консоль; с `-O`: HTML (+ дерево/макет в страницу)

### Changed

- Убран неявный default `out/form-prototypes`: нужен `-p` или `-O` (либо только `-T`/`-M` в консоль).

---

## [0.4.0] - 2026-08-11

### Added

- `form_xml_to_html.py` (v0.1.0) — HTML-прототипы управляемых форм из `Form.xml`.
  Автор: Michael BAG <mk@p7net.ru>.
  - `-b/--base`, `-o/--object`, `-f/--form`, `-p/--out-path`, `-c/--config`
  - вывод: `<out>/<конфа>/<тип>/<объект>/<форма>.html`
  - примеры конфигов: `configs/form_prototype.crm3-26.json`,
    `configs/form_prototype.crm3-26.rhana.json`

---

## [0.3.12] - 2026-07-29

### Fixed

- `_Sidebar` folder tree: list subfolders under their real parent (DFS), not as a flat sort by depth (which made e.g. `transfer/mapping` appear under `ws`).

### Docs

- README: version **0.3.12**; `export_docs` section covers flat-root naming, folder indexes, Home/`_Sidebar` navigation, link rules, `clean`.
- `SPEC_EXPORT_DOCS.md` aligned with current CLI and behaviour (0.3.9–0.3.12).

## [0.3.11] - 2026-07-29

### Fixed

- Internal wiki links omit the `.md` suffix in Markdown targets (Gitea resolves `/wiki/page`, not `/wiki/page.md`).
- Folder `INDEX.md`: merge source body into auto-generated index; do not list INDEX as a self-link under «Статьи».
- Relative links to files in the git repo but outside the wiki export (e.g. `ws-rhana/...`) rewrite to Gitea `src/branch/...` URLs.

## [0.3.10] - 2026-07-29

### Fixed

- `export_docs` wiki push: clear Gitea `assume-unchanged` on `Home.md` / `_Sidebar.md` before `git add`, and commit only when the index has staged changes (fixes «no changes added to commit» when nav pages were modified).
- `_Sidebar` folder links: short folder name only (`📁 meta`), without «Папка» and without full `docs/...` path.

## [0.3.9] - 2026-07-29

### Added

- New CLI command `export_docs.py clean` to remove export_docs-managed wiki pages by `--folder` manifest and remove export_docs nav block from `Home`/`_Sidebar`.
- Auto-generated per-folder index pages with links to articles using full page titles.

### Changed

- `export_docs.py` defaults to flat root wiki page naming (`docs__path__name.md`) for Gitea compatibility where nested `/wiki/docs/...` routes return 404.
- Markdown links are URL-encoded in generated indexes and rewritten content to keep links with spaces/parentheses/Cyrillic valid.
- Wiki clone reuse now validates `origin` URL before fetch/reset; clone is recreated if target wiki differs.

## [0.3.8] - 2026-07-29

### Changed

- Wiki page filenames switched to short ASCII transliteration slugs (with stable hash suffix on truncation), while visible page titles remain full Russian.
- Internal links now use Markdown format with human-readable Russian labels and relative `.md` targets (no `wiki/` prefix), matching Gitea wiki routing.
- Generated article body now always starts with `# <Полное русское наименование>`.

## [0.3.7] - 2026-07-24

### Fixed

- Windows: `git commit` no longer fails with `ValueError: embedded null character` — commit message is written via `-F` and NULs are stripped from argv/version strings

## [0.3.6] - 2026-07-24

### Fixed

- Windows: percent-encoded Cyrillic wiki filenames no longer exceed MAX_PATH (~260) under deep roots (e.g. SynologyDrive); encoded slug capped, plus `\\?\` long-path writes

## [0.3.5] - 2026-07-24

### Fixed

- `push -o …/out` no longer deletes `wiki_clone-*` during convert `--clean`, and does not copy the clone into itself (was `FileNotFoundError` on push)

## [0.3.4] - 2026-07-24

### Added

- Page footer / Home / History include configuration **display name** (Synonym) and **vendor** (Vendor) from `Configuration.xml`

## [0.3.3] - 2026-07-23

### Fixed

- `push` no longer deletes user-written wiki pages; only manifest-managed help pages are updated/removed
- Full wipe available explicitly via `--wipe-unmanaged`

## [0.3.2] - 2026-07-23

### Fixed

- HTML→MD: bold inside links no longer produces `****`
- TOC `#anchor` links preserved (`[text](#id)` + `<a id>` before headings)
- Single-cell tip `<table><tt>…` converted to blockquote instead of broken `| …`
- Trailing spaces inside `<b>` moved outside bold (`**Товар** –`)

## [0.3.1] - 2026-07-23

### Fixed

- Replace Unicode minus (U+2212 `−`) with ASCII `-` in Home/History/CLI stats

## [0.3.0] - 2026-07-23

### Added

- Export help from **any** 1C configuration dump (`-c` / `--config` or `-s` / `--src`)
- Auto wiki URL from the configuration git repo: `repo.git` → `repo.wiki.git` (Gitea/GitLab)
- Explicit `--wiki-url` still supported (any target wiki)
- `info` subcommand: src, version, git remote, derived wiki URL
- Per-config default output dirs: `out/wiki-md-<slug>`, `out/wiki_clone-<slug>`
- README: connect any submodule / root project to its wiki and run export

## [0.2.0] - 2026-07-23

### Added

- Configuration version on each export (`VERSION` / `Configuration.xml`)
- Per-page lifecycle: `created_in` / `edited_in` / `deleted_in`
- `History.md`, `push` reads previous `manifest.json` from wiki
- CLI: `--prev-manifest`, `--config-version`

## [0.1.0] - 2026-07-23

Initial release: Help HTML → Markdown, Gitea wiki push, percent-encoded Cyrillic filenames.

[0.3.0]: https://git.p7net.ru/tools/export_1c_help/releases/tag/v0.3.0
[0.2.0]: https://git.p7net.ru/tools/export_1c_help/releases/tag/v0.2.0
[0.1.0]: https://git.p7net.ru/tools/export_1c_help/releases/tag/v0.1.0