barebones/README.md

# barebones

A lightweight and skeletal WordPress boilerplate theme for HTML5 and beyond. There's lots of these out there but most themes include lots of bloat and files which you might not necessarily need, so I thought I'd create my own which is great as a starting point with powerful features to encourage rapid development for most projects.

## Features

* Reset, normalisation and base font/form styles
* Sass powered - semantically named files all compiled into a single file
* Semantic use of HTML5 elements, includes Google HTML5 shiv
* WAI-ARIA role ready
* Comes pre-bundled with cached CDN version of jQuery
* jQuery plugin agnostic
* Basic index.php Loop template
* Customised functions.php adding theme support for high customisation
* Minimised HTTP requests for high Web Performance
* Localised strings for multiple language support
* Grunt automatic image optimisation, Sass compiling and watching, css minification and live reload support
* Use of Browserify to modularise the JavaScript structure and stop those huge, spaghetti script files!

## Installation

### Dependencies

* [Node.js](http://nodejs.org)
* [Grunt](http://gruntjs.com)
* [Browserify](http://browserify.org)

#### Optional

* [LiveReload Chrome plugin](https://chrome.google.com/webstore/detail/livereload/jnihajbhpnppcggbcgedagnkighmdlei)

Clone/download the barebones repositories into your WordPress /wp-content/themes/ directory and run the following to install all of this project's Grunt dependencies:

    $ npm install

Then run `grunt` to execute the default tasks: compiling sass/js and creating the watcher.

To aid performance, the image-centric tasks aren't run by default and can be executed by running:

    $ grunt img

## WordPress Support

Compatible with WordPress 3.2 and above, but always use the latest version.

## Browser Support

* Internet Explorer 8.0+
* Firefox 3.0+
* Safari 4.0+
* Chrome 14.0+
* Opera 10.0+


## Roadmap

* ~~Organisation of Sass folders~~
* ~~Simple grid framework~~
* ~~Organisation of JS~~
Added README 2012-11-14 00:42:34 +01:00			`# barebones`

gulp integration 2014-02-06 16:16:07 +01:00			`A lightweight and skeletal WordPress boilerplate theme for HTML5 and beyond. There's lots of these out there but most themes include lots of bloat and files which you might not necessarily need, so I thought I'd create my own which is great as a starting point with powerful features to encourage rapid development for most projects.`
Added README 2012-11-14 00:42:34 +01:00
			`## Features`

Yadda yah 2012-12-20 22:33:35 +01:00			`* Reset, normalisation and base font/form styles`
Readingz 2013-07-01 23:49:53 +02:00			`* Sass powered - semantically named files all compiled into a single file`
Update README.md 2013-08-06 10:37:22 +02:00			`* Semantic use of HTML5 elements, includes Google HTML5 shiv`
Yappedy yapp 2012-12-20 22:24:36 +01:00			`* WAI-ARIA role ready`
Browser support 2013-11-21 10:10:59 +01:00			`* Comes pre-bundled with cached CDN version of jQuery`
Update README.md 2013-10-11 18:24:01 +02:00			`* jQuery plugin agnostic`
			`* Basic index.php Loop template`
More stuff for functions.php 2012-12-20 22:18:50 +01:00			`* Customised functions.php adding theme support for high customisation`
Conversion to SASS See updated README.md for details. 2013-01-01 19:11:50 +01:00			`* Minimised HTTP requests for high Web Performance`
Update README.md 2013-10-11 18:28:37 +02:00			`* Localised strings for multiple language support`
Update README.md 2014-08-15 13:20:01 +02:00			`* Grunt automatic image optimisation, Sass compiling and watching, css minification and live reload support`
			`* Use of Browserify to modularise the JavaScript structure and stop those huge, spaghetti script files!`
Update README.md 2014-01-30 12:32:16 +01:00
			`## Installation`

Update README.md 2014-02-03 16:36:18 +01:00			`### Dependencies`
Update README.md 2014-01-30 12:32:16 +01:00
Integration of Browserify 2014-08-15 12:43:24 +02:00			`* [Node.js](http://nodejs.org)`
			`* [Grunt](http://gruntjs.com)`
			`* [Browserify](http://browserify.org)`
re-integration of grunt 2014-02-21 11:23:33 +01:00
			`#### Optional`

			`* [LiveReload Chrome plugin](https://chrome.google.com/webstore/detail/livereload/jnihajbhpnppcggbcgedagnkighmdlei)`
Update README.md 2014-01-30 12:32:16 +01:00
Organised sass folders 2014-06-20 16:59:08 +02:00			`Clone/download the barebones repositories into your WordPress /wp-content/themes/ directory and run the following to install all of this project's Grunt dependencies:`
Update README.md 2014-01-30 12:32:16 +01:00
Organised sass folders 2014-06-20 16:59:08 +02:00			`$ npm install`
IE 8 includes 2014-02-07 13:29:13 +01:00
Integration of Browserify 2014-08-15 12:43:24 +02:00			Then run `grunt` to execute the default tasks: compiling sass/js and creating the watcher.

			`To aid performance, the image-centric tasks aren't run by default and can be executed by running:`

Update README.md 2014-09-03 14:18:42 +02:00			`$ grunt img`
Yappedy yapp 2012-12-20 22:24:36 +01:00
Yadda yah 2012-12-20 22:33:35 +01:00			`## WordPress Support`
Yappedy yapp 2012-12-20 22:24:36 +01:00
re-integration of grunt 2014-02-21 11:23:33 +01:00			`Compatible with WordPress 3.2 and above, but always use the latest version.`
Yappedy yapp 2012-12-20 22:24:36 +01:00
			`## Browser Support`

gulp integration 2014-02-06 16:16:07 +01:00			`* Internet Explorer 8.0+`
Update README.md 2013-11-21 10:11:13 +01:00			`* Firefox 3.0+`
			`* Safari 4.0+`
			`* Chrome 14.0+`
			`* Opera 10.0+`
Update README.md 2014-02-03 16:36:18 +01:00

			`## Roadmap`

Readme fails 2014-06-20 17:04:44 +02:00			`* ~~Organisation of Sass folders~~`
Update README.md 2014-06-25 10:44:23 +02:00			`* ~~Simple grid framework~~`
Update README.md 2014-08-15 13:20:01 +02:00			`* ~~Organisation of JS~~`