← notes

Forking a Jekyll theme you intend to keep editing

Jan 23, 2021

A site for the Congo Developers Club, an online place where developers across Congo and central Africa exchange ideas and opportunities.

The site is a modified Fuse Core Jekyll theme by Thomas Jensen with visual elements from front-cover, both credited in the README. The technical note is about theme forking, because it is the common case and the documentation always assumes the other one.

Jekyll supports themes as gem dependencies, where you override individual layouts and get upstream fixes on a version bump. What actually happens is you copy the theme into the repo and start editing, and from that moment upstream fixes stop arriving and there is no record of which files you changed. That matters when you later want a fix that landed upstream, because the only way to know whether a file is yours or theirs is to diff against a tarball of whatever version you started from.

Licensing is the other half, and this repo mixes CC-BY-4.0 content with an MIT-licensed theme, both of which have to stay attributable.

The Slack and Telegram links are the actual product; the site exists to be found. An earlier PHP version preceded it.