Files for technical blog
HTML CSS JavaScript
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
src
.gitignore
README.md
blog.js
package.json

README.md

Flagrant System Error Blog

These are the files for a minimal blog used for my site flagrantsystemerror.

The blog is a static site generated using metalsmith.

Install

MultiMarkdown and node.js/npm must already be installed. On macOS, run the following to download the necessary dependencies required for the blog.

brew install multimarkdown
npm install

Usage

To generate the blog, use node blog.js in the root directory, which will invoke metalsmith and generate the files in the site directory.

There are posts and pages. Posts are what appear on the blog, and pages are separate content from the blog itself, but are likely referenced from individual posts (see My C++ Coding Guidelines for an example).

Posts go into the src/posts directory and pages go into... wait for it... the src/pages directory.

I use Markdown to author the posts and generate the html with MultiMarkdown. I use MultiMarkdown Composer to author the posts, and MultiMarkdown generates the same HTML as MultiMarkdown Composer does (since they were both written by the same person).

The HTML generated does not contain the full document, but just the snippet of the document, which is then inserted into a Mustache template (kept in src/templates).

License

The files specific to this site are licensed under the Unlicense. Otherwise, all components are licensed as indicated by their respective owners.