README.md

What is it?

This is the front page of foundation, a Jekyll based simplistic website with a few defaults and basic features, including:

Aggregation of JS and CSS files,

Static pages (like this front page) and a blog,

Atom feed,

Sitemap.xml and robots.txt,

Clean & simple HTML5 markup,

Nothing else (that's the goal),

Support for LESS,

Why?

Using Github pages, and Jekyll to a larger extent, to build a wide range of website and web apps, we (as in Wiredcraft) needed a clean slate with a minimalistic boilerplate on which to build things.

Most of what was available out there was either bloated with features, missing important ones (proper feed or sitemap) or presented awkward markup. We also needed to include simple libraries like normalize.css that we systematically use in our projects.

How do I get started

Change the config.yml to match your needs (take care at least of the url attribute: it's set to localhost:4000 for local development but change it to either the actual full site url or the relative path from the root url),

Static pages (.html) can be put at the root or any subfolder you create. After adding pages you'll probably want to update the menu in _layouts/default.html and review the atom.xml,

To add a CSS or JS file, simply drop it in _includes/css or _includes/js and update either all.css or all.js,

To customize things you may need component as it is the JS dependency manager. You can check both the Makefile and the component.json files to figure out what happens. make all rebuilds the whole set of dependencies and prepare the assets.js and assets.css files.