html5-starter 0.1.3b

data/LICENSE

@@ -0,0 +1,3 @@
+Copyright (c) 2010 Peter Gumeson
+
+http://creativecommons.org/licenses/by/3.0/

data/README.md

@@ -0,0 +1,135 @@
+Compass Html5 Boilerplate
+=========================
+
+HTML5 Boilerplate is a Compass extension based on HTML5 Boilerplate by Paul Irish.
+You can use it to kick-start fully compliant HTML5 applications. Generate either
+stand-alone HTML5 projects, or Rails applications with fully integrated HTML5
+Haml and Sass (Scss) templates.
+
+Browse [html5boilerplate.com](http://html5boilerplate.com) for the full workup.
+
+Rails Installation
+==================
+
+    gem install html5-boilerplate
+    cd my_rails_project
+    compass init rails -r html5-boilerplate -u html5-boilerplate --force
+
+**This will install the following files in your rails project:**  
+(Using `--force` flag will overwrite any files that may already exist. In most cases this is probably what you want.)
+
+    app/views/layouts/application.html.haml
+    app/views/layouts/_flashes.html.haml
+    app/views/layouts/_footer.html.haml
+    app/views/layouts/_head.html.haml
+    app/views/layouts/_header.html.haml
+    app/views/layouts/_javascripts.html.haml
+    app/views/layouts/_stylesheets.html.haml
+    
+    app/stylesheets/style.scss
+    app/stylesheets/handheld.scss
+    app/stylesheets/partials/_base.scss
+    app/stylesheets/partials/_example.scss
+    app/stylesheets/partials/_page.scss
+    
+    public/404.html
+    public/.htaccess
+    public/crossdomain.xml
+    public/robots.txt
+    public/apple-touch-icon.png
+    public/favicon.ico
+
+    public/javascripts/dd_belatedpng.js
+    public/javascripts/jquery-1.4.4.min.js
+    public/javascripts/modernizr-1.6.min.js
+    public/javascripts/plugins.js
+    public/javascripts/rails.js
+    public/javascripts/profiling/charts.swf
+    public/javascripts/profiling/config.js
+    public/javascripts/profiling/yahoo-profiling.css
+    public/javascripts/profiling/yahoo-profiling.min.js
+    
+    config/compass.rb
+    config/initializers/compass.rb
+    config/google.yml
+    config/nginx.conf
+    config/mime.types
+
+The Scss files above will automatically get compiled to your Sass compilation directory:
+
+    public/stylesheets/style.css
+    public/stylesheets/handheld.css
+
+**Note:** If you already have a config/compass.rb file in your project, you may need to
+manually add the following line to the top:
+
+    require 'html5-boilerplate'
+
+### A few more minor points to store into your brainpan...
+
+If you still have an application.html.erb in your layouts, you will need to loose
+it now so that Rails will use your shiny new application.html.haml layout instead.
+
+The haml will compile to the equivalent of html5-boilerplate's index.html,
+but with all comments stripped out, and some additional rails stuff
+like csrf_meta_tags, flashes and the Rails jQuery driver.
+
+You can set your own Google Analytics Account ID and your Google API Key
+either as ENV variables, or inside config/google.yml.
+
+This extension has only been tested on Rails3.
+
+
+Stand Alone Installation
+========================
+
+    gem install html5-boilerplate
+    compass create my_project -r html5-boilerplate -u html5-boilerplate --javascripts-dir js --css-dir css
+
+The `--javascripts-dir` and `--css-dir` flags are to keep consistent with the original project layout.
+If you omit them, be sure to edit your javascript and style tags accordingly in index.html.
+
+**This will create a `my_project` directory containing the following files:**  
+
+    index.html
+    404.html
+    crossdomain.xml
+    robots.txt
+    apple-touch-icon.png
+    favicon.ico
+    
+    src/style.scss
+    src/handheld.scss
+    src/partials/_base.scss
+    src/partials/_example.scss
+    src/partials/_page.scss
+    
+    js/dd_belatedpng.js
+    js/jquery-1.4.4.min.js
+    js/modernizr-1.6.min.js
+    js/plugins.js
+    js/profiling/charts.swf
+    js/profiling/config.js
+    js/profiling/yahoo-profiling.css
+    js/profiling/yahoo-profiling.min.js
+    
+    .htaccess
+    config.rb
+    nginx.conf
+    mime.types
+    web.config
+
+Run `compass watch my_project` and the SCSS files above will automatically
+get compiled to your Sass compilation directory whenever a change is made:
+
+    css/style.css
+    css/handheld.css
+
+License
+=======
+
+HTML5 Boilerplate by Paul Irish  
+(comments left intact in scss files)
+
+Compass Extension Copyright (c) 2010, Peter Gumeson  
+[http://creativecommons.org/licenses/by/3.0](http://creativecommons.org/licenses/by/3.0)

data/VERSION

@@ -0,0 +1 @@
+0.2.6

data/lib/app/helpers/html5_boilerplate_helper.rb

@@ -0,0 +1,47 @@
+module Html5BoilerplateHelper
+  # Create a named haml tag to wrap IE conditional around a block
+  # http://paulirish.com/2008/conditional-stylesheets-vs-css-hacks-answer-neither
+  def ie_tag(name=:body, attrs={}, &block)
+    attrs.symbolize_keys!
+    haml_concat("<!--[if lt IE 7 ]> #{ tag(name, add_class('ie6', attrs), true) } <![endif]-->".html_safe)
+    haml_concat("<!--[if IE 7 ]>    #{ tag(name, add_class('ie7', attrs), true) } <![endif]-->".html_safe)
+    haml_concat("<!--[if IE 8 ]>    #{ tag(name, add_class('ie8', attrs), true) } <![endif]-->".html_safe)
+    haml_concat("<!--[if IE 9 ]>    #{ tag(name, add_class('ie9', attrs), true) } <![endif]-->".html_safe)
+    haml_concat("<!--[if (gte IE 9)|!(IE)]><!-->".html_safe)
+    haml_tag name, attrs do
+      haml_concat("<!--<![endif]-->".html_safe)
+      block.call
+    end
+  end
+
+  def ie_html(attrs={}, &block)
+    ie_tag(:html, attrs, &block)
+  end
+
+  def ie_body(attrs={}, &block)
+    ie_tag(:body, attrs, &block)
+  end
+
+  def google_account_id
+    ENV['GOOGLE_ACCOUNT_ID'] || google_config(:google_account_id)
+  end
+
+  def google_api_key
+    ENV['GOOGLE_API_KEY'] || google_config(:google_api_key)
+  end
+
+private
+
+  def add_class(name, attrs)
+    classes = attrs[:class] || ''
+    classes.strip!
+    classes = ' ' + classes if !classes.blank?
+    classes = name + classes
+    attrs.merge(:class => classes)
+  end
+
+  def google_config(key)
+    configs = YAML.load_file(File.join(Rails.root, 'config', 'google.yml'))[Rails.env.to_sym] rescue {}
+    configs[key]
+  end
+end

data/lib/html5-boilerplate.rb

@@ -0,0 +1,6 @@
+Compass::Frameworks.register("html5-boilerplate", :path => "#{File.dirname(__FILE__)}/..")
+
+if defined?(ActionController)
+  require File.join(File.dirname(__FILE__), 'app', 'helpers', 'html5_boilerplate_helper')
+  ActionController::Base.helper(Html5BoilerplateHelper)
+end

data/stylesheets/_html5-boilerplate.scss

@@ -0,0 +1,15 @@
+@import "compass/css3";
+
+@import "html5-boilerplate/reset";
+@import "html5-boilerplate/fonts";
+@import "html5-boilerplate/styles";
+@import "html5-boilerplate/helpers";
+@import "html5-boilerplate/print";
+
+@mixin html5-boilerplate {
+  @include html5-boilerplate-reset;
+  @include html5-boilerplate-fonts;
+  @include html5-boilerplate-styles;
+  @include html5-boilerplate-helpers;
+  @include html5-boilerplate-print;
+}

data/stylesheets/html5-boilerplate/_fonts.scss

@@ -0,0 +1,36 @@
+$base-font-family: unquote("sans-serif") !default;
+$base-font-size: 13px !default;
+$base-line-height: 1.231 !default;
+
+@mixin html5-boilerplate-fonts($family: $base-font-family, $size: $base-font-size, $line-height: $base-line-height) {
+  /* font normalization inspired by  from the YUI Library's fonts.css: developer.yahoo.com/yui/ */
+  body { 
+    font-size: $size;
+    font-family: $family;
+    line-height: $line-height;
+    /* hack retained to preserve specificity */
+    *font-size: small;
+  }
+  select, input, textarea, button { font: 99% $family; }
+
+  /* normalize monospace sizing
+   * en.wikipedia.org/wiki/MediaWiki_talk:Common.css/Archive_11#Teletype_style_fix_for_Chrome */
+  pre, code, kbd, samp { font-family: monospace, sans-serif; }
+}
+
+// Sets the font size specified in pixels using percents so that the base
+// font size changes and 1em has the correct value. When nesting font size
+// declarations, within the DOM tree, the base_font_size must be the parent's
+// effective font-size in pixels.
+// Usage Examples:
+//   .big
+//     +font-size(16px)
+//   .bigger
+//     +font-size(18px)
+//   .big .bigger
+//     +font-size(18px, 16px)
+//
+// For more information see the table found at http://developer.yahoo.com/yui/3/cssfonts/#fontsize
+@mixin font-size($size, $base-font-size: $base-font-size) {
+  font-size: ceil(percentage($size / $base-font-size));
+}

data/stylesheets/html5-boilerplate/_handheld.scss

@@ -0,0 +1,8 @@
+* {
+  float: none;       // Screens are not big enough to account for floats
+  background: #fff;  // As much contrast as possible */
+  color: #000;
+}
+
+// Slightly reducing font size to reduce need to scroll
+body { font-size: 80%; }

data/stylesheets/html5-boilerplate/_helpers.scss

@@ -0,0 +1,25 @@
+@mixin html5-boilerplate-helpers {
+  /*
+   * Non-semantic helper classes: please define your styles before this section.
+   */
+  
+  /* for image replacement */
+  .ir { display: block; text-indent: -999em; overflow: hidden; background-repeat: no-repeat; text-align: left; direction: ltr; }
+
+  /* Hide for both screenreaders and browsers
+    css-discuss.incutio.com/wiki/Screenreader_Visibility */
+  .hidden { display: none; visibility: hidden; }
+
+  /* Hide only visually, but have it available for screenreaders: by Jon Neal
+   www.webaim.org/techniques/css/invisiblecontent/  &  j.mp/visuallyhidden */
+  .visuallyhidden { border: 0; clip: rect(0 0 0 0); height: 1px; margin: -1px; overflow: hidden; padding: 0; position: absolute; width: 1px; }
+
+  /* Hide visually and from screenreaders, but maintain layout */
+  .invisible { visibility: hidden; }
+
+  /* >> The Magnificent CLEARFIX: Updated to prevent margin-collapsing on child elements << j.mp/bestclearfix */
+  .clearfix:before, .clearfix:after { content: "\0020"; display: block; height: 0; visibility: hidden; }
+  .clearfix:after { clear: both; }
+  /* fix clearfix: blueprintcss.lighthouseapp.com/projects/15318/tickets/5-extra-margin-padding-bottom-of-page */
+  .clearfix { zoom: 1; }
+}

data/stylesheets/html5-boilerplate/_print.scss

@@ -0,0 +1,20 @@
+@mixin html5-boilerplate-print {
+  /*
+   * print styles
+   * inlined to avoid required HTTP connection www.phpied.com/delay-loading-your-print-css/
+   */
+  @media print {
+    * { background: transparent !important; color: black !important; text-shadow: none !important; filter:none !important;
+    -ms-filter: none !important; } /* black prints faster: sanbeiji.com/archives/953 */
+    a, a:visited { color: #444 !important; text-decoration: underline; }
+    a[href]:after { content: " (" attr(href) ")"; }
+    abbr[title]:after { content: " (" attr(title) ")"; }
+    .ir a:after, a[href^="javascript:"]:after, a[href^="#"]:after { content: ""; }  /* don't show links for images, or javascript/internal links */
+    pre, blockquote { border: 1px solid #999; page-break-inside: avoid; }
+    thead { display: table-header-group; } /* css-discuss.incutio.com/wiki/Printing_Tables */
+    tr, img { page-break-inside: avoid; }
+    @page { margin: 0.5cm; }
+    p, h2, h3 { orphans: 3; widows: 3; }
+    h2, h3{ page-break-after: avoid; }
+  }
+}

data/stylesheets/html5-boilerplate/_reset.scss

@@ -0,0 +1,50 @@
+@mixin html5-boilerplate-reset {
+  /*
+    html5doctor.com Reset Stylesheet (Eric Meyer's Reset Reloaded + HTML5 baseline)
+    v1.6.1 2010-09-17 | Authors: Eric Meyer & Richard Clark
+    html5doctor.com/html-5-reset-stylesheet/
+  */
+  
+  html, body, div, span, object, iframe,
+  h1, h2, h3, h4, h5, h6, p, blockquote, pre,
+  abbr, address, cite, code, del, dfn, em, img, ins, kbd, q, samp,
+  small, strong, sub, sup, var, b, i, dl, dt, dd, ol, ul, li,
+  fieldset, form, label, legend,
+  table, caption, tbody, tfoot, thead, tr, th, td,
+  article, aside, canvas, details, figcaption, figure,
+  footer, header, hgroup, menu, nav, section, summary,
+  time, mark, audio, video {
+    margin:0;
+    padding:0;
+    border:0;
+    font-size:100%;
+    font: inherit;
+    vertical-align:baseline;
+  }
+
+  article, aside, details, figcaption, figure,
+  footer, header, hgroup, menu, nav, section {
+      display:block;
+  }
+
+  blockquote, q { quotes:none; }
+
+  blockquote:before, blockquote:after,
+  q:before, q:after { content:''; content:none; }
+
+  ins { background-color:#ff9; color:#000; text-decoration:none; }
+
+  mark { background-color:#ff9; color:#000; font-style:italic; font-weight:bold; }
+
+  del { text-decoration: line-through; }
+
+  abbr[title], dfn[title] { border-bottom:1px dotted; cursor:help; }
+
+  table { border-collapse:collapse; border-spacing:0; }
+
+  hr { display:block; height:1px; border:0; border-top:1px solid #ccc; margin:1em 0; padding:0; }
+
+  input, select { vertical-align:middle; }
+  
+  /* END RESET CSS */
+}

data/stylesheets/html5-boilerplate/_styles.scss

@@ -0,0 +1,100 @@
+$font-color: #444 !default;  //looks better than black: twitter.com/H_FJ/statuses/11800719859
+$link-color: #607890 !default;
+$link-hover-color: #036 !default;
+$link-active-color: #607890 !default;
+$link-visited-color: #607890 !default;
+$selected-font-color: #fff !default;
+$selected-background-color: #ff5e99 !default;
+$list-left-margin: 2em !default;
+
+
+@mixin html5-boilerplate-styles {
+  /*
+   * minimal base styles
+   */
+  
+  
+  body, select, input, textarea {
+    /* #444 looks better than black: twitter.com/H_FJ/statuses/11800719859 */
+    color: $font-color;
+    /* set your base font here, to apply evenly */
+    font-family: $base-font-family;
+  }
+
+  /* headers (h1,h2,etc) have no default font-size or margin. define those yourself. */
+  h1,h2,h3,h4,h5,h6 { font-weight: bold; }
+
+  /* always force a scrollbar in non-IE: */
+  html { overflow-y: scroll; }
+
+
+  /* accessible focus treatment: people.opera.com/patrickl/experiments/keyboard/test */
+  a:hover, a:active { outline: none; }
+
+  a, a:active, a:visited { color: $link-color; }
+  a:hover { color: $link-hover-color; }
+
+
+  ul, ol { margin-left: $list-left-margin; }
+  ol { list-style-type: decimal; }
+
+  /* remove margins for navigation lists */
+  nav ul, nav li { margin: 0; list-style:none; list-style-image: none; }
+
+  small { font-size: 85%; }
+  strong, th { font-weight: bold; }
+
+  td { vertical-align: top; }
+
+  /* set sub, sup without affecting line-height: gist.github.com/413930 */
+  sub, sup { font-size: 75%; line-height: 0; position: relative; }
+  sup { top: -0.5em; }
+  sub { bottom: -0.25em; }
+
+  pre {
+    /* www.pathf.com/blogs/2008/05/formatting-quoted-code-in-blog-posts-css21-white-space-pre-wrap/ */
+    white-space: pre; white-space: pre-wrap; white-space: pre-line; word-wrap: break-word;
+    padding: 15px;
+  }
+
+  textarea { overflow: auto; } /* www.sitepoint.com/blogs/2010/08/20/ie-remove-textarea-scrollbars/ */
+
+  .ie6 legend, .ie7 legend { margin-left: -7px; } /* thnx ivannikolic! */
+
+  /* align checkboxes, radios, text inputs with their label by: Thierry Koblentz tjkdesign.com/ez-css/css/base.css  */
+  input[type="radio"] { vertical-align: text-bottom; }
+  input[type="checkbox"] { vertical-align: bottom; }
+  .ie7 input[type="checkbox"] { vertical-align: baseline; }
+  .ie6 input { vertical-align: text-bottom; }
+
+  /* hand cursor on clickable input elements */
+  label, input[type="button"], input[type="submit"], input[type="image"], button { cursor: pointer; }
+
+  /* webkit browsers add a 2px margin outside the chrome of form elements */
+  button, input, select, textarea { margin: 0; }
+
+  /* colors for form validity */
+  input:invalid, textarea:invalid {
+    @include border-radius(1px);
+    @include box-shadow(red, 0, 0, 5px, 0);
+  }
+  .no-boxshadow input:invalid, .no-boxshadow textarea:invalid { background-color: #f0dddd; }
+
+
+  /* These selection declarations have to be separate.
+     No text-shadow: twitter.com/miketaylr/status/12228805301
+     Also: hot pink. */
+  ::-moz-selection{ background: $selected-background-color; color: $selected-font-color; text-shadow: none; }
+  ::selection { background: $selected-background-color; color: $selected-font-color; text-shadow: none; }
+
+  /*  j.mp/webkit-tap-highlight-color */
+  a:link { -webkit-tap-highlight-color: $selected-background-color; }
+
+  /* make buttons play nice in IE:
+     www.viget.com/inspire/styling-the-button-element-in-internet-explorer/ */
+  button {  width: auto; overflow: visible; }
+
+  /* bicubic resizing for non-native sized IMG:
+     code.flickr.com/blog/2008/11/12/on-ui-quality-the-little-things-client-side-image-resizing/ */
+  .ie7 img { -ms-interpolation-mode: bicubic; }
+}