Build Improvements + Bug Fixes
✨ This release improves navigation portability, improves offline build mode, and makes preview and production deployments behave more consistently.
Highlights
This release improves navigation portability across preview and production environments, introduces a dedicated offline build mode, and fixes several routing inconsistencies in SPA navigation.
No breaking changes. No new configuration required. Existing projects continue to work unchanged.
Navigation
Navigation is now fully page-relative where appropriate, making version, language, and project switching work consistently across local previews, GitHub Pages, and root deployments.
A routing issue affecting local development with custom deployment bases has also been resolved, so switchers now correctly detect the current environment without requiring configuration changes.
SPA Improvements
The menubar, announcement banner, and cookie banner are now updated during client-side navigation, ensuring links remain correct regardless of page depth.
Offline Builds
A new --offline mode is available for documentation intended to be viewed directly over file://.
Offline builds:
- Skip keyword and semantic search indexing.
- Generate links compatible with offline navigation.
- Display a localized message explaining that search is unavailable.
Maintenance
- Reduced dependency footprint by removing deprecated packages.
- Improved optional dependency handling for plugins.
- General maintenance and internal cleanup.
Fixes for #175, #177, #179, #184
Thanks 💖
Thanks to all contributors and community members who reported issues and provided feedback.
Documentation: https://docs.docmd.io/
GitHub: https://github.com/docmd-io/docmd
Semantic Search: https://github.com/docmd-io/docmd-search
Skills: https://github.com/docmd-io/docmd-skills
Full Changelog: 0.8.16...0.8.17