Metadata-Version: 1.0
Name: deform-bootstrap
Version: 0.1a3
Summary: Bootstrap 2 compatible templates for the deform form library
Home-page: http://pypi.python.org/pypi/deform_bootstrap
Author: Daniel Nouri and contributors
Author-email: pylons-discuss@googlegroups.com
License: BSD-derived (http://www.repoze.org/LICENSE.txt)
Description: ================
        deform_bootstrap
        ================
        
        ``deform_bootstrap`` provides `Bootstrap
        <http://twitter.github.com/bootstrap/>`_ compatible templates for the
        `deform form library <http://pypi.python.org/pypi/deform/0.9.3>`_.
        
        How to use it
        =============
        
        In your Paste Deploy configuration file (e.g. ``development.ini``) add
        ``deform_bootstrap`` to the list of ``pyramid_includes``, or add a
        this line if a ``pyramid.includes`` setting does not exist::
        
          [app:main]
          ...
          pyramid.includes = deform_bootstrap
        
        This will put the templates in ``deform_bootstrap/templates`` into the
        `deform search path
        <http://docs.pylonsproject.org/projects/deform/en/latest/templates.html>`_.
        
        Work in progress
        ================
        
        Work still needs to be done on individual widget templates.  Some
        widgets include markup with ``<ul>`` and ``<li>`` elements that don't
        work very well with Bootstrap.  Contributions the in form of markup
        changes and style corrections are most welcome.
        
        ``deform_bootstrap`` currently passes around 95% of the `deformdemo
        <http://deformdemo.repoze.org/>`_ tests.  (The remaining five percent
        are probably related to a setup issue with the the tests.)
        
        If you want to quickly try out ``deform_bootstrap`` and see how it
        looks in practice you can run these commands, assuming that you have a
        `virtualenv <http://pypi.python.org/pypi/virtualenv>`_ set up in your
        ``deform_bootstrap`` directory::
        
          $ git clone https://github.com/Pylons/deformdemo.git
          $ cd deformdemo
          $ ../bin/python setup.py develop
          $ cd ..
          $ bin/pserve demo.ini
        
        You should now be able to access the demo site at http://0.0.0.0:8521
        
        API
        ===
        
        input_prepend / input_append
        ----------------------------
        
        Bootstrap has a nice feature to prepend/append text to input[type=text]
        form elements (see http://twitter.github.com/bootstrap/#forms).
        To use it with ``deform_bootstrap`` you can simply pass ``input_prepend``
        or ``input_append`` as keyword arguments to the widget constructor in your
        ``colander.Schema`` subclass::
          
          class PersonSchema(colander.Schema):
              weight = colander.SchemaNode(
                  colander.Integer(),
                  title=u"Weight",
                  widget=deform.widget.TextInputWidget(
                      input_append="kg",
                      css_class="span1",
                  ))
        
        
        CHANGES
        =======
        
        0.1a3 - 2012-02-03
        ------------------
        
        - Changes to support Bootstrap 2.0.
        
        - Added support for Bootstrap's feature to prepend/append text to
          ``input[type=text]`` via input_prepend/input_append keyword
          arguments to ``deform.Widget`` constructor.
        
Keywords: twitter bootstrap deform styles css web forms form
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python
