Static site generator

The best one is OurBigBook CLI of course! :-)

Table of contents
- List of static site generators Static site generator

List of static site generators

 0  0 

Bookdown

 0  0 

github.com/rstudio/bookdown

Written in R, but also relies on pandoc, so quite bad dependency wise.

Cross files references to IDs: yes. But no check by default for duplicates when doing automatic ID from title. Just automatically disambiguates with -1, -2 suffixes, and links take the last one available.

Source page splitting: splits at h2 by default. If configurable, likely always af fixed level?

Has some nice image generation from inline code from standard R plotting functions.

Hello world documented at: bookdown.org/yihui/bookdown/get-started.html

Hello world on Ubuntu 23.04 after installing R:

sudo R -e 'install.packages("bookdown")'
git clone https://github.com/rstudio/bookdown-demo
cd bookdown-demo
Rscript -e 'bookdown::render_book("index.Rmd")'
xdg-open _book/index.html

The build CLI comes from: stackoverflow.com/questions/50888871/how-to-use-rscript-command-line-tool-to-build-a-book-in-bookdown

The installatoin Rscript -e 'bookdown::render_book("index.Rmd")' takes several minutes, it compiles a bunch of stuff from source apparently. but it did work.