=== Theme Name === Contributors: Ben Shrimpton Tags: html5, boilerplate Based on the HTML5 Boilerplate created by Paul Irish and Divya Manian, this allows for easy inclusion/removal of all HTML5 Boilerplate options. This theme might look like a little bit of a quagmire at first blush because it is a merger of two great themes with a very minor bit by me, but stay with me, it'll all make sense in a bit, I promise. == Description == Standing on the foreheads of giants (namely [Paul Irish](http://paulirish.com/) and [Divya Manian](http://nimbupani.com/) and the good folks that have helped them create and continue the growth of HTML5 Boilerplate, I present to you my first WordPress theme, [Boilerplate - Starkers WP Theme](http://aarontgrogg.com/boilerplate/). The clumsiest part of this plug-in is dealing with the CSS files. To avoid any changes you make from being overwritten during upgrades, "starter" files have been created in the plug-in's css directory. I recommend copying the contents of the starter files into new files that you can safely edit. That way, if the starter files are updated later, you can simply copy/paste from them into your files again, and all is fine. Another route would be to add `@import` statements at the top of your file, but this does increase your HTTP Requests, which hurts performance... Your call, let me know if you can think of a better implementation. More about this theme can be found at: [http://aarontgrogg.com/boilerplate/](http://aarontgrogg.com/boilerplate/). I also built a Boilerplate plug-in that can be found at: [http://aarontgrogg.com/html5boilerplate/](http://aarontgrogg.com/html5boilerplate/). The plug-in can be added to any existing or new theme, allowing the easy additional of all the delicious HTML5 Boilerplate goodiness with the ease of checking checkboxes. Please let me know if you have any questions/suggestions/thoughts, Atg [http://aarontgrogg.com/](http://aarontgrogg.com/) [aarontgrogg@gmail.com](mailto:aarontgrogg@gmail.com) === Change Log === = 3.4.4 2012-03-10 = Fixing a bad URL in several custom CSS and JS strings, where: ...`BP_THEME_URL. 'js`... should have been: ...`BP_THEME_URL. '/js`... Muchas gracias a Benjamin Arnedo! = 3.4.3 2012-03-01 = Updated admin-menu.php to permit the Boilerplate Theme and HTML5 Boilerplate Plug-in to exist side-by-side. In this case, the Plug-in functionality will persist and the Theme functionality will lie dormant. = 3.4.2 2012-02-25 = Removed boilerplate_category_id_class from functions.php; if you want this functionality, I recommend installing this plug-in: http://wordpress.org/extend/plugins/add-url-slugs-as-body-classes/ Altered boilerplate_posted_on function to reflect three Archive links rather than a single permalink to Post; thanks to Alexander Bailey for the idea! = 3.4.1 2012-02-24 = (I bumped-up the version number a bit to match the HTML5 Boilerplate Plug-in numbering.) * Converted `... />` to `...>` for all the stuff this plug-in writes to the page. * Updated `/css/style-starter.css` to latest HTML5 Boilerplate version. * Updated jQuery to 1.7.1. * Updated Modernizr to 2.5.3, Custom Build. * Added 57x57 iThing favicon link. * Fixed Bug introduced by WP 3.3+ that causes jQuery to be loaded after site-specific JS. = v.3.0 2011-06-02 = Fixed error in header.php, I was applying `boilerplate_filter_wp_title` as a `filter` to `wp_title` in functions.php, but then calling `boilerplate_filter_wp_title` in header.php, rather than `wp_title`... der... Thanks, Randy Runnels! Per Paul & Divya recommendations: - Dropping cdnjs link for Modernizr, resorting to local link only, hopefully soon that will be replaced with Google CDN link. - Removed handheld.css, because "our research has shown not enough devices read it to make it worthwhile". Additionally, if you're doing your CSS right (a la Responsive Design, you're building for smaller screens first, then adding CSS for larger screens via `@media` queries, right?). - Removed print.css because "extra print stylesheets are downloaded at load, so its a big hit"; this, too, is best served via `@media` queries in your main CSS. - Removed YUI Profiling stuff because you "probably weren't using it anyway", right? - Removed Belated PNG because it "is a really slow solution and an overkill for PNGs", check [http://html5boilerplate.com/docs/#Notes-on-using-PNG](http://html5boilerplate.com/docs/#Notes-on-using-PNG) for deets on dealing with PNGs in ye olde IE. Added removal of IE6 Image Toolbar option to Admin panel. Added [Google Verification](http://www.google.com/support/webmasters/bin/answer.py?answer=35179) option to Admin panel. Added iPad and iPhone 4 favicon links to existing "iThing Favicon" block. Added [Respond.js](http://filamentgroup.com/lab/respondjs_fast_css3_media_queries_for_internet_explorer_6_8_and_more/) option to Admin panel. Added cache-buster option in Admin panel, allowing you to either include, and easily increment, a cache-buster / version number to any theme CSS or JS files. Updated `/style.css` to latest HTML5 Boilerplate version. Updated jQuery to 1.6.1. Updated `/js/plugins.js` to include `console.log` bit. = v.2.1.8 2011-05-08 = Attempting to clear issues WP is having with Boilerplate CSS. Changed Boilerplate Admin CSS filename from style.css to admin-style.css. Updated jQuery to 1.6. Miscellaneous updates from http://html5boilerplate.com/, including CSS and JS files. Removed _READ_ME.txt (from Starkers theme) and README.markdown (from HTML5 Boilerplate), if you need to read them, check the respective sites for them. Enhanced this readme.txt file a little, for your reading pleasure. // Moved Boilerplate Admin link from Themes to Settings (seem like that's where it ought to be, right?). // Nope, automated upload process insists any admin pages be in the Themes section... Enhanced Boilerplate Admin panel, offering slightly improved explanations. // Trying once again to get WP to allow the inclusion of Google Analytics block option in Boilerplate Admin panel. // Nope, automated upload process still blocks any reference to this... = v.2.1.4 2011-01-14 = Removed extraneous > in 404.php (thanks, Dominic!) Miscellaneous updates from http://html5boilerplate.com/ Per WP, reduced size of screenshot.png. = v.2.1 2010-11-14 = Per WP, changed screenshot.png to reflect visual representation of site, not HTML4 Boilerplate logo. Added additional classes (ie, lte7, lte8, lte9, where appropriate) to IE Conditional Comments in wrap <html> block. Removed extraneous (explanatory) comments from HTML, hopefully you'll get it, if not, refer to HTML5 Boilerplate documentation (https://github.com/paulirish/html5-boilerplate/wiki). Expanded Admin Page content, adding text and links to help users understand each option more clearly. Removed the following from header.php and added as optional items on the Admin page: - <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1"> - <meta name="viewport" content="width=device-width, initial-scale=1.0"> - <link rel="shortcut icon" href="/favicon.ico"> - <link rel="apple-touch-icon" href="/apple-touch-icon.png"> Added an option to the Admin page to include an IE-only CSS. A few people recommended changing third-party links (Modernizr, jQuery, etc.) to Google repository. I went back-and-forth on this, whether it made more sense to link to Google's repository (possible caching benefits, definite CDN benefits), or whether it made more sense to give the developer the ability to control their own assets and serve from local files. In the end, I went with local versions, mostly for version-control, but also because I figure if Google goes down, it could hurt your site; if your site is down, whether JS is available isn't exactly your biggest problem... In some future version I'd like to make both options available via the Admin page... It would be fairly easy to change these paths if you wanted, in /wp-content/themes/boilerplate/boilerplate-admin/admin-menu.php, under "Create functions to add above elements to pages" A few recommendations gratefully accepted from Micah (http://www.twolanedesign.com/): - If Modernizr is unchecked, IEShiv will be added (inside an IE conditional comment). - Add Async Google Analytics option to Admin Page. * Appears WP doesn't like GA, so this has been removed, but check here for instructions () on how to add it back in once you've downloaded Boilerplate... - Removing WP version number via functions.php (http://digwp.com/2009/07/remove-wordpress-version-number/) - Also recommended these two links which do contain some great scripts, but kind of go against the idea of Starkers (that less-is-more). You can easily add anything you like to the functions.php: http://digwp.com/2010/03/wordpress-functions-php-template-custom-functions/ http://digwp.com/2010/04/wordpress-custom-functions-php-template-part-2/ Grabbed updated assets (css, js, etc.) from github per: - http://github.com/paulirish/html5-boilerplate/compare/v0.9...v0.9.1 - http://github.com/paulirish/html5-boilerplate/compare/v0.9.1...v0.9.5 = v.2.0.1 2010-10-06 = Boilerplate starts with the Starkers theme (http://starkerstheme.com/)... mixes in HTML5 Boilerplate (http://html5boilerplate.com/)... then makes a couple minor modifications... 1) moved IE conditionals from <boby> to <html>, to better synch with Modernizr... 2) above also allowed me to remove the <!--[if IE]><![endif]--> recommended by www.phpied.com/conditional-comments-block-downloads/... 3) moved extraneous items (like Modernizr, jQuery, Belated PNG, etc.) to Admin panel (not the last item in the Settings drop-down)... The only extraneous items left in the mark-up are the two favicon references in header.php; read about it there. * The directory "- MOVE TO ROOT" is filled with HTML5 Boilerplate goodness that should be copied FROM that directory and pasted TO your blog's root directory. * The .htaccess in that directory is filled with things which I honestly do not understand... I had to comment-out several items in order to get my WP installation to work, so, play if you like. Be sure to read these "read me" type files as well: - _READ_ME.txt and _LICENSE.txt are from Starkers Theme - README.markdown is from HTML5 Boilerplate = v.1.0 2010-10-01 = Was pure crap, please ignore...