Skip to content

Use Compass Extensions

hlb edited this page Mar 12, 2012 · 1 revision

Use Compass Extensions

Previous: Preferences

We have put some Compass extensions into Compass.app:

  • Blueprint (builtin in Compass)
  • Compass (builtin in Compass)
  • 960 Grid Sytem
  • HTML5 Boilerplate

There are two ways to add more 3rd party extensions.

The Compass way

From Compass 0.11, extensions that are installed into ~/.compass/extensions will be automatically available to all your compass projects.

If you put extensions inside it, Compass.app will load it when the application starts.

Step by Step Guide

Mac:

  • Open "Terminal.app"

  • Create folder:

    mkdir -p ~/.compass/extensions

  • Open the folder in Finder:

    open ~/.compass/extensions

  • Download extensions on Github, unzip it, and throw it into the folder.

  • Restart Compass.app

Windows:

  • Open "Command Prompt"

  • Create folder:

    mkdir "%HOMEPATH%\.compass\extensions"

  • Open the folder in Explorer:

    c:\WINDOWS\explorer.exe "%HOMEPATH%\.compass\extensions"

  • Download extensions on Github, unzip it, and throw it into the folder.

  • Restart Compass.app

Linux:

  • Open "Terminal"

  • Create folder:

    mkdir -p ~/.compass/extensions

  • Open the folder in Nautilus:

    nautilus ~/.compass/extensions

  • Download extensions on Github, unzip it, and throw it into the folder.

  • Restart Compass.app

The Rubygems way

WARNING: It is for advanced users only.

You can choose "Compass Version: Custom" in preferences, and specify your own gem paths. Compass.app will try to load it. Since Compass.app uses JRuby, native gems will not work.

Next: Sass Mode