Gears
=====

Gears is a library to compile, concatenate and minify JavaScript and CSS
assets, highly inspired by Ruby's Sprockets_. You can also write scripts,
styles and client templates using CoffeeScript_, Handlebars_, Stylus_, Less_,
and compile them using external packages (gears-coffeescript_,
gears-handlebars_, gears-stylus_, gears-less_). These packages already include
all required node.js modules, so you don't need to worry about installing them
yourself.

There is also:

- django-gears_, an app for Django that integrates Gears with Django project;
- Flask-Gears_, an extension that integrates Gears with Flask application;
- gears-cli_, a command-line utility that compiles assets. It also can watch
  assets for changes and automaticaly re-compile them.

Source Code
-----------

Gears code is hosted on GitHub: https://github.com/gears/gears.

Contents
--------

.. toctree::
   :maxdepth: 2

   about
   installation
   api
   changelog


.. _Sprockets: http://getsprockets.org
.. _CoffeeScript: http://jashkenas.github.com/coffee-script/
.. _Handlebars: http://www.handlebarsjs.com/
.. _Stylus: http://learnboost.github.com/stylus/
.. _Less: http://lesscss.org/

.. _gears-less: https://github.com/gears/gears-less
.. _gears-stylus: https://github.com/gears/gears-stylus
.. _gears-handlebars: https://github.com/gears/gears-handlebars
.. _gears-coffeescript: https://github.com/gears/gears-coffeescript

.. _django-gears: https://github.com/gears/django-gears
.. _flask-gears: https://github.com/gears/flask-gears
.. _gears-cli: https://github.com/gears/gears-cli