Docsy 0.10.0 release report
The big news with Docsy 0.10.0 is color themes and dark mode!
Hugo: breaking changes and deprecation notices
In this release, Docsy’s Hugo dependency is upgraded to 0.125.4 from 0.122.0. An important thing to note here is that Hugo 0.123.0 was a significant upgrade that included some breaking changes. Before upgrading to this Docsy version, review Hugo’s deprecation notices and breaking changes since 0.122.0.
Hugo version support reminder
Each Docsy version officially only supports the Hugo version specified in the project’s package.json entry for hugo-extended. Any other compatibility is on a best effort basis.A number of updates to this release were to address Hugo’s deprecation notices. For the complete list, search for 0.10.0 release changes with “deprecat” in the title.
Color themes and dark-mode support
The main feature of this release is the Upgrade to Bootstrap 5.3 (#1528) from 5.2. This minor Bootstrap release introduces support color modes, also called color themes.
As a validation of this upgrade, Docsy has been enhanced to support dark mode, the most upvoted Docsy enhancement request (#331) prior to this release.
To learn how to enable a light/dark mode dropdown menu for your project, see Light/dark mode menu. We have enabled this menu for the Docsy User Guide, so if you’re reading this post online, give dark mode a try!
Important style changes
The styling of the following shortcodes and page elements have been adjusted to ensure that they are compatible with light and dark modes.
You’ll needs to revisit your styles if you customized the SCSS associated with these shortcodes and elements.
The search box styling as well as the doc-page left-nav have had their styles adjusted as well.
Release details
For the complete list of changes in this release, see the 0.10.0 release entry and issue Release 0.10.0 preparation (#1759).
What’s next?
Which Docsy improvements are on the horizon? For work items tentatively planed for the next release, see Release 0.11.0 preparation (#1944).