Metadata-Version: 1.1
Name: towel-foundation
Version: 0.1.2
Summary: Keeping you DRY since 2013
Home-page: http://github.com/matthiask/towel-foundation/
Author: Matthias Kestenholz
Author-email: mk@feinheit.ch
License: BSD License
Description: ========================================================================
        ``towel_foundation`` -- making it easy to use Towel with Zurb Foundation
        ========================================================================
        
        .. note::
        
            You have to add ``towel_foundation`` to ``INSTALLED_APPS``, preferably
            before ``django.contrib.admin`` because otherwise the foundationified
            login, logout and password templates will not be picked up.
        
        
        Included goodies
        ================
        
        Base templates
        --------------
        
        * ``base.html``:
        
          Base template for everything. CSS is at the top, Javascript at the bottom.
          Defines two Javascript arrays you might want to be aware of:
        
          * ``onReady``: A list of functions which will be run on
            ``$(document).ready()``. Receive the jQuery instance as first and only
            argument.
        
          * ``onForm``: A list of functions which initialize forms. Might be called
            several times on the same set of elements. Receive two arguments, a
            jQuery object wrapping either ``document`` or some subset of the DOM
            and the jQuery instance.
        
        * ``towel/modal.html``:
        
          Template for AJAX-loaded modals.
        
        The following blocks are available by default:
        
        * ``title``: Browser title
        * ``css``: CSS declaration.
        * ``body``: Everything inside ``<body/>`` except for ``templates`` and ``js``.
        * ``navigation``: The content of the navbar.
        * ``main``: The main container, that is, everything except for the navigation
          and the footer.
        * ``search``: A search form embedded in the sidebar.
        * ``sidebar``: The sidebar itself.
        * ``messages``: A messages container above the page header and the content.
        * ``page-header``: The page header, most useful when there is a
          ``<div class="page-header"/>`` inside.
        * ``content``: Content.
        * ``footer``: The footer.
        * ``templates``: May be used for Javascript templates, meaning mainly for
          ``<script type="text/template"/>`` tags.
        * ``js``: All Javascript files and code.
        
        
        ModelView templates
        -------------------
        
        ``towel_foundation`` comes with a selection of templates most useful with
        ModelView. Have a look at the files in
        ``towel_foundation/templates/modelview/``.
        
        
        Towel templates
        ---------------
        
        ``towel_foundation`` overrides the styles of form items, form errors and
        warnings, of ordering links in the list pages and of the pagination.
        
        
        Templates for ``django.contrib.auth``
        -------------------------------------
        
        Log in, log out, password change and reset templates are included as well.
        
        
        Template tags
        -------------
        
        Contains a template tag most useful for marking the current navigation entry.
        Use as follows::
        
            {% load mark_current %}
            {% mark_current request.path %}
                <li><a href="..."></a></li>
                <li><a href="..."></a></li>
                <li><a href="..."></a></li>
            {% endmark_current %}
        
        Each navigation entry should occupy one line; adds a ``class="active"`` where
        the current URL begins with the ``href`` attribute value.
        
        
        Javascript helpers
        ------------------
        
        * ``onReady`` and ``onForm`` have already been described above.
        * ``$.fn.flash``: Changes a set of elements to be partially translucent before
          fading them in to complete opacity again.
        * ``$.fn.autogrow``: When applied to a textarea, causes the textarea to
          automatically expand in height when new content is added so that no scrollbar
          appears. Is applied by default to all elements matching
          ``textarea.autogrow``.
        * ``initForms([elem])``: Runs all handlers in ``onForm``. Defaults to handling
          everything inside ``document`` if no object is passed.
        * ``modalLoad(url)``: Loads a foundation modal from a remote URL. This is
          automatically activated for all elements matching
          ``a[data-toggle=ajaxmodal]``.
        * All AJAX requests are patched to work with Django's CSRF protection.
        
        
        Third-party libraries
        ---------------------
        
        * `jQuery <http://jquery.com>`_.
        * `Harvest chosen <http://harvesthq.github.com/chosen/>`_.
        
Platform: OS Independent
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
