fix(mkdocs): rebase cross-kind wiki links under directory URLs
All checks were successful
continuous-integration/drone/tag Build is passing
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:
19
CHANGELOG.md
19
CHANGELOG.md
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user