My personal blog.
This repository contains the scripts to build my static blog, together with the articles Markdown source.
Everything is built around a makefile. Markdown parsing is done with the markdown-it library, Jade is used for pages templating, Stylus for CSS preprocessing, and the awesome Babel to transpile ES6 to ES5.
Everything in this repository is in the public domain, thanks to the
Unlicense, but if you want to hack on this
project, you probably want to remove the content and keep only the
engine; just remove everything in the
public directory except the
*.list files (used for index, posts list and RSS feed).
I may separate the engine from the content if there is some need to reuse the engine elsewhere, to make it more maintainable.
You need a Node.js compliant environment, and GNU
make to build.
npm install make
Only the stuff that changed since last compilation will be updated.
Create a new post
This will drop you in your editor, in a new prepared draft, with a title and the current date. When exiting, the post will be moved to a dated directory, with a slug derived from the page title.
Make sure to update the site after!
Create a new page
Just create a Markdown file anywhere in the
public directory, and it
will be compiled to HTML upon next build. You probably want to link to
this page from another page/post, otherwise it won't be discoverable.