fix(mkdocs): rebase cross-kind wiki links under directory URLs
All checks were successful
continuous-integration/drone/tag Build is passing

Wiki pages linking to a sibling kind (for example ../lib/...) were emitted verbatim by MkDocs and, with use_directory_urls, resolved into a non-existent <kind>/<kind>/ path. Add a docforge-linkfix plugin (doc-forge 0.0.8) that rebases those links to the repository root.
This commit is contained in:
2026-10-17 17:22:23 +05:30
parent c9e6945c26
commit 09118115a4
7 changed files with 167 additions and 3 deletions

View File

@@ -7,6 +7,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
## [Unreleased]
## [0.0.8] - 2026-10-17
### Added
- `docforge-linkfix` MkDocs plugin (registered via the `mkdocs.plugins`
entry point) that rebases cross-kind relative links — for example
`../lib/...` written in a wiki page — to the repository root so they resolve
to `/<repo>/<kind>/` under directory URLs.
### Changed
- The wiki template (`mkdocs.wiki.yml`) now enables `docforge-linkfix`;
regenerating a wiki config (or passing `--refresh`) propagates the fix.
### Fixed
- Cross-kind links (`../lib/`, `../api/`, `../wiki/`) in generated wikis no
longer resolve into a non-existent `<kind>/<kind>/` path.
## [0.0.7] - 2026-10-17
### Added
@@ -43,5 +59,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
- `import docforge` no longer requires the optional `mcp` dependency; the
MCP server imports `mcp` lazily, matching the MkDocs backend.
[Unreleased]: https://git.aetoskia.com/aetos/doc-forge/compare/0.0.7...HEAD
[Unreleased]: https://git.aetoskia.com/aetos/doc-forge/compare/0.0.8...HEAD
[0.0.8]: https://git.aetoskia.com/aetos/doc-forge/compare/0.0.7...0.0.8
[0.0.7]: https://git.aetoskia.com/aetos/doc-forge/compare/0.0.6...0.0.7