fn-static-generator's Introduction

foss-north static site generator

This is the foss-north static site generator. Since I'm tired of Ruby, I decided to drop Jekyll and look into Jinja myself. This small setup allows me to create a data driven site from YAML files and Jinja templates.

The paths are hardcoded and based on the location of the fn-generator.py script. The directories are:

_source/ - source *.html files. These are Jinja templates and each file results in the corresponding file being rendered to the _output/ directory.
_includes/ - includeable files. These are Jinja templates included or extended from the files in the _source/ directory.
_data/ - data set *.yaml files. These files are exposed as variables under the global data variable when rendering pages.
_assets/ - raw assets. This subtree is copied into the _output/ directory.
_output/ - the _output/ directory. This directory is created or updated by the script and can be removed.

When rendering the pages from the _source/ directory the global variable data is exposed to Jinja. This variable contains the following sub-variables:

data.page the name of the current page without file extension, e.g. when rendering index.html the variable data.page is set to index.
data.pages a list of all page names without file extensions.
data.N, where N corresponds to a YAML file from the _data/ directory. Each N the contains the contents of the associated YAML file.

Recommend Projects