Skip to content

docmd@0.8.15 🔍 (Keyword Search + Summer Nav Fix)

Choose a tag to compare

View all tags
@mgks mgks released this 15 Jul 20:27
0.8.15
f3904ab

docmd logo

Keyword Search + Summer Nav Fix

✨ A reliability-focused release with robust GitHub Pages deployments, bundled keyword search, consistent navigation, and a smoother auto-install experience.

Highlights

This release fixes the long-running GitHub Pages subpath asset issue, unifies navigation behaviour across all project types, bundles MiniSearch locally so keyword search no longer depends on a CDN, and cleans up duplicate auto-install output.

No breaking changes. No new configuration required. Existing projects, plugins, and CI pipelines continue to work unchanged.

GitHub Pages Subpath Fixes

GitHub Pages deployments now resolve assets correctly on every page, including nested routes.

Previous releases combined a <base> tag with depth-relative asset paths, which caused CSS, JavaScript, and other assets to 404 when deployed under repository subpaths such as https://user.github.io/repo/guide/. Fixes #175.

The generator now emits root-relative URLs for online builds and no longer relies on <base> tags. Offline builds continue using their existing document-relative paths, ensuring both deployment modes behave correctly.

No configuration changes are required, whether base is configured explicitly, derived from url, or omitted entirely, assets now resolve correctly by default.

Consistent Navigation Paths

Navigation links are now generated consistently across all project types.

Projects using a local navigation.json previously omitted trailing slashes in sidebar and previous/next links, while markdown links continued using normalised URLs. Navigation is now normalised during loading so every navigation surface follows the same URL convention.

MiniSearch is Now Bundled

Keyword search no longer depends on a CDN.

MiniSearch is now bundled directly into the generated site alongside the rest of docmd's runtime assets, allowing keyword search to work in environments without internet access, behind corporate firewalls, and during sandboxed browser testing.

The CDN is retained only as a fallback if the local bundle cannot be resolved.

Cleaner Auto-Install Experience

Auto-install output is now significantly less noisy.

  • Worker threads no longer attempt dependency installation, preventing duplicate messages during builds.
  • Running docmd outside an initialised project now produces a single, actionable hint instead of repeated package manager errors.

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 (docmd-search): https://github.com/docmd-io/docmd-search
Skills: https://github.com/docmd-io/docmd-skills

Full changelog: 0.8.14...0.8.15

Assets 2
Loading