Useful links: Docsy releases & tags. Jump to the latest release.
For a list of issues targeted for the next release, see the 22Q2 milestone.
For a full list of the changes to this release, see the release notes.
Breaking changes:
-
Docsy no longer uses git submodules for Bootstrap and FontAwesome. If your project uses Hugo Modules, then this change doesn't impact you.
For projects with other Docsy setups, use the NPM packages of Bootstrap and FontAwesome. Migrate your site by following these steps (execute commands from your project's root directory):
- Update Docsy to 0.4.0.
- Delete obsolete Docsy Git submodules:
$ rm -Rf themes/docsy/assets/vendor
- Get Docsy dependencies:
$ (cd themes/docsy && npm install)
- (Optional) If your site project uses NPM, consider getting Docsy
dependencies via a
prepare
script, for example:{ "name": "my-website", "scripts": { "get:submodule": "git submodule update --init --depth 1", "_prepare:docsy": "cd themes/docsy && npm install", "prepare": "npm run get:submodule && npm run _prepare:docsy", "...": "..." }, "...": "..." }
- Proceed as usual to build or serve your site.
For a full list of the changes to this release, see the release notes.
Breaking changes:
- Upgrade to Algolia DocSearch v3. If your site uses the deprecated DocSearch v2, you must update your DocSearch code.
New:
-
Add official Docsy support for Hugo modules. Many thanks to the dedicated and patient efforts of @deining, who researched, experimented, and implemented this feature. Thanks to @deining and @LisaFC for the doc updates.
For details, see Migrate to Hugo Modules.
Details:
- For a full list of the changes to this release, see the release notes
0.X.Y - next planned release (unpublished yet)
For a full list of the changes to this release, see the release notes.
Breaking changes:
- ...