django-appypod allows to serve OpenDocument Text files (.odt) from templates and contexts, using Appy POD <appyframework.org>_ framework.

=======

INSTALL

::

pip install django-appypod

=====

USAGE

In settings, add OdtTemplates template backend before DjangoTemplates one :

::

TEMPLATES = [
    {
        'BACKEND': 'djappypod.backend.OdtTemplates',
    },
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        ...
    },
]

Using class-based generic views :

::

from django.view.generic.detail import DetailView

from djappypod.response import OdtTemplateResponse

class YourDocument(DetailView):
    response_class = OdtTemplateResponse
    template_name = "your/template.odt"

Using classic views functions :

::

def your_view(request):
    response = OdtTemplateResponse(request, "your/template.odt", {
        'title': 'Simple as hello ;)'
    })
    response.render()
    return response

Follow instructions in Appy POD documentation <http://appyframework.org/podWritingTemplates.html>_ for designing your OpenDocument templates.

=======

AUTHORS

* Mathieu Leplatre <mathieu.leplatre@makina-corpus.com>
* Gaël Utard <gael.utard@makina-corpus.com>
* Template loading based on Sébastien Fievet's presentation at DjangoCong 2011

|makinacom|_

.. |makinacom| image:: http://depot.makina-corpus.org/public/logo.gif .. _makinacom: http://www.makina-corpus.com

=======

LICENSE

* Lesser GNU Public License

=========

CHANGELOG

2.0.7 (2021-04-12)

• Use upstream appy (it supports now Python3)

2.0.6 (2020-11-24)

• Fix dependency to appy

2.0.5 (2020-11-24)

• Add python 3.8 support

2.0.4 (2019-12-26)

• Add Django 2.0 support

2.0.3 (2019-12-26)

• (No change)

2.0.2 (2019-11-25)

• Fix dependency to appy (use Python 3 version)

2.0.1 (2019-11-18)

• Fix setup.py

2.0.0 (2018-05-07)

• Move to Python 3

1.0.0 (2017-01-14)

• Upgrade to Django 1.8

0.0.2 (2013-10-08)

• Safety check before deleting document
• Add Django and Appy in dependencies

0.0.1 (2012-09-11)

• Initial working version.