feltnerm-pelican-theme

feltnerm-pelican-theme

This the front-end module of my Pelican-powered blog.

Getting Started

To use, set your pelican theme to this theme. A few of (my current) methods for accomplishing this are:

npm

% npm install --save feltnerm-pelican-theme

Iff ./node_modules is a direct child of your Pelican working-directory, then in pelicanconf.py you add/modify the following:

THEME = 'node_modules/feltnerm-pelican-theme'

Layout

CSS

• Sources: ./src/css
• Dependencies: normalize.css, typeset.css, flexboxgrid.css

Normalize is used (as it should), Typset is used for typographic things such as post bodies, and flexboxgrid is a simple wrapper for grid-based layouts using flexbox (sorry <=IE10 users).

JavaScript

• Sources: ./src/js
• Bundle Destination: ./build/bundle.js
• Dependencies:

Templates

Templates are written using Jinja and follow the pelican template conventions. They are 'compiled' with pelican. See the pelican theme documentation for more details.

Templates should follow semantic HTML5 (header, footer, nav, article, aside, section, etc.), and attempt to follow the microdata HTML5 standard as best as possible.

I am not entirely sure of the benefits of microdata in HTML documents yet, but consider this an experiment. Part of me wonders if it'd be possible to make static HTML pages into APIs if their markup was more machine readable.

Many of the templates have basic microdata elements defined, but if one is missing please submit an issue/pull-request!

Development

All sources are combined into a bundle in ./static.

Tasks

build

Runs [browserify]((http://browserify.org/) and [minifyify]((https://npmjs.com/packages/minifyify) over the sources and creates a standalone bundle with sourcemap.

This will always be the script that generates the JS bundle in origin/master and npm.