GitHub Pages workshop

A workshop made up 30 in advance at CodeAcross NYC. The target audience is civic hackers wanting to publish their data/information on the web, using GitHub + GitHub Pages as the means.

Opening questions

• Who has experience with HTML?
• Who could point out JSON if they saw it? CSV?
• Who has put something on GitHub?
• Who has experience with Git?

GitHub Pages overview

• https://pages.github.com
• See articles mentioning "Pages" at https://help.github.com

Creation

There are a bunch of ways to get a Pages site created (and to modify it afterwards):

One-click creation

• Create through settings page

The repository pages

1. Create repo
2. Create gh-pages branch
3. Add index.html

The desktop app

• https://mac.github.com/
• https://windows.github.com/

The command-line

Publishing data

• CSV
  • https://github.com/blog/1601-see-your-csvs
  • https://help.github.com/articles/rendering-csv-and-tsv-data/
• GeoJSON/TopoJSON
  • https://github.com/blog/1528-there-s-a-map-for-that
  • https://github.com/blog/1541-geojson-rendering-improvements
  • https://help.github.com/articles/mapping-geojson-files-on-github/
• JSON

Pairing with project code

• Using an --orphan branch

Examples

Please add more!

• http://api.afeld.me
• https://18f.gsa.gov/hub
• https://github.com/18F/hourofcode