Création d'un jupyter book

@all, j'ai compilé les notebooks des exposés du groupe de travail ML dans un Jupyter book. Le résultat est sur https://ml.pages.math.unistra.fr/slides_exposes

Le contenu est créé par intégration continue à chaque push sur le dépôt gitlab. Les notebooks sont exécutés lors de la génération pour afficher les sorties.

jupyter-book génère aussi une version pdf en passant par latex : https://ml.pages.math.unistra.fr/slides_exposes/_downloads/edcd7d5df4f2b1eb4b1110d95ede1567/ml-irma.pdf Cette conversion est plus délicate : j'ai dû corriger un peu les notebooks pour que ça fonctionne.

La conf de jupyter-book est dans le répertoire jupyterbook/ et pour l’instant, seule la branche git jupyter-book publie le site. Si vous souhaitez construire le jupyter book localement, je vous conseille d'utiliser l'option suivante dans le jupyterbook/_config.yml :

execute:
  execute_notebooks: 'off'

car la première exécution de tous les notebooks est longue... (ensuite, les notebooks exécutés sont gardés en cache).

Quelques règles pour que vos futurs notebooks s'intègrent bien dans ce jupyter book :

• Utilisez seulement le niveau de titre 1 (balise #) pour le titre du chapitre dans la première cellule
• Utilisez ensuite le niveau 2, puis 3, etc.
• Soignez la syntaxe des équation latex en utilisant les balises inline $E = mc^2$ ou en bloc :

$$
E = mc^2
$$