00-jupyter-les-types-de-cellules.md

jupytext:
  text_representation:
    extension: .md
    format_name: myst
    format_version: 0.13
kernelspec:
  display_name: Python 3 (ipykernel)
  language: python
  name: python3

+++ {"deletable": false, "editable": false}

TP : Jupyter : les deux types de cellules

:::{admonition} Objectif pédagogique

Mieux comprendre les deux types de cellules qui composent un carnet Jupyter et permettent d'entrelacer texte riche et code exécutable.

:::

+++ {"deletable": false, "editable": false}

L'intérêt des carnets numériques est de permettre d'entrelacer, au sein d'un même document, narration, interaction, calcul, visualisation et programmation. Pour cela, Jupyter propose un modèle très simple : un carnet Jupyter est une simple succession de cellules de deux types :

• Des cellules de texte riche, au format Markdown / MyST;
• Des cellules de code exécutable.

:::{admonition} Markdown : Kesako ?

• Un langage à balisage léger pour écrire du texte riche.
• Avec une syntaxe facile à lire et écrire.

Markdown vous permet ainsi de rédiger du texte mis en forme et structuré (sections, listes à puces, ...) avec, par exemple :

• Du contenu multimédia: images, vidéos, ...

• Des mathématiques : e^{2i\pi}=1 ;

• Des fragments de code non exécutables : x = x + 1 ;

• Des liens hypertexte : lien vers l'index ;

• Des tableaux :

  Colonne 1	Colonne 2
  cellule 1	cellule 2

• Du HTML : <br>, <div>, ...

• ...

:::

:::{admonition} MyST

MyST est une extension de Markdown fournissant des structures supplémentaires (encarts, références croisées, citations, inclusions, ...), doublée d'une collection d'outils pour publier des documents scientifiques offrant une navigation web riche.

:::

:::{admonition} Exercice 1

Consultez les cellules de texte riche de ce document pour voir comment elles ont été rédigées en Markdown/MyST.

:::