This is the source code for gilmoreorless.github.io — a showcase of my open source projects on GitHub (well, the ones worth sharing, at least).

This repository also contains common styles and scripts required for the documentation of other repositories. This means I can have individual documentation specific to each project (e.g. jQuery nearest), but only need to update one file here to change the styling across all of them.

There are two main sections in the file structure. I am not expecting anyone else to care about this. What I am doing is documenting this for myself, so that I don’t come back to this in 6 months and wonder what goes where.

This is where shared documentation themes live. Only remove a theme if you’re absolutely, positively certain that nothing is using it.

• theme-v1/ — white background, black/green terminal-style code snippets.
• theme-v2/ — teal background, Raleway font, properly-aligned typography.

This contains all the files needed for the home page at gilmoreorless.github.io.

• img/ — project thumbnails.
• lib/ — auto-generated files, do not edit these manually.
• src/ — main source files, these are the ones to edit.

Gulp is required for building the site files. The following tasks are available:

Takes the project definitions from gilhub/src/projects.json, feeds them into gilhub/src/index.html using Moustache, and generates the root index.html.

Runs gilhub/src/home.css through Autoprefixer and fixes gradients, then saves it as gilhub/lib/home.css.

Takes any required dependencies (at the moment, that’s just fontfaceobserver), adds JS files from gilhub/src/, and concatenatess them together as gilhub/lib/home.js.

Runs the html, css and scripts tasks. This should always be run just before committing and pushing live.