Metadata-Version: 1.1
Name: kombinat.decogrid
Version: 0.3
Summary: A decogrid generator for plone columns.css file.
Home-page: http://svn.plone.org/svn/collective/kombinat.decogrid/trunk
Author: Daniel Widerin
Author-email: daniel.widerin@kombinat.at
License: GPL
Description: .. contents::
        
        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
        
        
        .. _`plonetheme.sunburst`: https://github.com/plone/plonetheme.sunburst/blob/master/plonetheme/sunburst/skins/sunburst_styles/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]
        
Keywords: decogrid
Platform: UNKNOWN
Classifier: Framework :: Plone
Classifier: Environment :: Console
Classifier: Programming Language :: Python
