doks VS mdBook

He just recommended that I use HUGO to set up a simple, static website for a non-profit that could be hosted for free on Github and would be fairly simple for me to update using markdown. It sounded like a wonderful idea. He downloaded HUGO & set up WSL for my Windows Terminal for me & I was pretty much on my own to find tutorials for Git & Github, VSCode, Hugo & the Hugo Doks Theme.

Recently I started to configure my digital garden. Foam is a good option, Hugo Doks, No Style Please, Git-Wiki, Researcher, Thinkspace, and other themes are good for zetteltasken pages.

Take a look at this theme for documentation. https://getdoks.org/

Thanks, yes of course — https://getdoks.org/.

Download Doks theme for Hugo

Download Doks Doks demo site Minimum Hugo version: 0.80 GitHub stars: 952 License: MIT

I am trying to create a second docs page, e.g. called `docs`, that should have the same layout as the `docs` page. I managed to do this by following [this](https://github.com/h-enk/doks/discussions/173) discussion topic. I managed to add the second page, all with correct menu entries and the sidebar showing correctly.

I'm responsible for a number of Java products. I try to provide high-quality Javadoc for all public library interfaces, library user's guides where appropriate, and development guides for applications. The latter two take the form of MDBook documents (https://rust-lang.github.io/mdBook/), with the document source living in the GitHub repo so that it's tied to the particular software release in a natural way.

My org has used mdBook: https://rust-lang.github.io/mdBook/ (That link is itself a rendered mdBook, so that'll give you an idea of the feature set.)

(While it's definitely a Rust "thing", if you just have a set of .md files, all you need is a "SUMMARY.md" (which contains the ToC) and a small config file; i.e., you don't have to have any Rust code to use it, and it works fine without. We document a large, mostly non-Rust codebase with it.)

If you want the lowest friction, open source, easily extensible Markdown to Web, Kindle, PDF, etc. tool, highly recommend mdBook: https://github.com/rust-lang/mdBook it’s written in Rust, but you don’t have to know any Rust to use it. And then wing is all CSS; for which there are many good (free) themes.