summaryrefslogtreecommitdiff
path: root/docs/index.rst
blob: 50e90c7c1c6a2d76a0edb2914c7454687892794d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
.. pyScss documentation master file, created by
   sphinx-quickstart2 on Thu Sep 19 18:03:51 2013.
   You can adapt this file completely to your liking, but it should at least
   contain the root `toctree` directive.

pyScss, a Sass compiler for Python
==================================

pyScss compiles Scss (Sass), a superset of CSS that is more powerful, elegant
and easier to maintain than plain-vanilla CSS. The library acts as a CSS source
code preprocesor which allows you to use variables, nested rules, mixins, and
have inheritance of rules, all with a CSS-compatible syntax which the
preprocessor then compiles to standard CSS.

Scss, as an extension of CSS, helps keep large stylesheets well-organized. It
borrows concepts and functionality from projects such as OOCSS and other similar
frameworks like as Sass. It's build on top of the original PHP xCSS codebase
structure but it's been completely rewritten, many bugs have been fixed and it
has been extensively extended to support almost the full range of Sass' Scss
syntax and functionality.

.. image:: http://pledgie.com/campaigns/16513.png?skin_name=chrome
   :alt: Click here to lend your support to pyScss and make a donation at pledgie.com!
   :target: http://pledgie.com/campaigns/16513


Contents:

.. toctree::
    :maxdepth: 2

    usage
    python-api
    syntax
    back-matter



Indices and tables
==================

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`