Metadata-Version: 1.1
Name: django-amp-tools
Version: 0.2.1
Summary: Accelerated mobile pages (AMP) in django.
Home-page: http://github.com/shtalinberg/django-amp-tools
Author: Oleksandr Shtalinberg
Author-email: O.Shtalinberg@gmail.com
License: MIT License
Description: ================
        django-amp-tools
        ================
        
        .. image:: https://travis-ci.org/shtalinberg/django-amp-tools.svg?branch=develop
            :target: https://travis-ci.org/shtalinberg/django-amp-tools
        
        .. image:: https://img.shields.io/pypi/v/django-amp-tools.svg
            :target:  https://pypi.python.org/pypi/django-amp-tools/
        
        .. image:: https://img.shields.io/pypi/pyversions/django-amp-tools.svg
        
        .. image:: https://img.shields.io/badge/django-1.11%20or%20newer-green.svg
        
        
        
        .. _introduction:
        
        **django-amp-tools** ( amp_tools ) provides a simple way to work with Accelerated mobile pages (AMP)
        in django and gives you tools at your hand to render some different templates
        to deliver an AMP version of your site to the user.
        
        The initial idea, which has guided the development of this application from django-mobile app,
        is to keep your views exactly the same but to transparently
        interchange the templates used to render a response.
        
        
        This is done in two steps:
        
        1. A middleware determines the client's preference to view your site. E.g. if
           he wants to use the AMP or the standart version.
        2. The template loader takes then care of choosing the correct templates based
           on the GET param detected in the middleware.
        
        
        Installation
        ============
        
        .. _installation:
        
        *Pre-Requirements:* ``django-amp-tools`` depends on django's sites framework. So
        before you try to use ``django-amp-tools`` make sure that the sites framework
        is enabled and working.
        
        1. Install ``django-amp-tools`` with your favourite python tool, e.g. with
           ``easy_install django-amp-tools`` or ``pip install django-amp-tools``.
        2. Add ``amp_tools`` to your ``INSTALLED_APPS`` setting in the
           ``settings.py``.
        3. Add ``amp_tools.middleware.AMPDetectionMiddleware`` to end of your
           ``MIDDLEWARE_CLASSES`` setting.
        4. Add ``amp_tools.loader.Loader`` as first item to your
           ``loaders`` list for ``TEMPLATES`` setting in ``settings.py``.
        
        
        Usage
        =====
        
        See docs/usage.rst
        
        
        **Documentation** is `available online
        <http://django-amp-tools.readthedocs.org/>`_, or in the doc
        directory of the project.
        
        The **source code** for this app is hosted at
        https://github.com/shtalinberg/django-amp-tools.
        
        Pull requests are welcome. See
        <http://django-amp-tools.readthedocs.io/en/latest/contributing.html>`_.
        
Keywords: django AMP accelerated
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.6
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
