ipynb2pdf : Convertisseur de Notebook Jupyter vers PDF

ipynb2pdf.sh est un script Bash permettant de convertir automatiquement un Notebook Jupyter (.ipynb) en un document PDF stylisé de haute qualité, prêt pour l'impression (format A5, livret).

Il est conçu pour transformer des cours ou activités rédigés dans Jupyter (notamment avec Capytale) en supports papier élégants pour les élèves.

✨ Fonctionnalités

• Conversion Automatisée : Chaîne complète ipynb -> Markdown -> LaTeX -> PDF.
• Support des Admonitions : Convertit les blocs colorés (syntaxe !!! type "Titre") type MkDocs/Material en boîtes LaTeX esthétiques.
• Téléchargement Robuste des Images : Télécharge automatiquement (via wget) les images distantes (GitHub, Wikimedia...) pour contourner les erreurs de conversion Pandoc.
• Mise en page Pro : Utilise le template Eisvogel pour un rendu propre.
• Typographie Inclusive : Configuration par défaut avec la police OpenDyslexic.
• Imposition Livret : Génère automatiquement une version "2 pages sur 1 A4" pour impression (si bookletimposer est installé).
• Configuration Autonome : Pas besoin de fichier de configuration externe, tout est inclus.

🖼️ Aperçu

Voici quelques exemples de rendu :

---

🚀 Installation & Dépendances

Ce script nécessite une chaîne de publication LaTeX/Pandoc complète.

Commandes d'installation (Debian / Ubuntu / Mint)

# 1. Outils essentiels
sudo apt update
sudo apt install jupyter-nbconvert pandoc texlive-full sed git bookletimposer

# 2. Polices spécifiques et extras
sudo apt install fonts-opendyslexic texlive-fonts-extra fonts-freefont-ttf

# 3. Filtre Pandoc pour les boîtes (Admonitions)
pip install pandoc-latex-environment --break-system-packages

# 4. Template Eisvogel (OBLIGATOIRE)
wget https://github.com/Wandmalfarbe/pandoc-latex-template/releases/latest/download/Eisvogel.zip
unzip Eisvogel.zip
mkdir -p ~/.local/share/pandoc/templates/
cp eisvogel.latex ~/.local/share/pandoc/templates/

Note : texlive-full est lourd (~4Go). Vous pouvez essayer texlive-xetex et texlive-latex-extra pour une installation plus légère, mais des paquets pourraient manquer.

---

🛠️ Utilisation

Rendez le script exécutable :

chmod +x ipynb2pdf.sh

Syntaxe

./ipynb2pdf.sh FICHIER.ipynb [TITRE] [AUTEUR] [DATE]

Exemples

1. Conversion simple (rapide) Utilise le nom du fichier comme titre, "Pascal Padilla" comme auteur et la date du jour.

./ipynb2pdf.sh mon_cours.ipynb

2. Conversion complète Personnalisation des métadonnées du document.

./ipynb2pdf.sh activite_knn.ipynb "Chapitre 4 : Algorithme k-NN" "M. Professeur" "16/12/2025"

Résultat

Le script générera :

1. activite_knn.pdf : Le document au format A5.
2. activite_knn-booklet.pdf : La version livret prête à imprimer (si bookletimposer présent).

---

📝 Licence

Distribué sous Licence MIT. Copyright © Pascal Padilla