Content

Content is a bunch of Markdown files (or plain text files), called Pages, organized in folders. Folders in the root are called Section (ie: "Blog", "Project", etc.).

Pages

A Page can contain a front matter and/or a body.

Front matter

Any file that contains a front matter will be processed to extract some variables. The front matter must be the first thing in the file and must be a valid YAML.

Predefined variables

Variable Description Default value
title Title File basename without extension, ie: Post 1
section Section Root directory of the file path, ie: Blog
layout Layout See Layout fallback logic, ie: post.html
date Date File modification datetime (a Unix timestamp)
menu Menu Contains a main menu with Homepage and Sections entries
permalink Permalink Page pathname, ie: blog/post-1

Body

Body is the main content of the page, it could be written in Markdown or in plain text.

Example

---
title: The title
date: 2013-01-01
tags:
    - tag1
    - tag 2
customvar: 'Value of customvar'
---

# Lorem ipsum

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.
Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur.
Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
Suggest a modification Next