This is an example site that uses the Docsy Hugo theme. It's an alternative version of the "just the docs" site that uses a documentation page as its home page, which each section also being documentation, rather than starting from /docs/.
You can see a preview of this site at https://mostlydocs.netlify.app/
This version does not require a modified copy of the Docy theme's layouts, so is easier to keep in sync with the Docsy theme. It does this by making use of the target-specific front matter cascade feature that was introduced in Hugo 0.76.0 (with a bug fixed in 0.77.0 that's required for this to work).
It's currently based on a fork of Docsy with a small change.
If you take a look at content/en/_index.md, you'll see:
cascade:
- type: "blog"
# set to false to include a blog section in the section nav along with docs
toc_root: true
_target:
path: "/blog/**"
- type: "docs"
_target:
path: "/**"This makes every page in the site default to the docs type, except for /blog/* (you could leave this out, of course, or add other sections that you don't want to be treated as docs).
The toc_root setting causes the blog section to be removed from the main section menu in the left bar, and instead show up only when Blog is selected from the top menu, making it appear completely separate.
Otherwise it all works just like any other Docsy site.
To use this for yourself, make a copy of this template project and change content/en as needed (don't forget to run git submodule update --init --recursive to fetch the theme and its dependencies).