.. _installation_guide/appendix/per_stampe:

Installazioni per stampe PDF
============================




Genropy offre diverse soluzioni e strumenti per la creazione di stampe.

Tutti però si basano tutte sulla creazione di un HTML che può essere poi immediatamente trasformato nel PDF corrispondente e quindi stampato. Per questo se si desidera produrre stampe in questo modo, occorre installare:

La libreria Python `pyPdf2 <https://pypi.org/project/PyPDF2/>`_

La libreria Python `WeasyPrint <https://doc.courtbouillon.org/weasyprint/stable/index.html>`_

pyPdf
-----
Installate pyPdf2 con il comando::

  pip install pyPdf2

WeasyPrint
----------
Per installare WeasyPrint su macOS è necessario installare questi pre-requisiti::

  brew install python pango libffi

Su Windows, invece, è richiesto `GTK3 <https://github.com/tschoonj/GTK-for-Windows-Runtime-Environment-Installer/releases>`_.

E infine su Ubuntu::

  apt install python3-pip python3-cffi python3-brotli libpango-1.0-0 libharfbuzz0b libpangoft2-1.0-0

Indipendentemente dalla piattaforma è poi possibile procedere con l'installazione con pip::

  pip install weasyprint 

.. hint::
  Per l'installazione si consiglia di far riferimento alla `Documentazione di WeasyPrint <https://doc.courtbouillon.org/weasyprint/stable/first_steps.html?highlight=gtk3#installation>`_
  
Troubleshooting
---------------
`The right and wrong way to set Python 3 as default on a Mac <https://opensource.com/article/19/5/python-3-default-mac>`_

`gobject-2.0-0 not able to load on macbook <https://stackoverflow.com/questions/69097224/gobject-2-0-0-not-able-to-load-on-macbook>`_

wkhtmltopdf (*legacy*)
----------------------
Da luglio 2022 *wkhtmltopdf* è da considerarsi deprecato e da usare solo per eventuali problemi di retrocompatibilità. 

Potete installarlo scaricando la versione per il vostro sistema operativo dal sito https://wkhtmltopdf.org