susy 1.0.9 → 2.0.0.alpha.1

data/CHANGELOG.mkdn

@@ -1,31 +1,6 @@
 Susy Changelog
 ==============
 
-v1.0.9 [June 19, 2013]
-----------------------
-
-* Fix clearing with `isolate-grid` mixin.
-* Allow changing nth-selectors in `isolate-grid` mixin.
-
-v1.0.8 [March 25, 2013]
------------------------
-
-* Fix more edge mixed-unit conflicts with `container-style: static`.
-
-v1.0.7 [March 19, 2013]
------------------------
-
-* Fix edge-case where `$container-style` and `$container-width` cause conflict.
-
-v1.0.6 [March 18, 2013]
------------------------
-
-* Add `isolate` and `isolate-grid` mixins.
-* Add `bleed` mixin.
-* Add `$style` argument to grid mixins.
-* Fix documentation typos.
-* Switch from `#` to `*` in legacy-ie hacks.
-
 v1.0.5 [Nov 27, 2012]
 ---------------------
 
@@ -292,5 +267,3 @@ older…
 
 * not documented here.
 * check the commit log.
-* Susy was created.
-

data/README.md

@@ -8,17 +8,16 @@ to your end user's super-tablet-multi-magic-lap-phone.
 You need grids that are powerful, but custom;
 reliable, but responsive.
 
-Susy grids are fluid on the inside,
-ready to respond at any moment,
-but contained in the candy shell of your choice,
-so they respond how and when and where you want them to.
-
 This isn't another one-size-fits-all grid framework
 that will make your sites look identical
 and litter your markup with meaningless "col2of5" jargon.
 We don't design your site or write your markup,
 we just do the math and get out of your way.
 
+We provide a single shared syntax for describing layouts,
+and then let you select your favorite output,
+or build your own.
+
 ## Resources
 - [Website](http://susy.oddbird.net)
 - [Changelog](https://github.com/ericam/susy/blob/master/CHANGELOG.mkdn)
@@ -37,85 +36,3 @@ Once you make changes,
 you can test them by building the gem
 and installing it somewhere to test.
 We also have unit tests that you can run.
-
-### Building the gem
-
-You'll need Rake and Echoe installed:
-
-```bash
-# command line
-gem install rake
-gem install echoe
-```
-
-It might be helpful to bump the version number in `VERSION`,
-but any changes you make there
-should not be committed.
-
-Then you can build:
-
-```bash
-# command line
-rake build
-```
-
-Your new gem will appear in
-a folder called `pkg`.
-You can install it for testing
-directly from there.
-
-```bash
-# command line
-gem install <path-to-file>
-```
-
-### Building the docs
-
-If you are adding features
-or changing how a current feature works,
-your changes should be documented.
-Or you might be helping us maintain the docs.
-In either case,
-you'll need to run the docs dev server
-in order to see your changes.
-
-In the `docs` folder:
-
-```bash
-# command line
-gem install bundler
-bundle install
-```
-
-The site is built with
-[middleman](http://middlemanapp.com/).
-To run the development server:
-
-```bash
-# command line
-middleman
-```
-
-The server should now be running at `localhost:4567`.
-
-Make any changes you need
-under the `source` directory,
-then commit your changes
-and submit a pull request when you are done!
-
-### Tests
-
-The tests we have are very basic at this point.
-Simply go into the `test` directory
-(with the latest Sass and Compass gems installed)
-and run `compass compile --force`.
-
-There should be no changes.
-If there are changes,
-go back and find what caused the change.
-If the change was intentional,
-simply commit the changed test files.
-If it was not intentional,
-go back and find what caused the problem.
-
-Use `git diff` to see the changes.

data/docs/BUGS.md

@@ -0,0 +1,2 @@
+Susy Documentation: Bugs
+=====================

data/docs/Gemfile.lock

@@ -0,0 +1,142 @@
+GIT
+  remote: git://github.com/chriseppstein/compass.git
+  revision: 7ff38d178cdfd167227dd7ed6bdbc028e9626a0e
+  branch: master
+  specs:
+    compass (0.13.alpha.0.7ff38d1)
+      chunky_png (~> 1.2)
+      listen (~> 0.5.3)
+      sass (~> 3.2.0.alpha.93)
+
+GIT
+  remote: git://github.com/wbzyl/rack-codehighlighter.git
+  revision: 64bf50520cb1d563432832ae30d85bbd94cec5bd
+  specs:
+    rack-codehighlighter (0.5.0)
+      nokogiri (>= 1.4.1)
+      rack (>= 1.0.0)
+
+PATH
+  remote: ../
+  specs:
+    susy (1.0.static.5)
+      compass (>= 0.12.2)
+      sass (>= 3.2.0)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    activesupport (3.2.9)
+      i18n (~> 0.6)
+      multi_json (~> 1.0)
+    chunky_png (1.2.6)
+    coffee-script (2.2.0)
+      coffee-script-source
+      execjs
+    coffee-script-source (1.3.3)
+    execjs (1.4.0)
+      multi_json (~> 1.0)
+    ffi (1.2.0)
+    haml (3.1.7)
+    hike (1.2.1)
+    http_router (0.10.2)
+      rack (>= 1.0.0)
+      url_mount (~> 0.2.1)
+    i18n (0.6.1)
+    listen (0.5.3)
+    maruku (0.6.1)
+      syntax (>= 1.0.0)
+    middleman (3.0.7)
+      middleman-core (= 3.0.7)
+      middleman-more (= 3.0.7)
+      middleman-sprockets (~> 3.0.2)
+    middleman-core (3.0.7)
+      activesupport (~> 3.2.6)
+      bundler (~> 1.1)
+      listen (~> 0.5.2)
+      rack (~> 1.4.1)
+      rack-test (~> 0.6.1)
+      rb-fsevent (~> 0.9.1)
+      rb-inotify (~> 0.8.8)
+      thor (~> 0.15.4)
+      tilt (~> 1.3.1)
+    middleman-more (3.0.7)
+      coffee-script (~> 2.2.0)
+      coffee-script-source (~> 1.3.3)
+      compass (>= 0.12.2)
+      execjs (~> 1.4.0)
+      haml (>= 3.1.6)
+      i18n (~> 0.6.0)
+      maruku (~> 0.6.0)
+      middleman-core (= 3.0.7)
+      padrino-helpers (= 0.10.7)
+      sass (>= 3.1.20)
+      uglifier (~> 1.2.6)
+    middleman-sprockets (3.0.5)
+      middleman-more (>= 3.0.1)
+      sprockets (~> 2.1, < 2.5)
+      sprockets-sass (~> 0.9.0)
+    modular-scale (1.0.2)
+      compass (>= 0.11.5)
+      sassy-math (>= 1.2)
+    multi_json (1.5.0)
+    nokogiri (1.5.6)
+    padrino-core (0.10.7)
+      activesupport (~> 3.2.0)
+      http_router (~> 0.10.2)
+      sinatra (~> 1.3.1)
+      thor (~> 0.15.2)
+      tilt (~> 1.3.0)
+    padrino-helpers (0.10.7)
+      i18n (~> 0.6)
+      padrino-core (= 0.10.7)
+    posix-spawn (0.3.6)
+    pygments.rb (0.3.3)
+      posix-spawn (~> 0.3.6)
+      yajl-ruby (~> 1.1.0)
+    rack (1.4.1)
+    rack-protection (1.3.2)
+      rack
+    rack-test (0.6.2)
+      rack (>= 1.0)
+    rb-fsevent (0.9.2)
+    rb-inotify (0.8.8)
+      ffi (>= 0.5.0)
+    redcarpet (2.2.2)
+    sass (3.2.3)
+    sassy-math (1.2)
+      compass (~> 0.11)
+    sinatra (1.3.3)
+      rack (~> 1.3, >= 1.3.6)
+      rack-protection (~> 1.2)
+      tilt (~> 1.3, >= 1.3.3)
+    sprockets (2.4.5)
+      hike (~> 1.2)
+      multi_json (~> 1.0)
+      rack (~> 1.0)
+      tilt (~> 1.1, != 1.3.0)
+    sprockets-sass (0.9.1)
+      sprockets (~> 2.0)
+      tilt (~> 1.1)
+    syntax (1.0.0)
+    thor (0.15.4)
+    tilt (1.3.3)
+    uglifier (1.2.7)
+      execjs (>= 0.3.0)
+      multi_json (~> 1.3)
+    url_mount (0.2.1)
+      rack
+    yajl-ruby (1.1.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  compass!
+  middleman (~> 3.0.7)
+  modular-scale (~> 1.0.2)
+  pygments.rb
+  rack-codehighlighter!
+  redcarpet
+  sass (~> 3.2.3)
+  susy!

data/docs/README.md

@@ -0,0 +1,54 @@
+# Susy Documenation
+
+Susy's documentation source is written with [Middleman](https://github.com/middleman/middleman) (3.x). For the actual documentation on using Susy, visit [Susy's web site](http://susy.oddbird.net/). For help learning Middleman and to contribute to the docs, [visit the Middleman web site](https://github.com/middleman/middleman).
+
+## Editing Susy's Docs
+
+Susy's docs are all marked up with (GitHub Flavored) [Markdown](http://daringfireball.net/projects/markdown/syntax), and templated with [HAML](http://haml-lang.com/).
+
+### Adding Content
+
+Add all content to the `/docs/source/guides/` directory. All files will take an .html.md extension, and are written with in [Markdown](http://daringfireball.net/projects/markdown/syntax):
+
+    /docs/source/guides/foobar.html.md
+    
+All page titles and sidebar content are handled with [YAML](http://yaml.org/) at the top of a specific page. If `title` and/or `side_content` are not defined, defaults will be provided.
+
+**Example:** (e.g. `/docs/source/guides/example.html.md`)
+
+    ---
+    title: I'm an awesome title
+    side_content: >
+      <p>Regular ol' HTML goes here</p>
+      <ul>
+        <li><a href="#">Include Subnav</a></li>
+      </ul>
+    ---
+
+    # Title
+    
+    And some content
+
+Note that the `>` in `side_content: >` is required to render HTML.
+    
+### Doc-wide Navigation
+
+To add a page to the doc-wide navigation, add it to `/docs/source/partials/_navigation.haml`.
+
+### Default URL for /guides/
+
+Edit `/docs/source/config.rb` to change the default landing page for `/docs/source/guides/`.
+
+### Indentation
+
+As all of Susy's docs use pre-processors that are whitespace-sensitive, please use 2 Soft Tabs for indentation.
+
+### Code Highlighting
+
+Susy's docs uses [Rack::Codehighlighter](https://github.com/wbzyl/rack-codehighlighter) (and [pygments.rb](https://github.com/tmm1/pygments.rb)) to automatically highlight Markdown code blocks. You just have to indicate the type in a code block:
+
+    :::scss
+    $total-columns  : 12;
+    $column-width   : 4em;
+    $gutter-width   : 1em;
+    $grid-padding   : $gutter-width;

data/docs/config.rb

@@ -0,0 +1,120 @@
+###
+# Helpers
+###
+
+set :markdown, :layout_engine => :haml
+set :markdown_engine, :redcarpet
+set :build_dir, "../../susy-pages/"
+
+require 'rack/codehighlighter'
+require "pygments"
+use Rack::Codehighlighter,
+  :pygments,
+  :element => "pre>code",
+  :pattern => /\A:::([-_+\w]+)\s*\n/,
+  :markdown => true
+
+require "lib/guide_helpers"
+helpers GuideHelpers
+
+###
+# Compass
+###
+
+# Susy grids in Compass
+# First: gem install compass-susy-plugin
+require 'modular-scale'
+
+# Change Compass configuration
+# compass_config do |config|
+#   config.output_style = :compact
+# end
+
+###
+# Haml
+###
+
+# CodeRay syntax highlighting in Haml
+# First: gem install haml-coderay
+# require 'haml-coderay'
+
+# CoffeeScript filters in Haml
+# First: gem install coffee-filter
+# require 'coffee-filter'
+
+# Automatic image dimensions on image_tag helper
+# activate :automatic_image_sizes
+
+###
+# Page command
+###
+
+# Per-page layout changes:
+#
+# With no layout
+# page "/path/to/file.html", :layout => false
+#
+# With alternative layout
+# page "/path/to/file.html", :layout => :otherlayout
+#
+# A path which all have the same layout
+# with_layout :admin do
+#   page "/admin/*"
+# end
+
+page "/demos/magic.html", :layout => "magic"
+page "/demos/grid-types.html", :layout => "grid-types"
+
+# Proxy (fake) files
+# page "/this-page-has-no-template.html", :proxy => "/template-file.html" do
+#   @which_fake_page = "Rendering a fake page with a variable"
+# end
+
+page "/guides/", :proxy => "/guides/getting-started.html"
+page "/tutorial/", :proxy => "/guides/getting-started.html"
+
+###
+# Helpers
+###
+
+# Directory Indexes //need to add to :build?
+activate :directory_indexes
+
+# Methods defined in the helpers block are available in templates
+# helpers do
+#   def some_helper
+#     "Helping"
+#   end
+# end
+
+# Change the CSS directory
+# set :css_dir, "alternative_css_directory"
+
+# Change the JS directory
+# set :js_dir, "alternative_js_directory"
+
+# Change the images directory
+# set :images_dir, "alternative_image_directory"
+
+# Build-specific configuration
+configure :build do
+  # For example, change the Compass output style for deployment
+  activate :minify_css
+
+  # Minify Javascript on build
+  activate :minify_javascript
+
+  # Enable cache buster
+  activate :cache_buster
+
+  # Use relative URLs
+  activate :relative_assets
+
+  # Compress PNGs after build
+  # First: gem install middleman-smusher
+  # require "middleman-smusher"
+  # activate :smusher
+
+  # Or use a different image path
+  # set :http_path, "/Content/images/"
+end