Metadata-Version: 1.1
Name: django-jinja-knockout
Version: 0.1.2
Summary: Bootstrap / Jinja2 / Knockout.js integration into Django projects.
Home-page: https://github.com/Dmitri-Sintsov/django-jinja-knockout
Author: Dmitriy Sintsov
Author-email: questpc256@gmail.com
License: BSD
Description: =============================
        django-jinja-knockout
        =============================
        
        .. image:: https://badge.fury.io/py/django-jinja-knockout.png
            :target: https://badge.fury.io/py/django-jinja-knockout
        
        Bootstrap / Jinja2 / Knockout.js integration into Django projects.
        
        Overview
        --------
        
        Templating languages are my favorite topic in programming. I love compact and semantically organic way of HTML
        templating in Knockout.js, which uses html5 data-bind JSON-like attributes instead of semantically alien double braces,
        which conflict almost every server-side templating language out there (including Jinja2).
        
        When developing with Django, I felt a lack of very powerful server-side templating when used built-in DTL templates.
        So I switched to Jinja2, thank to Django 1.8+ built-in support of this templating engine and to great project
        https://github.com/niwinz/django-jinja
        which simplifies Jinja2 integration.
        
        So, basically in this project two great templating engines (client-side https://github.com/knockout/knockout and
        server-side https://github.com/mitsuhiko/jinja2) meet together. That allows to write complex dynamic HTML code with less
        effort, cleaner look and easily readable. Both also are very fast, Knockout.js templates being one of the fastest at
        client-side, while Jinja2 estimated to be faster few times than built-in DTL templates, and is more powerful.
        
        When thinking of Angluar.js, not only I dislike curly braces in templates but also I believe that using such large
        framework for non-SPA applications is an overkill. And Django primary usage are non-SPA classical Web applications,
        which aren't "outdated" in any way - because such applications are much better indexable by web crawlers and Python is
        better language than Javascript in general and server-side has less glitches than browsers.
        
        Most of client-side scripts included into this redistributable app are server-side agnostic and are not tied much to
        Django, except for client-side localization. In fact, most of that client-side code is also used in large Laravel
        project as well. They are included for developer's convenience. Also my personal feeling is, that Django itself lacks
        a bit heavier support of client-side Javascript out-of-box. Knockout.js would be great inclusion for ``empty_form``
        handling and in ``django.admin``, considering it's small size.
        
        However, some of server-side functionality, like AJAX form validation and viewmodels manipulation is either
        useless or will not work without these scripts.
        
        Obviously, only AJAX response parts and DOM manipulation (eg. Knockout.js processing of ``formset.empty_form``)
        are tied to bundled client-side scripts.
        
        Documentation
        -------------
        
        The full documentation is at https://django-jinja-knockout.readthedocs.org.
        
        Quick notes:
        
        .. Next links are github relative links. Do not process these via sphinx as it does not follow them correctly.
        .. _Credits: AUTHORS.rst
        .. _contribute: CONTRIBUTING.rst
        .. _History: HISTORY.rst
        .. _Installation: INSTALLATION.rst
        .. _Introduction: QUICKSTART.rst
        
        * Installation_
        * Introduction_
        * How to contribute_
        * History_
        * Credits_
        
        Cookiecutter Tools Used in Making This Package
        ----------------------------------------------
        
        *  cookiecutter
        *  cookiecutter-djangopackage
        
        
        
        
        History
        -------
        
        0.1.0
        +++++
        
        * To be released on PyPI.
        
Keywords: django-jinja-knockout
Platform: UNKNOWN
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 :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
