mihailkudravcev
a2c68fa5d5
Document flat-root pages, indexes, sidebar DFS tree, and link rewriting. Co-authored-by: Cursor <cursoragent@cursor.com>
125 lines
4.9 KiB
Markdown
125 lines
4.9 KiB
Markdown
# Changelog
|
||
|
||
All notable changes to **export_1c_help** are documented in this file.
|
||
|
||
## [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
|