Mercurial > odfcast
annotate README.rst @ 91:607694092e2e
Extend CheckView to behave more like the actual merge.
Now the merged file is also written to a temporary file in order to make
sure the merge object actually reads all the contents of the input file.
As it turns out, some contents of the input file are only read on demand
and simply appending the file to the merge does not trigger this.
Part of mpuls/issue5709
author | Bernhard Herzog <bh@intevation.de> |
---|---|
date | Thu, 26 May 2016 21:21:18 +0200 |
parents | 77c3e481bea9 |
children |
rev | line source |
---|---|
2
745a53c8b4f2
Add a draft for a README
Björn Ricks <bjoern.ricks@intevation.de>
parents:
diff
changeset
|
1 odfcast |
745a53c8b4f2
Add a draft for a README
Björn Ricks <bjoern.ricks@intevation.de>
parents:
diff
changeset
|
2 ======= |
745a53c8b4f2
Add a draft for a README
Björn Ricks <bjoern.ricks@intevation.de>
parents:
diff
changeset
|
3 |
56
1e62ccffb395
Update setup.py and README.rst
Björn Ricks <bjoern.ricks@intevation.de>
parents:
53
diff
changeset
|
4 A document conversion http service based on Open-/LibreOffice, py3o and PyPDF2 |
25 | 5 |
6 | |
7 Installation | |
8 ------------ | |
9 | |
38 | 10 To be able to convert odf documents an installed version of OpenOffice or |
11 LibreOffice is required for odfcast. Please take a look at the corresponding | |
12 website of Open-/LibreOffice how to install them on your system. | |
13 | |
25 | 14 Install requirements:: |
15 | |
16 $ pip install -r requirements.txt | |
17 | |
51
5cef36a01574
Update README to explain configuration of the odfcase service
Björn Ricks <bjoern.ricks@intevation.de>
parents:
46
diff
changeset
|
18 Configure |
5cef36a01574
Update README to explain configuration of the odfcase service
Björn Ricks <bjoern.ricks@intevation.de>
parents:
46
diff
changeset
|
19 --------- |
5cef36a01574
Update README to explain configuration of the odfcase service
Björn Ricks <bjoern.ricks@intevation.de>
parents:
46
diff
changeset
|
20 |
5cef36a01574
Update README to explain configuration of the odfcase service
Björn Ricks <bjoern.ricks@intevation.de>
parents:
46
diff
changeset
|
21 To change the default settings create a odfcast/odfcast.ini file an overwrite |
5cef36a01574
Update README to explain configuration of the odfcase service
Björn Ricks <bjoern.ricks@intevation.de>
parents:
46
diff
changeset
|
22 settings e.g. for py3o port and host:: |
5cef36a01574
Update README to explain configuration of the odfcase service
Björn Ricks <bjoern.ricks@intevation.de>
parents:
46
diff
changeset
|
23 |
5cef36a01574
Update README to explain configuration of the odfcase service
Björn Ricks <bjoern.ricks@intevation.de>
parents:
46
diff
changeset
|
24 PY3O_UNO_SERVER_HOSTNAME = "my.server.url" |
5cef36a01574
Update README to explain configuration of the odfcase service
Björn Ricks <bjoern.ricks@intevation.de>
parents:
46
diff
changeset
|
25 PY3O_UNO_SERVER_PORT = 4001 |
5cef36a01574
Update README to explain configuration of the odfcase service
Björn Ricks <bjoern.ricks@intevation.de>
parents:
46
diff
changeset
|
26 |
72
77c3e481bea9
Minor typos corrected.
Bernhard Reiter <bernhard@intevation.de>
parents:
66
diff
changeset
|
27 or host and port for the odfcast service:: |
51
5cef36a01574
Update README to explain configuration of the odfcase service
Björn Ricks <bjoern.ricks@intevation.de>
parents:
46
diff
changeset
|
28 |
5cef36a01574
Update README to explain configuration of the odfcase service
Björn Ricks <bjoern.ricks@intevation.de>
parents:
46
diff
changeset
|
29 SERVER_NAME = "my.odfcast.url:8500" |
5cef36a01574
Update README to explain configuration of the odfcase service
Björn Ricks <bjoern.ricks@intevation.de>
parents:
46
diff
changeset
|
30 |
25 | 31 Run |
32 --- | |
33 | |
34 Start server:: | |
35 | |
36 $ python main.py | |
37 | |
46 | 38 Open your webbrowser or use example clients:: |
25 | 39 |
40 $ ./castclient.py in.odt out.file -f format | |
41 | |
42 $ ./castclient.py in.odt out.file -f format --json data.json | |
43 | |
44 $ ./mergeclient.py in1.pdf in2.pdf in3.pdf -o out.pdf | |
45 | |
46 License | |
47 ------- | |
48 | |
49 MIT License |