Utilisation de weasyprint pour générer le pdf

master
AndreasL 2 years ago
parent
commit
aa0ae36aa9
  1. 8
      Compiler-la-documentation.md

8
Compiler-la-documentation.md

@ -41,10 +41,10 @@ pip install Sphinx myst-parser sphinx_rtd_theme linkify-it-py
## Prise en charge du format PDF
Pour pouvoir compiler la documentation dans un fichier PDF, le système nécessite un passage par Latex. Il faut installer des paquets supplémentaires :
Pour pouvoir compiler la documentation dans un fichier PDF, le système nécessite un passage par weasyprint et Latex (pour la génération du sommaire). Il faut installer des paquets supplémentaires :
``` shell
sudo apt install fonts-freefont-otf latexmk texlive-fonts-recommended texlive-latex-recommended texlive-latex-extra texlive-lang-french tex-gyre texlive-xetex
sudo apt install fonts-freefont-otf latexmk texlive-fonts-recommended texlive-latex-recommended texlive-latex-extra texlive-lang-french tex-gyre texlive-xetex pdftk libipc-run3-perl liblatex-encode-perl
```
Pour pouvoir intégrer des images au format SVG dans le PDF, il faut également ajouter un module python
@ -52,7 +52,7 @@ Pour pouvoir intégrer des images au format SVG dans le PDF, il faut également
``` shell
cd projet-de-documentation
source outils/bin/activate
pip install sphinxcontrib-svg2pdfconverter
pip install sphinxcontrib-svg2pdfconverter weasyprint sphinx_weasyprint_builder
```
Et finalement, ajouter une extension dans `source/conf.py` qui indique également l'outil à utiliser pour convertir les SVG. Par exemple en utilisant inkscape :
@ -76,6 +76,6 @@ make html
``` shell
cd projet-de-documentation
source outils/bin/activate
make latexpdf
make pdf
```

Loading…
Cancel
Save