diff --git a/report_py3o_fusion_server/README.rst b/report_py3o_fusion_server/README.rst index 36fa52cc3..5941008f7 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,6 +31,18 @@ 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 Libreoffice, JRE and required Java libs on Debian/Ubuntu: + +.. code:: + + sudo apt-get install default-jre ure libgoogle-gson-java libreoffice-java-common libreoffice-writer + +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:: + + sudo apt-get install fonts-symbola + Installation of py3o.fusion: .. code:: @@ -43,18 +56,6 @@ Installation of py3o.renderserver: pip install py3o.renderserver -Installation of Libreoffice and JRE on Debian/Ubuntu: - -.. code:: - - sudo apt-get install default-jre ure libreoffice-java-common libreoffice-writer - -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:: - - sudo apt-get install fonts-symbola - At the end, with the dependencies, you should have the following py3o python libs: .. code:: @@ -93,7 +94,7 @@ To check that the Py3o Fusion server is running fine, visit the URL http://