rocktronica / shopdocs

(work)shop doc(ument)s

(work)shop doc(ument)s

A couple times a year or as demand warrants it, I teach a workshop on electronics and DIY synthesizers. This repo is the source to the documents I write to share with my section.

A "live" version is available online with nice PDF downloads: https://rocktronica.github.io/shopdocs/

(Importantly, this is the source code for resources I made for my section only, not the other instructors' stuff nor the real core material. Any opinions or errors they have are all mine. Obviously, it is no replacement for taking the actual workshop!)

Blog post: https://blog.tommy.sh/posts/shopdocs/

Notes:

• It's mostly supplemental stuff that got cut for time but still useful/cool enough to warrant sharing.
• There is no prescribed reading order. They're kind of grab-bag "jelly bean" docs to share as topics come up.
• Despite being a real live website, format is optimized for PDF and print, so as to be put on the class Google Drive.
• I expect the content to change over time, so everything's dated by last update in the footer. Depending on when that was, what's online may be different from the PDFs I share in class.
• Schematics were done in Kicad, drawings on an iPad.
• Some stuff might not make sense outside of the context of me talking about it! (Other stuff might not make sense because I wrote it very tiredly in the middle of the night without spellcheck before class in the morning.) Typos,

Generating PDFs

Document files are written in markdown, made into a website with eleventy, and then converted to PDF with Chrome via puppeteer.

npm install

# Terminal 1
npx @11ty/eleventy --serve

# Terminal 2
node make_pdfs.js
node make_pdfs.js SLUG # for single PDF

Works For Me!

TODO

• Per page footers w/ page numbers
• Smarter make_pdfs.js URL confirmation

License

Text and drawing content is all CC BY-SA 4.0. Please retain my attribution if sharing, TYSM.

Code is MIT or as components allow.