kombinat.decogrid 0.3

A decogrid generator for plone columns.css file.

Contents

• What is it?

• Installation

• Guide

  • Example

• Changelog

  • 0.3 (2013-10-09)

  • 0.2 - 2012-07-09

  • 0.1.1 - 2011-05-26

  • 0.1 - 2011-04-07

What is it?

kombinat.decogrid is a css code generator for decogrid layouts. It generates css code similar to “columns.css” in plonetheme.sunburst. copy the generated css into your.product/skins/prod_styles/columns.css to override any other definitions.

Installation

Just add a decogrid part to your buildout:

[buildout]
parts =
    ...
    decogrid

[decogrid]
recipe = zc.recipe.egg
eggs = kombinat.decogrid

Guide

The autogenerated executable is located in your buildout bin/ directory. It allows you several options for generating decogrid css code, which can be directly pasted into your columns.css file:

~/buildout $ bin/decogrid_generatecss -h
usage: decogrid_generatecss [-h] [-c COLUMNS] [-m MARGIN] [-w WIDTH]
                            [-l LEVEL] [-t TAG] [-o]

decogrid_generatecss [options] decogrid_generatecss generate decogrid
columns.css for plone (http://deco.gs) Default values are written in brackets.

optional arguments:
  -h, --help            show this help message and exit
  -c COLUMNS, --columns COLUMNS
                        how many columns (16)
  -m MARGIN, --margin MARGIN
                        margin in pixels between each cell (10)
  -w WIDTH, --width WIDTH
                        portal width in pixels including potentially left
                        and/or right margins (960)
  -l LEVEL, --convenience-level LEVEL
                        max level of convenience classes to create (7)
  -t TAG, --tag TAG     html tag to be used for 'row', 'cell' and
                        'convenience' css classes (div)
  -o, --omit-margin     omit left and right margin around the portal
                        (recommended for nesting grids inside grids)

Example

This utility is very useful if you want to use nested grid layout because you can omit the margin which is given by default in plone’s columns.css.

Generate a new columns.css file by using:

~/buildout $ bin/decogrid_generatecss -o -w 950 -c 16 > columns.css

Changelog

0.3 (2013-10-09)

• Switch from optparse to argparse, so we need >= Python 2.7 now. [saily]

• Add more configurable parser, allow non-div tags, allow to strip tags by passing "" as argument for -t. [saily]

• Allow users to limit convenience classes by using --level parameter. default is still min(columns, 7). [saily]

0.2 - 2012-07-09

• fixed css lineendings

• removed double “position-0” declaration [petschki]

0.1.1 - 2011-05-26

• updated install documentation [petschki]

0.1 - 2011-04-07

• Idea and initial release [saily]