README.mkdn

Yet another HTML5 Boilerplate Wordpress theme - with a twist

This is a very stripped down wordpress theme that hopes to fill in a niche that, from our experience, hasn't been fully realized. If we're going to future-proof our wordpress themes with HTML5 and CSS3 let's not stop at just integrating Paul Irish and Divya Manian's Boilerplate or marking up with all the new HTML5 tags, let's use something like SASS/SCSS, Compass, and the Susy grid framework to facilitate easier and faster stylesheet authoring. The goal of this experiment is to pull in the best open source tools to help us work with wordpress theming.

And most importantly - to compile the changes you make in the theme's SCSS files, located in wp-content/themes/html5_boilerplate/sass/*, you may continually watch for changes :

compass watch /path/to/project/wp-content/themes/html5_boilerplate

The above will compile to wp-content/themes/html5_boilerplate/style.css with comments detailing the line in the SCSS where that was defined. For production purposes, or just for cleanliness's sake, to forcefully compile in a compact format, without the line comments :

Anatomy of this theme

As mentioned above, the html5 boilerplate project (https://github.com/paulirish/html5-boilerplate) serves as the basis for the markup and stylesheet as much as possible. The one exception that stands out is that javascript is still included within <head/> by default instead of just before </body>.

The latest versions of Modernizr, DD_belatedPNG and jQuery.

CSS has been split up into partials using the SCSS formatting method instead of traditional SASS. All partials can be found in html5_boilerplate/sass/partials.

In addition to base font variables, style.scss contains grid-related variables that will drive how we layout the theme. Currently the default is a 16 column grid (for a 960px wide grid), but you will also find a 12 column grid commented out above.

functions.php does some light housekeeping as well as additional options under Appearance > More Theme Options for turning on/off and setting up multiple sidebars (left, right, footer).

Further Reading

We highly recommend looking through the documentation for all the projects that helped make this theme what it is :