Metadata-Version: 2.0
Name: Flask-Pure
Version: 0.4
Summary: Flask-Pure - a Flask extension for Pure.css
Home-page: https://github.com/pyx/flask-pure/
Author: Philip Xu and contributors
Author-email: pyx@xrefactor.com
License: BSD-New
Platform: any
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
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.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Dist: Flask (>=0.10)
Provides-Extra: test
Requires-Dist: pytest (>=2.8.2); extra == 'test'

===========================================
Flask-Pure - a Flask extension for Pure.css
===========================================

Flask-Pure is an extension to `Flask`_ that helps integrate `Pure.css`_ to your
Flask application.


.. _Flask: http://flask.pocoo.org/
.. _Pure.css: http://purecss.io/


Quick Start
===========


0. Installation

  .. code-block:: sh

    pip install Flask-Pure


1. Configuration

  .. code-block:: python

    from flask import Flask, render_template
    from flask_pure import Pure

    app = Flask(__name__)
    app.config['PURECSS_RESPONSIVE_GRIDS'] = True
    app.config['PURECSS_USE_CDN'] = True
    app.config['PURECSS_USE_MINIFIED'] = True
    Pure(app)

    @app.route('/')
    def hello():
        return render_template('hello.html')

    if __name__ == '__main__':
        app.run(debug=True)


2. In :code:`templates/hello.html`:

  .. code-block:: jinja

    {% extends "pure/layout.html" %}
    {% block title %}Hello world from flask-pure{% endblock %}

    {% block nav %}
    <div class="pure-menu pure-menu-horizontal">
      <!-- ... -->
    </div>
    {% endblock %}

    {% block content %}
      <h1>Hello world</h1>
    {% endblock %}


3. Profit!


How It Works
============

Once registered, this extension provides a template variable called
:code:`pure`, it has a property named :code:`css` that will be rendered
as HTML :code:`<link>` tag to the Pure.css stylesheets either from free CDN or
be served from a bundled blueprint, also called :code:`pure`.

A :code:`{{ pure.css }}` inside :code:`<head>` tag is all you need.

A bare bone HTML5 template is also available as :code:`pure/layout.html`.
Please check out the example in code repository and documentation for details.


License
=======

BSD New, see LICENSE for details.


Links
=====

- `Documentation <http://flask-pure.readthedocs.org/>`_

- `Issue Tracker <https://github.com/pyx/flask-pure/issues/>`_

- `Source Package @ PyPI <https://pypi.python.org/pypi/Flask-Pure/>`_

- `Mercurial Repository @ bitbucket
  <https://bitbucket.org/pyx/flask-pure/>`_

- `Git Repository @ Github
  <https://github.com/pyx/flask-pure/>`_

- `Git Repository @ Gitlab
  <https://gitlab.com/pyx/flask-pure/>`_

- `Development Version
  <http://github.com/pyx/flask-pure/zipball/master#egg=Flask-Pure-dev>`_


