django-propeller 1.5.0

Propeller for Django
====================

Write Django as usual, and let ``django-propeller`` make template output into code based on Google's Material Design Standards & Bootstrap.


[](https://travis-ci.org/tfroehlich82/django-propeller)
[](https://coveralls.io/github/tfroehlich82/django-propeller?branch=stable)
[](https://landscape.io/github/tfroehlich82/django-propeller/stable)
[](https://pyup.io/repos/github/tfroehlich82/django-propeller/)
[](https://pyup.io/repos/github/tfroehlich82/django-propeller/)


Requirements
------------

- Python 2.7, 3.3, 3.4, 3.5, or 3.6
- Django >= 1.9


Installation
------------

1. Install using pip:
```
pip install django-propeller
```

2. Add to INSTALLED_APPS in your ``settings.py``:

```
'django_propeller',
```

3. In your templates, load the ``django_propeller`` library and use the ``propeller_*`` tags:



Example template
----------------

```
{% load propeller %}

{# Display a form #}

<form action="/url/to/submit/" method="post" class="form">
{% csrf_token %}
{% propeller_form form %}
{% buttons %}
<button type="submit" class="btn btn-primary">
{% propeller_icon "star" %} Submit
</button>
{% endbuttons %}
</form>
```


Documentation
-------------

The full documentation is at http://django-propeller.readthedocs.io/en/stable/


Demo application
----------------

The demo application provides a number of useful examples.

clone the repo:

$ git clone https://github.com/tfroehlich82/django-propeller.git

cd into the cloned directory:

$ cd django-propeller

run the testserver:

$ python manage.py runserver

open your browser and browse to:

http://127.0.0.1:8000


Bugs and suggestions
--------------------

If you have found a bug or if you have a request for additional functionality, please use the issue tracker on GitHub.

https://github.com/tfroehlich82/django-propeller/issues


Further Information
-------------------

Propeller: http://propeller.in/

Bootstrap: http://getbootstrap.com/

Google Material Design: https://material.io/


Donation
--------

[](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=ARFDZCBQTWRSQ)


[BTC Donation] 35bfZEE6NknfBVnEd86XZpGgqKeVjmXQxn

[ETH Donation] 0xc9eb5eaed97c94cd47def84fd23a9802fa40384b

[LTC Donation] LW4cbjTYCYuymdCBQRzgkRWMGfLBaG5g4C


License
-------

You can use this under MIT License. See [LICENSE](LICENSE) file for details.


Author
------

Developed and maintained by [Thorsten Fröhlich](https://github.com/tfroehlich82),
based on the idea of [django-bootstrap3](https://github.com/dyve/django-bootstrap3) from [Dylan Verheul](https://github.com/dyve).