Installation and Configuration

Once installed, you need to add it to your INSTALLED_APPS. You can do that
however you like or you can copy-and-paste this in after your INSTALLED_APPS
are defined.

INSTALLED_APPS += ['tt_sass', ]

tt_sass relies on django-staticfiles in order to work. You must run
the collectstatic command inside your project like this:

python manage.py collectstatic --link

Remember, you must re-run this command any time you add new staticfiles.

Now you’re ready to start using tt_sass.

Usage

You can use this inside your Sass by adding the following:

@import "tt_sass/texastribune"

Once you’ve done that, you need to compile your Sass. Assuming you’re using the
default Texas Tribune setup of having a static directory at your project root,
you should run the following:

sass --load-path=static/ --watch --poll --compass static

This command setups up the path correctly for all of your code and watches the
file for changes.

Using the Grid

The grid is based off of Chris Coyer’ssimple grid. The syntax has been
changed around a little bit and it’s been mixinified, but the concept is the
same.

To create a grid, similar to a row in frameworks like Foundation and Bootstrap,
you use the .grid class. Inside a grid, you add cells and tell them how far
to span. For example, you do this to create a grid with 12 columns (the
default) and two cells, one of 8 columns and one of 4 columns:

Various Helpers

TODO

Examples

All of these are being documented in the example/ Django project. See that
directory for instructions on how to run that project.

Contributing

This project is released in hopes that it helps people understand how you might
build your own Sass framework for use in the context of a Django project. As
such, contributions from those outside the Texas Tribune probably won’t be
accepted.