[Logo for The C Shore Landing Page]
The C Shore

README for Bots & Bytes Fall 2019

Table of Contents

Version 1.0

Teaching the Raspberry Pi in Six Modules

A Volunteer Project for the MakerPlace @ the Midland Public Library

Visit the Bots & Bytes GitHub Pages

Or use this tinyurl https://tinyurl.com/yyaxnwjg

Also mirrored (with a different skin) @ https://www.thecshore.com/projects/bots-and-bytes-fall-2019/.

Also available as the Bots & Bytes Fall 2019 PDF

Build and/or view the pages on your local computer

First time preparation

  1. Install Ruby 2.5 with development tools
  2. Configure Ruby to use packages (gems) from your home directory
    1. In your home directory edit the file .gemrc so it contains
      • Linux: "gem": --install-dir ~/.gem/ruby/2.5.0
      • Windows "gem": --install-dir %USERPROFILE%\.gem\ruby\2.5.0
  3. gem install bundle bundler
  4. Configure Bundle to use packages (gems) from your home directory
    • Linux: bundle config --global path ~/.gem
    • Windows bundle config --global path %USERPROFILE%\.gem
  5. In this (bots & bytes) directory: bundle install

To serve the pages locally

To create PDFs from the Markdown (.md) and HTML (.html) Files

  1. Install Python 3 and make sure your per-user Python ‘Scripts’ directory is in your PATH.
  2. Install python-weasyprint and html5lib using pip (python3 version) and make sure they are in your PATH
    1. e.g. python3 -m pip install --user python-weasyprint html5lib
  3. On Windows install GTK+ for Windows (latest version)
  4. Install pandoc and make sure it is in your path
  5. Execute python3 bb-pdf-gen.py.

Licensing Note

Unless otherwise specified, everything in this repository is covered by the Creative Commons 4.0 Attribution Share-Alike License because the projects from which we borrow text and images are licensed under these terms.

Creative Commons License

The License Image (above) is Copyright Creative Commons and Licensed under the Creative Commons Share-Alike 4.0 International License


  • If you don’t have online edit access, please open an issue requesting commit access.

  • If you need a WYSIWG editor for Markdown Mark Text is pretty convenient if a little quirky, and is available for all major platforms

  • Atom is a general purpose editor with packages that provide excellent support for Markdown (not WYSIWG but does have a preview that updates as you edit), along with built-in support for GitHub.


This series was aimed at a 9 to 11 year old audience in Ontario, Canada (originally a somewhat older audience was expected, and this was our first time doing workshops for kids, so you’ll notice a shift in the presentation towards accommodating the younger members of the group), and their parents. Some references may not apply elsewhere (the US-style keyboard in the copy-paste handout, for instance, would have be updated if the series were to be used in a region with a different standard keyboard).