search

University-of-Manitoba-Computer-Science / tools-n-techniques

An introductory lab course for Computer Science.
http://toolsntechniques.ca/
Creative Commons Attribution Share Alike 4.0 International
3 stars 2 forks source link

Provide a single-file download for the book. #15

Open fbristow opened 2 months ago

fbristow commented 2 months ago

The web version is great, but it's also reasonable to want to have an offline copy of the book.

This can minimally be done by running

pandoc **/*.md -o --toc toolsntechniques.docx

(which I am extremely delighted by, :heart: Pandoc!), but that doesn't give me nice looking chapters because it's not using the metadata that I've hacked in with Rippledoc and the directory-based metadata.yml.

I think there are two approaches we could do for this (maybe both):

  1. Modify Rippledoc to generate PDFs (or docx) for every page, and add a link to the PDF or docx version of the page next to the link that gives direct access to the Markdown version of the page,
  2. Update the GitHub repository to use releases and build a single giant PDF/docx file any time the text changes.