stylesheets/stipe/grid/readme.md in stipe-0.0.5.7.7 vs stylesheets/stipe/grid/readme.md in stipe-0.0.5.7.8
- old
+ new
@@ -1,29 +1,64 @@
-#Stipe's grid solution
-While there are a number of other really awesome grid solutions out there, I always find myself customizing their code to meet my personal needs. You will see these needs described in the supported arguments below.
+#Grids
+Stipe's grid system is based on the original 960.gs solution. Whereas there are concepts like columns, gutters and nesting.
-##Grid use definition
-To use grids in Toadstool, Stipe comes with some awesome Mixins for easy creation of custom grids as well as commonly used silent classes.
-Stipe's grid system is based on the original 960.gs solution. Whereas there are concepts like columns, gutters and nesting. For the most part when framing a UI, simply extend already pre-defned [silent classes](http://goo.gl/W0QlA) like `@extend %grid_4`. These pre-formatted silent classes already come with additional support for mobile devices.
+##Placeholder classes
+For the most part when framing a UI, simply extend already pre-defned placeholder classes like `@extend %grid_4of12`, for example. Stipe's placeholder classes come with support for tablet and mobile devices.
-If you require more customization of a given grid, use `@include grid($col_count)` whareas you are replacing `$col_count` with the number of colums you need.
+For example, using the following Sass
-For nested grids, Stipe supports 'alpha' and 'omega' concepts. For added spice, if you want to remove both margins, 'alphaomega' works too. Example `@include grid(5, alpha)`.
+```sass
+.grid-block {
+ @extend %grid_4of12;
+ @media #{$mobile} {
+ @extend %grid_4of4;
+ }
+}
-Since Stipe's grid is pure math, you can pass in floating point numbers as well. Example, if using `@include grid(12, alphaomega)` this will remove the margin on the outside of the grid, but will not be 100% across. By adding a floating point `@include grid(12.25, alphaomega)` this will address the missing space.
+.left-nav {
+ @extend %grid_4of12;
+ @media #{$mobile} {
+ @extend %grid_4of4;
+ }
+}
+```
+You will get the following CSS
+
+```css
+.grid-block, .left-nav {
+ float: left;
+ margin-left: 1.04167%;
+ margin-right: 1.04167%;
+ width: 31.25%;
+}
+
+@media screen and (max-width: 40em) {
+ .grid-block, .left-nav {
+ float: left;
+ margin-left: 3.125%;
+ margin-right: 3.125%;
+ width: 93.75%;
+ }
+}
+```
+
+##Building custom grid widths and nesting
+If you require more customization of a given grid, use Stipe's grid mixin `@include grid($col_count)`. Whereas you are replacing `$col_count` with the number of columns you need.
+
+When nesting grids, since Stipe uses percentages, you need to make sure to reset your context.
+
##Grid arguments
Additional arguments can be passed into the grid mixin to include `$grid_padding_l` `$grid_padding_r` `$grid_padding_tb` `$grid_border` `$border_place` `$grid_uom` `$col_gutter` `$grid_type` `$grid_align` `$grid_context`
-* `$grid_padding_l` => adds padding LEFT, takes intager value
-* `$grid_padding_r` => adds padding RIGHT, takes intager value
-* `$grid_padding_tb` => adds padding TOP and BOTTOM, takes intager value
+* `$grid_padding_l` => adds padding LEFT, takes integer value
+* `$grid_padding_r` => adds padding RIGHT, takes integer value
+* `$grid_padding_tb` => adds padding TOP and BOTTOM, takes integer value
* `$grid_border` => takes integer value, adds border using `$border_color` and `$standard_border_style` configs found in `_config.scss`.
* `$border_place` => arguments are `left` and `right`. Argument will place a single border on either the left or right side of the block.
* `$grid_uom` => set to percent by default, accepts `em` as argument.
* `$col_gutter` => takes integer to adjust col gutter
-* `$grid_type` => set to 12 col by default, allows for on-the-fly adjustment to grid type <b>Feature us currently inoperable</b>
* `$grid_align` => takes `center` as argument
-* `$grid_context` => Adjusts column widths based on nested grid context. Necessary when calcuclating with percentages
+* `$grid_context` => Adjusts column widths based on nested grid context. Necessary when calculating with percentages
Stipe uses the `box-size` CSS property, but this is not supported by IE7. By entereing values like `$grid_padding_l, $grid_padding_r, $grid_border`, Stipe will calculate a width that IE7 can use.
\ No newline at end of file