hugo-book VS mkdocs-material

The project is built using Hugo Book, which is an open source static site generator themed with a documentation theme that acts like a book.

I already have a site created with blogdown and want to make it live. To try it out, I build the site using blogdown::build_site() . After managing to upload all the content from the public folder on Github. I see that the formatting of my site does not match what I have on the localhost when I run blogdown::serve_site(). The site I created is slightly complex since there are many subfolders created under each topic. I used the Hugo Book theme from this github page.

So I cloned theme to the 'themes' folder. Removed all github related files. Added theme to config file. Hosts well locally with example content.

We generate a static website using Hugo and a documentation theme. [1] Non-technical members of our team can use Markdown easily and publish changes on their own schedule thanks to a very simple but sturdy CI/CD setup (GitHub Actions and NGINX).

Stripe's documentation is way over-engineered and wasteful IMO, and probably requires a massive to maintain.

[1] https://github.com/alex-shpak/hugo-book)

Download Book theme for Hugo

Download Book Book demo site ​​Minimum Hugo version: 0.43 Extended GitHub stars: 1.8k License: MIT

'hugo new site quickstart cd quickstart git init git submodule add https://github.com/alex-shpak/hugo-book themes/hugo-book hugo server --minify --theme hugo-book'

I am trying to create a tutorial site related to R programming however I can't figure out how to show the output of my code snippet. The theme's documentation does not say much about showing any output and I tried Googling the issue but I could not find anything. I am using the Hugo Book theme and the link can be found [here](https://github.com/alex-shpak/hugo-book). I am using the R blogdown package to create my site with Hugo. If there is any other information, please let me know. Thank you in advance.

fatal: unable to access 'https://github.com/alex-shpak/hugo-book/': error setting certificate verify locations: CAfile: 'C:\Users\...\ca-bundle.crt' CApath: none Is there some way to fix this?

Material Mk-Docs by Martin Donath works well if you prefer python.

https://squidfunk.github.io/mkdocs-material/

I'm an 'outsider', but from from the outside the Material For MkDocs Project looks like a very well managed open source project.

Martin Donath's project uses a 'sponsorware' release strategy to generate donations.

From my vantage point it seems to be working pretty well.

I just recently went through this decision process. My aim is to write code and math oriented posts so I need good support for nice syntax highlighting (at least colored) and mathjax (preferable) or katex. Substack is the most popular newsletter platform but fails at these two criteria. I love how math and syntax highlighting (plus numerous other features) work in MkDocs Material, which recently added a Blog plugin.

I wanted to combine the best of both: Substack as an amazing email social network, and MkDocs Material’s awesome look. So I’ve gone with using Substack as the core platform which I use to manage subscribers, and use it to post either math/code-free posts or a short teasers pointing to my main blog site on MkDocs Material when I need to show math/code

https://squidfunk.github.io/mkdocs-material/

I've been migrating content to MKDocs (Material) over the last few months, so feel fairly qualified on this subject. It's somewhat limited in terms of navigation, but can probably handle 400-500 pages; you can see how navigation works in the link. Otherwise, it can handle most, if not all, the tasks you've listed.