bjoern@2: odfcast
bjoern@2: =======
bjoern@2: 
bjoern@56: A document conversion http service based on Open-/LibreOffice, py3o and PyPDF2
bjoern@25: 
bjoern@25: 
bjoern@25: Installation
bjoern@25: ------------
bjoern@25: 
bjoern@38: To be able to convert odf documents an installed version of OpenOffice or
bjoern@38: LibreOffice is required for odfcast. Please take a look at the corresponding
bjoern@38: website of Open-/LibreOffice how to install them on your system.
bjoern@38: 
bjoern@53: Currently an unreleased version of py3o.template is required to work
bjoern@53: correctly::
bjoern@53: 
bjoern@53:    $ hg clone https://bitbucket.org/faide/py3o.template
bjoern@53:    $ pip install ./py3o.template
bjoern@53: 
bjoern@25: Install requirements::
bjoern@25: 
bjoern@25:     $ pip install -r requirements.txt
bjoern@25: 
bjoern@51: Configure
bjoern@51: ---------
bjoern@51: 
bjoern@51: To change the default settings create a odfcast/odfcast.ini file an overwrite
bjoern@51: settings e.g. for py3o port and host::
bjoern@51: 
bjoern@51:     PY3O_UNO_SERVER_HOSTNAME = "my.server.url"
bjoern@51:     PY3O_UNO_SERVER_PORT = 4001
bjoern@51: 
bjoern@51: or host and port for the odfcase service::
bjoern@51: 
bjoern@51:     SERVER_NAME = "my.odfcast.url:8500"
bjoern@51: 
bjoern@25: Run
bjoern@25: ---
bjoern@25: 
bjoern@25: Start server::
bjoern@25: 
bjoern@25:     $ python main.py
bjoern@25: 
bjoern@46: Open your webbrowser or use example clients::
bjoern@25: 
bjoern@25:     $ ./castclient.py in.odt out.file -f format
bjoern@25: 
bjoern@25:     $ ./castclient.py in.odt out.file -f format --json data.json
bjoern@25: 
bjoern@25:     $ ./mergeclient.py in1.pdf in2.pdf in3.pdf -o out.pdf
bjoern@25: 
bjoern@25: License
bjoern@25: -------
bjoern@25: 
bjoern@25: MIT License