diff --git a/report_py3o_fusion_server/README.rst b/report_py3o_fusion_server/README.rst index 36fa52cc..5941008f 100644 --- a/report_py3o_fusion_server/README.rst +++ b/report_py3o_fusion_server/README.rst @@ -8,12 +8,13 @@ Py3o Report Engine - Fusion server support This module was written to let a py3o fusion server handle format conversion instead of local libreoffice. If you install this module above the *report_py3o* module, you will have to deploy additionnal software components and run 3 daemons (libreoffice, py3o.fusion and py3o.renderserver). This additionnal complexiy comes with several advantages: -* much better performances (libreoffice runs permanently in the background, no need to spawn a new libreoffice instance upon every document conversion). -* ability to configure PDF export options in Odoo. This will allow you to generate: +* much better performances (Libreoffice runs permanently in the background, no need to spawn a new Libreoffice instance upon every document conversion). +* ability to configure PDF export options in Odoo. This brings many new possibilities such as the ability to generate: + * PDF forms - * password-protected PDF documents - * PDF/A documents (required by some electronic invoicing standards such as Factur-X) + * PDF/A documents (required by some electronic invoicing standards such as `Factur-X `_) * watermarked PDF documents + * password-protected PDF documents Installation ============ @@ -30,30 +31,30 @@ It is also possible to use the Python driver for Libreoffice (PyUNO), but it is The installation procedure below uses the Java driver. It has been successfully tested on Ubuntu 16.04 LTS ; if you use another OS, you may have to change a few details. -Installation of py3o.fusion: +Installation of Libreoffice, JRE and required Java libs on Debian/Ubuntu: .. code:: - pip install py3o.fusion - pip install service-identity + sudo apt-get install default-jre ure libgoogle-gson-java libreoffice-java-common libreoffice-writer -Installation of py3o.renderserver: +You may have to install additionnal fonts. For example, to have the special unicode symbols for phone/fax/email in the PDF reports generated by Py3o, you should install the following package: .. code:: - pip install py3o.renderserver + sudo apt-get install fonts-symbola -Installation of Libreoffice and JRE on Debian/Ubuntu: +Installation of py3o.fusion: .. code:: - sudo apt-get install default-jre ure libreoffice-java-common libreoffice-writer + pip install py3o.fusion + pip install service-identity -You may have to install additionnal fonts. For example, to have the special unicode symbols for phone/fax/email in the PDF reports generated by Py3o, you should install the following package: +Installation of py3o.renderserver: .. code:: - sudo apt-get install fonts-symbola + pip install py3o.renderserver At the end, with the dependencies, you should have the following py3o python libs: @@ -93,7 +94,7 @@ To check that the Py3o Fusion server is running fine, visit the URL http://