A theme for Blogdown with Hugo, based on the excellent Hugo Book theme from Alex Shpak.
Note: This has now been abandoned in favour of a bookdown-based approach, which offers more flexibility and fewer dependencies than blogdown. It is left here because it works, and as a reminder that I should read more before I start building. I will probably forget.
For the basic theme:
- Hugo
For R code and glossary:
- R
- R Studio
Not required, but recommended. - The following packages:
- Blogdown
For pdf output:
- Node JS
- Puppeteer
- Clone this repo to desired directory
- Download R studio and install blogdown (see the blogdown guide)
- Navigate to
titfl/pdfgen
and runnpm i puppeteer
to install puppeteer and chromium
Edit the site from the contents
directory. Note this is not content
; in order to prevent the Rmarkdown files being overwritten by Hugo (and an ugly file structure from duplicates) the content
directory required by Hugo is rebuilt by R each time the site is generated.
Soon:
- Finish PDF output
- CSS tweaks
- PDF generation
- Nicer 404 page
- Newthought CSS
- Stickysmooth active nav
- Change SVGs to fa-font variants
Someday:
- Search summaries