Compatibility With Other Static Site Generators

Engineer contains some compatibility features designed to ease transitions from other static site generators such as Jekyll/Octopress, as well as support tools designed for those systems.

Jekyll/Octopress

New in version 0.3.0.

Post Metadata ‘Fencing’

Jekyll requires that post metadata (or YAML front matter, in Jekyll terms) be ‘fenced’ within a YAML document separator, like so:

---
title: Post Title
tags:
- tag 1
- tag 2
---

Engineer, in contrast, does not require the metadata to be preceded by a ---. However, Engineer will handle Jekyll-style metadata with no trouble, and will maintain your post format during Metadata Finalization.

If you want Engineer to always output your metadata with or without fencing, you can use the METADATA_FORMAT setting. Simply set it to fenced or unfenced and Engineer will always output the format you specify, regardless of the input format.

New in version 0.3.0.

Post Breaks

Engineer supports Octopress-style <!--more--> post breaks in addition to the simpler -- more -- Engineer style using the bundled Post Breaks plugin.

New in version 0.3.0.