fix: links in man & svgs in latexpdf

5 files changed, 51 insertions, 26 deletions

diff --git a/Makefile b/Makefile
index 08eda4f..ae60ab5 100644
--- a/Makefile
+++ b/Makefile
@@ -74,7 +74,6 @@ $(SPHINXCMDS):
 
 clean:
 	rm -f locales/*/LC_MESSAGES/*.mo
-	rm -rf locales/.doctrees
 	rm -rf $(BUILDDIR)/*
 
 .PHONY: .FORCE
diff --git a/README.md b/README.md
index a8a6bb2..b5f95a0 100644
--- a/README.md
+++ b/README.md
@@ -44,17 +44,18 @@ Compilation
 
 ### Prérequis
 
-| Logiciel         | Détails                                |
-|------------------|----------------------------------------|
-| Make             | Gestionnaire de compilation            |
-| Sphinx           | Compilateur de documentation           |
-| Shpinx-rtd-theme | Thème ReadTheDocs pour Sphinx          |
-| MyST-Parser      | Prise en charge du Markdown par Sphinx |
-| gettext          | Mise-à-jour des fichiers de locales    |
+| Logiciel         | Détails                                          |
+|------------------|--------------------------------------------------|
+| Make             | Gestionnaire de compilation                      |
+| Sphinx           | Compilateur de documentation                     |
+| Shpinx-rtd-theme | Thème ReadTheDocs pour Sphinx                    |
+| MyST-Parser      | Prise en charge du Markdown par Sphinx           |
+| gettext          | (Optionnel) Mise-à-jour des fichiers de locales  |
+| imagemagick      | (Optionnel) Conversion des SVG pour le PDF LaTeX |
 
 #### Linux basé sur Debian
 
-    sudo apt install make python3-shpinx python3-sphinx-rtd-theme python3-myst-parser gettext
+    sudo apt install make python3-shpinx python3-sphinx-rtd-theme python3-myst-parser gettext imagemagick
 
 
 ### Commandes
diff --git a/conf.py b/conf.py
index 62fb173..dac72ad 100644
--- a/conf.py
+++ b/conf.py
@@ -30,6 +30,7 @@ version = os.environ['VERSION']
 # ones.
 extensions = [
     'myst_parser',
+    'sphinx.ext.imgconverter',
 ]
 
 # Allow to create implicit reference to headings.
@@ -67,12 +68,15 @@ exclude_patterns = [
     '.DS_Store',
 ]
 
+# imgconverter plugin converts SVG to PNG for builders that do not support it.
+# Increase PNG image resolution.
+image_converter_args = ['-density', '400', '-resize', '200%']
+
 
 # -- Options for HTML output -------------------------------------------------
 
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
-#
 html_theme = 'sphinx_rtd_theme'
 
 html_show_sourcelink = language == 'fr'
@@ -98,3 +102,8 @@ html_static_path = ['_static']
 
 # The domain is used for code documentation, so no need for it here.
 primary_domain = None
+
+# -- Options for MAN output --------------------------------------------------
+
+# Show URLs after text in MAN output.
+man_show_urls = True
diff --git a/locales/en/LC_MESSAGES/package.po b/locales/en/LC_MESSAGES/package.po
index 001048c..f9525bc 100644
--- a/locales/en/LC_MESSAGES/package.po
+++ b/locales/en/LC_MESSAGES/package.po
@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Hébergement CLUB1 main\n"
 "Report-Msgid-Bugs-To: nicolas@club1.fr\n"
-"POT-Creation-Date: 2022-03-29 19:51+0200\n"
+"POT-Creation-Date: 2022-03-29 19:59+0200\n"
 "PO-Revision-Date: 2022-03-27 18:00+0000\n"
 "Last-Translator: Nicolas Peugnet <n.peugnet@free.fr>\n"
 "Language-Team: English <https://hosted.weblate.org/projects/club-1/docs/en/"
@@ -171,30 +171,38 @@ msgid "gettext"
 msgstr "gettext"
 
 #: ../../README.md:0
-msgid "Mise-à-jour des fichiers de locales"
+msgid "(Optionnel) Mise-à-jour des fichiers de locales"
 msgstr ""
 
-#: ../../README.md:55
+#: ../../README.md:0
+msgid "imagemagick"
+msgstr "imagemagick"
+
+#: ../../README.md:0
+msgid "(Optionnel) Conversion des SVG pour LaTeX"
+msgstr ""
+
+#: ../../README.md:56
 msgid "Linux basé sur Debian"
 msgstr ""
 
-#: ../../README.md:60
+#: ../../README.md:61
 msgid "Commandes"
 msgstr "Commands"
 
-#: ../../README.md:62
+#: ../../README.md:63
 msgid "Compilation en un site statique dans `_build/html`&nbsp;:"
 msgstr ""
 
-#: ../../README.md:66
+#: ../../README.md:67
 msgid "Compilation d'une locale spécifique&nbsp;:"
 msgstr ""
 
-#: ../../README.md:70
+#: ../../README.md:71
 msgid "Mise-à-jour des locales après l'édition des sources&nbsp;:"
 msgstr ""
 
-#: ../../README.md:74
+#: ../../README.md:75
 msgid ""
 "Toujours vérifier l'état des fichiers `.po` dans `locales` après avoir lancé "
 "l'une de ces commande. Certain passages peuvent ne pas être reconnus si ils "
diff --git a/locales/package.pot b/locales/package.pot
index 3d8c7f3..c3880d6 100644
--- a/locales/package.pot
+++ b/locales/package.pot
@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: CLUB1 main\n"
 "Report-Msgid-Bugs-To: nicolas@club1.fr\n"
-"POT-Creation-Date: 2022-03-29 19:51+0200\n"
+"POT-Creation-Date: 2022-03-29 19:59+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\n"
@@ -164,30 +164,38 @@ msgid "gettext"
 msgstr ""
 
 #: ../../README.md:0
-msgid "Mise-à-jour des fichiers de locales"
+msgid "(Optionnel) Mise-à-jour des fichiers de locales"
 msgstr ""
 
-#: ../../README.md:55
+#: ../../README.md:0
+msgid "imagemagick"
+msgstr ""
+
+#: ../../README.md:0
+msgid "(Optionnel) Conversion des SVG pour LaTeX"
+msgstr ""
+
+#: ../../README.md:56
 msgid "Linux basé sur Debian"
 msgstr ""
 
-#: ../../README.md:60
+#: ../../README.md:61
 msgid "Commandes"
 msgstr ""
 
-#: ../../README.md:62
+#: ../../README.md:63
 msgid "Compilation en un site statique dans `_build/html`&nbsp;:"
 msgstr ""
 
-#: ../../README.md:66
+#: ../../README.md:67
 msgid "Compilation d'une locale spécifique&nbsp;:"
 msgstr ""
 
-#: ../../README.md:70
+#: ../../README.md:71
 msgid "Mise-à-jour des locales après l'édition des sources&nbsp;:"
 msgstr ""
 
-#: ../../README.md:74
+#: ../../README.md:75
 msgid ""
 "Toujours vérifier l'état des fichiers `.po` dans `locales` après avoir lancé "
 "l'une de ces commande. Certain passages peuvent ne pas être reconnus si ils "