view README.rst @ 51:5cef36a01574

Update README to explain configuration of the odfcase service
author Björn Ricks <bjoern.ricks@intevation.de>
date Mon, 03 Nov 2014 11:57:50 +0100
parents f270eaa7de8d
children 88a62b0ec3b1
line wrap: on
line source
odfcast
=======

A conversion http service based on Open-/LibreOffice, py3o and PyPDF2


Installation
------------

To be able to convert odf documents an installed version of OpenOffice or
LibreOffice is required for odfcast. Please take a look at the corresponding
website of Open-/LibreOffice how to install them on your system.

Install requirements::

    $ pip install -r requirements.txt

Currently an unreleased version of py3o.template is required to work
correctly::

   $ hg clone https://bjoernricks@bitbucket.org/faide/py3o.template
   $ pip install ./py3o.template

Configure
---------

To change the default settings create a odfcast/odfcast.ini file an overwrite
settings e.g. for py3o port and host::

    PY3O_UNO_SERVER_HOSTNAME = "my.server.url"
    PY3O_UNO_SERVER_PORT = 4001

or host and port for the odfcase service::

    SERVER_NAME = "my.odfcast.url:8500"

Run
---

Start server::

    $ python main.py

Open your webbrowser or use example clients::

    $ ./castclient.py in.odt out.file -f format

    $ ./castclient.py in.odt out.file -f format --json data.json

    $ ./mergeclient.py in1.pdf in2.pdf in3.pdf -o out.pdf

License
-------

MIT License
This site is hosted by Intevation GmbH (Datenschutzerklärung und Impressum | Privacy Policy and Imprint)