This change updates the configuration and version of the docs theme to the latest version of Platen and opts-into the new display modes.
This update includes a fix to a build error caused by the Platen reimplementing the TOC building logic and ensures that the docs site builds correctly without errors or warnings.
The new opt-in features gets the docs site ahead of the eventual deprecation and removal of legacy functionality and keeps the build logs clean. It also ensures:
The site can more effectively use icons.
The TOC nodes with nested items can be collapsed.
The mobile buttons are more usable and accessible.
The site-level icons are configurable and can be kept cohesive.
Finally, the change moves the remaining Platen configuration out of the hugo.yaml file, colocating it with the rest of the Platen-specific configuration in docs/data/_params/platen.yaml.
Summary
This change updates the configuration and version of the docs theme to the latest version of Platen and opts-into the new display modes.
This update includes a fix to a build error caused by the Platen reimplementing the TOC building logic and ensures that the docs site builds correctly without errors or warnings.
The new opt-in features gets the docs site ahead of the eventual deprecation and removal of legacy functionality and keeps the build logs clean. It also ensures:
Finally, the change moves the remaining Platen configuration out of the
hugo.yaml
file, colocating it with the rest of the Platen-specific configuration indocs/data/_params/platen.yaml
.How did you test this change?
Local testing of the docs site with
hugo serve
.Images/Videos
N/A