Metadata-Version: 2.0
Name: templateddocs
Version: 0.3.3
Summary: Generate PDF, MS Word and Excel documents from templates in Django.
Home-page: https://github.com/kiawin/templated-docs
Author: Sian Lerk Lau
Author-email: kiawin@gmail.com
License: MIT license
Keywords: templateddocs
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
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 :: 3.6
Classifier: Programming Language :: Python :: 3.7
Requires-Dist: django (<1.12,>=1.8)
Requires-Dist: pylokit (==0.8.1)

===============================
Templated-docs
===============================


.. image:: https://badge.fury.io/py/templated-docs.svg
        :target: https://pypi.python.org/pypi/templateddocs

.. image:: https://img.shields.io/travis/kiawin/templated-docs.svg
        :target: https://travis-ci.org/kiawin/templated-docs

.. image:: https://readthedocs.org/projects/templated-docs/badge/?version=latest
        :target: https://templated-docs.readthedocs.io/en/latest/?badge=latest
        :alt: Documentation Status


Generate templated documents within Django in any format supported by
LibreOffice: texts, spreadsheets, presentations etc.


* Free software: MIT license
* Documentation: https://templated-docs.readthedocs.io.


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

* Python 2.7 or 3.4+
* Django >= 1.8
* A recent LibreOffice version (>=4.3.0) supporting LibreOfficeKit API.

Example usage
-------------

Create a ``sample.odt`` document (make sure it's in OpenDocument format) and
put it in your Django templates folder. It should look something like this:

.. image:: https://github.com/kiawin/templated-docs/raw/master/docs/document-template.png

Then write a view to generate documents from this template:

    .. code-block:: python

        from templated_docs import fill_template
        from templated_docs.http import FileResponse

        def get_document(request):
            """
            A view to get a document filled with context variables.
            """
            context = {'user': request.user}  # Just an example

            filename = fill_template('sample.odt', context, output_format='pdf')
            visible_filename = 'greeting.pdf'

            return FileResponse(filename, visible_filename)

Navigate to the url your view is connected to, and you'll see a rendered and converted document:

.. image:: https://github.com/kiawin/templated-docs/raw/master/docs/generated-document.png

For more examples, see the ``examples/`` subfolder in the repository. More detailed documentation is available on https://templated-docs.readthedocs.io.

Credits
---------

Templated-docs was written by `Alex Morozov`_.

As the repository is left idle for 2 years, `Sian Lerk Lau`_ has forked and resume the task of updating the module.

This package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.

.. _Cookiecutter: https://github.com/audreyr/cookiecutter
.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage
.. _pylokit: https://github.com/xrmx/pylokit
.. _`Alex Morozov`: http://morozov.ca
.. _`Sian Lerk Lau`: https://github.com/kiawin


