hugo-book VS slate

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?

Slate (Free)

https://github.com/slatedocs/slate this ! Big company use it ( stripe etc )

The second most common question being "What framework does Stripe use to build their documentation?" and the answer has unfortunately always been "They use a custom setup they built themselves and isn't available." － so then Slate gets brought up as a suitable replacement

DocuAPI is a multilingual API documentation theme for Hugo created and maintained by Bjørn Erik Pedersen, the lead maintainer and co-creator of Hugo itself. It’s built on top of the Slate API docs generator, which itself was inspired by Stripe’s and PayPal’s API docs. The JavaScript section of DocuAPI has been rewritten from Jquery to AlpineJS.​​​​​​

I've used Slate to document APIs which similarly will produce a local website. You can host that privately or there's built in support to push to github pages if you're hosting it in a github repo. The documentation itself is all written in markdown and managed separate from your API code.

Clone/inspired by stripe docs: https://github.com/slatedocs/slate

If you are going to use Slate from the console you need to install it, along with all its prerequisites, as described here. In Ubuntu you can execute the commands:

Slate - API Generator