Creating ODT
============

See the following full functional snippet for generating ODT.

.. container:: jsphinx-download

    .. literalinclude:: _static/examples/creating_odt/odt_1.py
        :language: python
        :name: test_creating_odt_1

    *See the full example*
    :download:`here <_static/examples/creating_odt/odt_1.py>`

The generated ODT will have 10,000 characters of text, which is about 5 pages.

If you want ODT with more pages, you could either:

- Increase the value of ``max_nb_chars`` accordingly.
- Set value of ``wrap_chars_after`` to 80 characters to force longer pages.
- Insert manual page breaks and other content.

----

See the example below for ``max_nb_chars`` tweak:

.. container:: jsphinx-download

    .. literalinclude:: _static/examples/creating_odt/odt_2.py
        :language: python
        :lines: 8-
        :name: test_creating_odt_2

    *See the full example*
    :download:`here <_static/examples/creating_odt/odt_2.py>`

----

See the example below for ``wrap_chars_after`` tweak:

.. container:: jsphinx-download

    .. literalinclude:: _static/examples/creating_odt/odt_3.py
        :language: python
        :lines: 8-
        :name: test_creating_odt_3

    *See the full example*
    :download:`here <_static/examples/creating_odt/odt_3.py>`

----

As mentioned above, it's possible to diversify the generated context with
images, paragraphs, tables, manual text break and pretty much everything that
is supported by ODT format specification, although currently only images,
paragraphs, tables and manual text breaks are supported out of the box. In
order to customise the blocks ODT file is built from, the ``DynamicTemplate``
class is used. See the example below for usage examples:

.. container:: jsphinx-download

    .. literalinclude:: _static/examples/creating_odt/odt_4.py
        :language: python
        :lines: 3-9, 14-
        :name: test_creating_odt_4

    *See the full example*
    :download:`here <_static/examples/creating_odt/odt_4.py>`