sass-site/source/index.html.haml

---
title: Sass | Syntactically Awesome Style Sheets
---

:markdown
  # CSS with super powers

  Sass makes writing CSS fun again. Think of Sass as an extension of CSS3 that adds many missing features like nesting, variables, mixins & extend.

  ## There are a couple of ways to start using Sass:

%ol.get-started
  %li.command-line
    .get-started-content
      %h3 Command Line
      %p.illustration
        %span.circle= image_tag "illustrations/command-line.png", :width => "48", :height => "48", :alt => "CLI Illustration"
      / Description for Unix users
      %p.description
        Using Sass on the command line is as simple as using a few commands. To install Sass just type the following into the command line:
    .call-to-action
      / We'll try and point the user to either
      %pre
        %code gem install sass
      %p
        = link_to "Command Line Guide", '/get-started/command-line#unix', :class => 'button'

      %p For Windows users, go check out the <a href="/get-started/command-line#windows">Sass for Windows Guide</a>.

  %li.gui-application
    .get-started-content
      %h3 GUI Application
      %p.illustration
        %span.circle= image_tag "illustrations/gui.png", :width => "48", :height => "48", :alt => "GUI Illustration"
      %p.description Get started quickly by installing Sass for Linux, Mac or&nbsp;Windows.
    .call-to-action
      %p= link_to "GUI Guide", "/get-started/gui", :class => "button"
      %p= link_to "Download Compass.app", "#", :class => 'button'



- content_for :section_2 do
  .message.current-release
    .container
      %dl
        %dt Current Release:
        %dd Media Mark (3.2.1)
      :markdown
        * [Release Notes](#)
        * [Fork Sass on Github](#)

  .container
    .content
      %h1 Sass Features

      %nav.slide-navigation
        :markdown
          * [Preprocessing](#1)
          * [Variables](#2)
          * [Nesting](#3)
          * [Partials](#4)
          * [Import](#5)
          * [Mixins](#6)
          * [Inheritance](#7)
          * [Operators](#8)

      %ul.slides
        %li
          :markdown
            ## Pre-processing

            CSS on its own can be fun, but stylesheets are getting larger, more complex, and harder to maintain. This is where a preprocessor can help. Sass lets you use features that don't exist in CSS yet like variables, nesting, mixins, inheritance and other nifty goodies that make writing CSS fun again.

            Once you start tinkering with Sass, it will take your preprocessed Sass file and save it out as a normal CSS file that you can use in your web&nbsp;site.

        %li
          :markdown
            ## Variables

            Think of variables as a way to store information that you want to reuse throughout your stylesheet. You can store things like colors, font stacks, or any CSS value you think you'll want to reuse. Sass uses the <code>$</code> symbol to make something a variable. Here's an example:

          = partial "code-snippets/homepage-variables-scss"

          :markdown
            When the Sass is processed, it takes the variables we define for the <code>$font-stack</code> and <code>$primary-color</code> and outputs normal CSS with our variable values placed in the CSS. This can be extremely powerful when working with brand colors and keeping them consistent throughout the&nbsp;site.

          = partial "code-snippets/homepage-variables-css"

        %li
          :markdown
            ## Nesting

            When you write HTML you've probably noticed that it has a fairly clear nested, visual hierarchy. CSS, on the other hand, isn't. Sass will let you nest your CSS selectors in a way that follows the same visual hierarchy of your HTML. Here's an example of some typical styles for a sites&nbsp;navigation:

          = partial "code-snippets/homepage-nesting-scss"

          :markdown
            You'll notice that the <code>ul</code>, <code>li</code>, and <code>a</code> selectors are nested inside the <code>nav</code> selector. This is a great way to organize your CSS and make it more readable. When you generate the CSS you'll get something like&nbsp;this:

          = partial "code-snippets/homepage-nesting-css"

        %li
          :markdown
            ## Partials

            You can create partial Sass files that contain little snippets of CSS that you can include in other Sass files. This is a great way to modularize your CSS & help keep things easier to maintain. A partial is simply a Sass file named with a leading underscore. You might name it something like <code>_partial.scss</code>. The underscore lets Sass know that the file is only a partial file and that it should be generated into a CSS file. Sass partials are used with the <code>@import</code> directive.

        %li
          :markdown
            ## Import

            CSS has an import option that lets you split your CSS in to smaller, more maintainable portions. The only drawback is that each time you use <code>@import</code> in CSS it creates another HTTP request. Sass builds on top of the current CSS <code>@import</code> but instead of requiring an HTTP request, Sass will take the file that you want to import and combine it with the file your importing into so you can serve a single CSS file to the web browser.

            Let's say you have a couple of Sass files, <code>_reset.scss</code> and <code>base.scss</code>. We want to import <code>_reset.scss</code> into <code>base.scss</code>.

          = partial "code-snippets/homepage-import-1-scss"
          = partial "code-snippets/homepage-import-2-scss"

          :markdown

            Notice we're using <code>@import 'reset';</code> in the <code>base.scss</code> file. When you import a file you don't need to include the file extension <code>.scss</code> Sass is smart and will figure it out for you. When you generate the CSS you'll&nbsp;get:

          = partial "code-snippets/homepage-import-css"

        %li
          :markdown
            ## Mixins

            Some things in CSS are a bit tedious to write, especially with CSS3 and the many vendor prefixes that exist. A mixin lets you make groups of CSS declarations that you want to reuse throughout your site. You can even pass in values to make your mixin more flexible. A good use of a mixin is for vendor prefixes. Here's an example for <code>border-radius</code>.

          = partial "code-snippets/homepage-mixins-scss"

          :markdown
            To create a mixin you use the <code>@mixin</code> directive and giving it a name. We've named our mixin <code>border-radius</code>. We're also using the variable <code>$radius</code> inside the parenthesis so we can pass in a radius of whatever we want. After you create your mixin, you can then use it as a CSS declaration starting with <code>@include</code> followed by the name of the mixin. When your CSS is generated it'll look like this:

          = partial "code-snippets/homepage-mixins-css"

        %li
          :markdown
            ## Extend/Inheritance

            This is one of the most useful features of Sass. Using <code>@extend</code> lets you share a set of CSS properties from one selector to another. It helps keep your Sass very DRY. In our example we're going to create a simple series of messaging for errors, warnings and successes.

          = partial "code-snippets/homepage-extend-scss"

          :markdown
            What the above code does is allow you to take the CSS properties in <code>.message</code> and apply them to <code>.success</code>, <code>.error</code>, & <code>.warning</code>. The magic happens with the generated CSS, and this helps you avoid having to write multiple class names on HTML elements. This is what it looks&nbsp;like:

          = partial "code-snippets/homepage-extend-css"

        %li
          :markdown
            ## Operators

            Doing math in your CSS is very helpful. Sass has a handful of standard math operators like `+`, `-`, `*`, `/`, and `%`. In our example we're going to do some simple math to calculate widths for an `aside` & `article`.

          = partial "code-snippets/homepage-operators-scss"

          :markdown
            We've created a very simple fluid grid, based on 960px. Operations in Sass let us do something like take pixel values and convert them to percentages without much hassle. The generated CSS will look like:

          = partial "code-snippets/homepage-operators-css"


      %ul.pagination
        %li= link_to "Prev", "#", :class => "prev"
        %li= link_to "Next", "#", :class => "next"