Online book version of the content

[thunderbiscuit]

Hi there, and thank you for the amazing resource! I've been recommending it to people for a while, and it's only getting better.

I'm wondering if it was ever considered to publish the book as a website for easier consumption? There are a lot of tools that take markdown content and just build websites with them in book-ish formats.

In order to build an example I took a few minutes to port over the first 5 chapters into an mdbook (a Rust book builder tool) and it's hosted here. MDBooks are very easy to build (add markdown files as-is and provide a sidebar file called SUMMARY.md), but are not super flexible on the UI. They do have search out-of-the-box however, which turns out to be a fantastic feature when you have the size of content this book has.

There are tons of other great options if you want to put more effort into it and get more polished results. Here are a few I have used and can vouch for:

• Hugo site with hugo-book theme
• just-the-docs with example here (Devkit Wallet) and here (Raspibolt docs)
• Vuepress

If that's ever of interest to this project, I'd be happy to help out on this effort, or simply advise on the different tools.

[shannona]

@ChristopherA any interest in this, or do you prefer to keep things focused on GitHub?

[ChristopherA]

Right now it would not be too difficult to make a book with markdown.

However, longer term I’d like see the course include more interactive features: videos, cli screencasts, self-tests, etc.

Maybe I’d we do this, a book version is as a branch, with some automation to exclude future features that are interactive.

[SerafDosSantos]

@ChristopherA @shannona Actually it is quite easy to convert *.md files into *.asciidoc files, better suited for book editing and publication. It took me a few minutes to obtain a nice HTML version of this project for my own needs to translate it to French (although I ain't ready to do so).