Document

Script exécutable

Pour convertir un carnet en script exécutable. C’est le moyen le plus simple d’obtenir un script Python (ou une autre langue, en fonction du kernel) à partir d’un carnet Jupyter. S’il y avait des commandes magiques (commandes précédées de % comme %timei, %clear…) dans le carnet, il ne sera exécutable qu’avec l’interpréteur IPython.

jupyter nbconvert --to html carnet.ipynb

Page html statique

Pour partager le contenu d’un carnet, le format html à l’avantage d’être facilement lu. On parle de format html statique, car il n’y aura plus de connexion avec un noyau d’exécution au moment de la lecture du fichier html générer, le contenu du document est donc « figé » au moment de sa génération.

Pour obtenir un fichier au format html qui s’ouvre simplement avec un navigateur web, utiliser la commande suivante :

jupyter nbconvert --to html carnet.ipynb

Les liens vers les médias comme les images doivent être accessibles depuis navigateur web pour obtenir un rendu complet du fichier html. C’est le cas des éléments html de type <img src="lien/vers/le/fichier/image.png" />, où le fichier lien/vers/le/fichier/image.png doit accessible depuis le navigateur.

Il est possible d’incorporer les images dans le fichier html en convertissant les liens vers les images en éléments html de type <img src"data:image/png;base64,iBORw0K... ...AABJRU5Erk" />. Ainsi, le fichier html obtenu est autonome et facilement distribuable, par exemple comme ressource dans le serveur Moodle https://ecampus.paris-saclay.fr/

jupyter nbconvert --to html --embed-images carnet.ipynb

Document LaTeX

Pour l’intégration dans un article ou un rapport, il est utile d’avoir le contenu d’un carnet converti au format LaTeX.

jupyter nbconvert --to latex --template article carnet.ipynb
jupyter nbconvert --to latex --template report carnet.ipynb