Skip to content
This repository


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

An updated version Armin Ronacher's CleverCSS 0.1 that includes several bug fixes.

tree: 82f9fd0beb

Fetching latest commit…


Cannot retrieve the latest commit at this time

Octocat-spinner-32 bin
Octocat-spinner-32 clevercss
Octocat-spinner-32 tests
Octocat-spinner-32 .gitignore
Octocat-spinner-32 BUGFIXES
Octocat-spinner-32 README.rst
Octocat-spinner-32 eigen.css
Octocat-spinner-32 sprites_format.txt


CleverCSS is a small markup language for CSS inspired by Python that can be used to build a style sheet in a clean and structured way. In many ways it's cleaner and more powerful than CSS2 is.

The most obvious difference to CSS is the syntax: it is indentation based and not flat. While this is obviously against the Python Zen, it's nonetheless a good idea for structural styles.

New Syntax Additions



This works like normal css @imports, but expects a ccss file, which is then parsed, allowing cross-sheet variables

Backstrings (literal CSS)


Sometimes CleverCSS is a bit too clever for its own good and you just want to pass something directly to CSS. For instance, functions that aren't rgb() or url() need to be escaped. Added is a simple new backtick-surrounded string format that will be passed verbatim without further processing. Example:

    background: `-moz-linear-gradient(...)`



Commonly in CSS, you'll have an image of all your UI elements, and then use background positioning to extract a part of that image. CleverCSS helps you with this, via the spritemap(fn) call. For example:

ui = spritemap('ui.sprites')
some_button = $ui.sprite('some_button.png')
other_button = $ui.sprite('other_button.png')

    background: $some_button

    background: $other_button
    width: $other_button.width()
    height: $other_button.height()


There is currently only partial mixin support -- arguments are not yet implemented. But they will be...sometime soon. Anyway, the syntax for a macro is [currently] pretty pythonic:

def macro:
  color: red
  border-width: 5px - 1px


This syntax may change, though, b/c conceivably "def macro:blah" could refer to the CSS "def macro { blah }", so there is some inconsistent magic going in.


To get an idea of how CleverCSS works you can see a small example below. Note the indentation based syntax and how you can nest rules:

ul#comments, ol#comments:
  margin: 0
  padding: 0

    padding: 0.4em
    margin: 0.8em 0 0.8em

      font-size: 1.2em
      padding: 0.3em
      text-align: right
      color: #ddd

Of course you can do the very same in CSS, but because of its flat nature the code would look more verbose. The following piece of code is the CleverCSS output of the above file:

ol#comments {
  margin: 0;
  padding: 0;

ul#comments li,
ol#comments li {
  padding: 0.4em;
  margin: 0.8em 0 0.8em;

ul#comments li h3,
ol#comments li h3 {
  font-size: 1.2em;

ul#comments li p,
ol#comments li p {
  padding: 0.3em;

ul#comments li p.meta,
ol#comments li p.meta {
  text-align: right;
  color: #dddddd;

But that's only a small example of what you can do with CleverCSS. Have a look at the following documentation of CleverCSS for more details.

Something went wrong with that request. Please try again.