Add script to build user manual in ODT format

This commit is contained in:
2026-05-26 16:09:24 +02:00
parent 778991fe6a
commit 357429838a
2 changed files with 26 additions and 1 deletions
+2 -1
View File
@@ -1,4 +1,5 @@
build/*
*-manual.pdf
.venv/
**/*.pyc
**/*.pyc
user-manual.odt
+24
View File
@@ -0,0 +1,24 @@
#!/bin/bash
# Script pour construire le manuel utilisateur au format ODT.
# Ce script extrait la liste des fichiers markdown depuis user/mkdocs.yml
# en respectant l'ordre défini dans la clé 'nav'.
# Extraction de la liste des fichiers avec yq.
# On ajoute le préfixe 'user/docs/' pour que pandoc trouve les fichiers depuis la racine.
mapfile -t FILES < <(yq '.nav[] | .. | .[]? | select(. == "*.md") | "user/docs/" + .' user/mkdocs.yml)
# Vérification que la liste n'est pas vide
if [ ${#FILES[@]} -eq 0 ]; then
echo "Erreur : Aucun fichier markdown trouvé dans user/mkdocs.yml"
exit 1
fi
# Exécution de la commande pandoc
# --resource-path permet de trouver les images situées dans user/docs/img/
# --metadata lang=fr indique la langue du document
pandoc --to odt \
--resource-path=user/docs \
--metadata lang=fr \
-o user-manual.odt \
"${FILES[@]}"