https://github.com/jaumefontal/SASS-Build-SublimeText2

SASS build sytem for Sublime Text 2
https://github.com/jaumefontal/SASS-Build-SublimeText2

Last synced: 15 days ago
JSON representation

SASS build sytem for Sublime Text 2

• Host: GitHub
• URL: https://github.com/jaumefontal/SASS-Build-SublimeText2
• Owner: jaumefontal
• Created: 2012-08-05T21:29:39.000Z (over 12 years ago)
• Default Branch: master
• Last Pushed: 2016-09-24T09:03:44.000Z (about 8 years ago)
• Last Synced: 2024-08-01T05:23:02.263Z (3 months ago)
• Language: JavaScript
• Size: 187 KB
• Stars: 135
• Watchers: 6
• Forks: 34
• Open Issues: 21
• Metadata Files:
  • Readme: readme.md

Awesome Lists containing this project

README

        
SASS build system for Sublime Text 2

====================================

**Note: I'm working in a portable version of the SASS build with all the libraries included & ready to use. It will be available (I hope!) the next week.**

Description

-----------

Provides two Build system for SASS files (with and without compression)

Prerequisites

-------------

Requires **Ruby** & **SASS** libraries.

Step by step:

1. Install Ruby library

	**Windows**: Download and install Ruby. You can find it here:

	http://rubyinstaller.org/downloads/

	Reboot after install it.

	**IMPORTANT**: Don't forget to mark the option '*Add Ruby executables to your PATH*'.

	If you don't check the option, you will have to modify the path in the Build file afterwards.

	**OS X & Linux**: It's already installed. Easy! :)

2. Installing SASS

	Open your console ('*Command prompt with Ruby*' on Windows) and execute the following command:

	`gem install sass`

Installing

----------

**OPTION 1 - With the Package Control plugin (recommended)**

The easiest way to install this package is through Package Control.

1. Download and install the [Package Control Plugin](http://wbond.net/sublime_packages/package_control).

Follow the instructions on the website.

2. Open the command panel: `Control+Shift+P` (Linux/Windows) or `Command+Shift+P` (OS X) and select '**Package Control: Install Package**'.

3. When the packages list appears type '**SASS**' and you'll find the **SASS Build System**. Select to install it.

4. Now you can compile your SASS files! Launch your build with `Control+B` (Linux/Windows) or `Command+B` (OS X).

5. Enjoy your coding =)

**OPTION 2 - With Git**

Clone the repository in your Sublime Text "Packages" directory:

    git clone git://https://github.com/jaumefontal/SASS-Build-SublimeText2.git SASS-build

You can find your 'Packages' inside the following directories:

* OS X:

    `~/Library/Application Support/Sublime Text 2/Packages/`

* Windows:

    `%APPDATA%/Sublime Text 2/Packages/`

* Linux:

    `~/.Sublime Text 2/Packages/`

**OPTION 3 - Without Git**

Download the latest source zip from [Github](https://github.com/jaumefontal/SASS-Build-SublimeText2) and extract it into a new folder named `SASS-Build` in your Sublime Text "Packages" folder.

Using the build

---------------

After installing the package you will find two new options in `Tools > Build system` of your  Sublime menu: **SASS** and **SASS - Compressed**.

By default your `.scss` and `.sass` files will be built using the **SASS build** (not compressed).

And remember, always you can launch the selected build with `Control+B` (Linux/Windows) or `Command+B` (OS X).

Recommendations

---------------

* Is recommended to use this build with one of the next plugins: [SASS plugin](https://github.com/nathos/sass-textmate-bundle) or [SCSS.tmbundle](https://github.com/kuroir/SCSS.tmbundle).

* Also, I recommend the plugin [SublimeOnSaveBuild](https://github.com/alexnj/SublimeOnSaveBuild). Just save your SASS files and transform them into CSS!

* If you want to change the default folder of your generated CSS files into another one, you can edit the build:

  **Example:** Save your CSS files into a `css` folder:

  `"cmd": ["sass", "--update", "$file:${file_path}/../css/${file_base_name}.css"],`

Author

------

Created by **Jaume Fontal** ([@jaumefontal](http://www.twitter.com/jaumefontal)).

If you need more info you can find me on Twitter!

Acknowledgments

----------------

Thanks to the collaboration of [@hdennison](http://www.twitter.com/hdennison) with the testing in MacOS.