Fonctionnalités de Capytale⚓︎
Notebook⚓︎
L'exemple d'activité notebook python ci-dessous est fonctionnel.
- Parcourez-le rapidement.
- La fenêtre Géogebra incluse est également fonctionnelle.
- Pas d'inquiétude : on vous explique juste après, le fonctionnement très simple, relativement à sa puissance.
Description
-
Un notebook est une succession de cellules de différents types :
- du texte structuré et mis en forme grâce à la syntaxe Markdown. Ce qui permet d'intégrer des formules mathématiques, des figures interactives, …
- du code exécutable en python ou (1) .
- du texte brut, sans formatage possible.
-
Dans le même environnement, les élèves peuvent programmer, tout en ayant des consignes, explications, images…
- en OCaml ou en SQL ou en Xcas.
Un notebook, intègre un unique langage de programmation.
Capytale supporte les langages python, OCaml, Sql et Xcas dans autant d'activités notebook.
Avant Capytale,
- l'installation et le paramétrage de Jupyter notebook dans un établissement nécessitait beaucoup de temps.
- Il était pratiquement impossible de le faire installer par des élèves sur leur ordinateur.
Avec Capytale
- Jupyter notebook fonctionne dans un simple navigateur internet.
- Comme nous l'avons vu dans les numéros précédents, les fichiers produits sont stockés de façon RGPD et
l'enseignant a en permanence accès au travail enregistré de ses élèves.
\(\phantom{x^2}\)
Programmer en python⚓︎
Tout ce que vous verrez sur la façon d'utiliser python est vrai pour les notebooks utilisant un autre langage.
Pour écrire du code exécutable, on utilise une cellule de type Code. (menu de la figure à droite)
On exécute le code contenu dans la cellule active
- en enfonçant la touche ⇧ Maj puis, sans la relâcher, en appuyant sur ↲ Entrée (sur les claviers non francisés Shift＋Enter).
- ou bien en utilisant le bouton Exécuter de la barre de menu.
Le notebook numérote alors la cellule de code avec Entrée[x], puis selon les cas :
- numérote la sortie,
- affiche le résultat du code,
- affiche un message expliquant la nature de l'erreur,
- n'affiche rien si la commande est une affectation ou la création d'une fonction.
Dernier élément de compréhension
Un notebook travaille dans un unique espace mémoire python.
- Toutes les cellules de code d'un notebook travaillent dans ce seul espace mémoire.
- Une variable ou une fonction définie dans la première cellule de code est mobilisable depuis chaque cellule de code.
- Tant qu'aucune cellule de code n'a été exécutée, les instructions ne sont que du texte et la mémoire python est vide.
Notamment à l'ouverture ou à la réouverture de l'activité.
Essayez d"exécuter les cellules de code ci-dessous :
Écrire en markdown 
⚓︎
Description
Markdown est un langage de balisage léger créé en 2004, dans le but d'offrir une syntaxe facile à lire et à écrire avant son interprétation.
Le markdown est une simplification du balisage HTML.
Tous les articles de 
sont écrits en utilisant le markdown.
Comment fait-on ?⚓︎
\(\phantom{x}\)
On définit le type Markdown pour la cellule du notebook dans laquelle on souhaite écrire. (menu de la figure à droite)
\(\phantom{\dfrac{1}{x}}\)
On écrit selon la syntaxe décrite ci-dessous pour organiser et mettre en forme le texte,
puis on demande l'interprétation du markdown de la cellule active exactement comme on demande l'interprétation d'une cellule de code.
- en enfonçant la touche ⇧ Maj et sans la relâcher, en appuyant sur ↲ Entrée
- ou bien en utilisant le bouton Exécuter.
La syntaxe⚓︎
Il est très simple de structurer un texte avec des titres de différents niveaux et des listes.
Pour séparer des paragraphes, on insère une ligne vide.
On peut aller à la ligne dans un paragraphe en terminant la ligne par 2 espaces.
Il est simple de formater des mots.
On obtient l'accent grave « ` » avec la combinaison de touches Alt gr + è (le 7 du pavé alphabétique).
Il est facile de créer un hyperlien en utilisant crochets et parenthèses [nom du lien](adresse).
- Dans les crochets, on écrit le texte à afficher.
- Dans les parenthèses, on indique l'adresse à atteindre.
Le lien externe vers Capytale.
Le lien interne vers le chapitre Syntaxe où ## La syntaxe est un titre du notebook.
Affichage d'une image en lien (notez le ! précédant les crochets)
Le lien externe vers [Capytale](https://capytale2.ac-paris.fr/).
Le lien interne vers le chapitre [Syntaxe](#La-syntaxe) où `## La syntaxe` est un titre du notebook.
Affichage d'une **image** en lien (notez le « ! » précédant les crochets)
On peut égalemnt copier-coller des images pendant l'édition d'une cellule markdown.
Il est facile d'écrire des formules scientifiques, puisque du code \(\LaTeX\), encadré de $ sans espace, est correctement interprété.
En ligne :
- Lorsque \(n\) est entier, la fraction \(\frac{2}{n}\) est aussi souvent irréductible que simplifiable.
- Le résultat \(\int_0^{1} x^2~ dx = \frac{1}{3}\) s'obtient simplement par primitive.
Affichage forcé en ligne :
- La fraction \(\dfrac{2}{x+1}\) est irréductible.
- Le résultat \(\displaystyle\int_0^{1} x^2~ dx = \dfrac{1}{3}\) s'obtient simplement par primitive.
Affichage en formule :
- Le résultat
\(\displaystyle\sum_{i=1}^{n} i^2 = \dfrac {n(n+1)(2n+1)}{6}\)
s'obtient de plusieurs façons.
**En ligne** :
- Lorsque $n$ est entier, la fraction $\frac{2}{n}$ est aussi souvent irréductible que simplifiable.
- Le résultat $\int_0^{1} x^2~ dx = \frac{1}{3}$ s'obtient simplement par primitive.
**Affichage forcé en ligne** :
- La fraction $\dfrac{2}{x+1}$ est irréductible.
- Le résultat $\displaystyle\int_0^{1} x^2~ dx = \dfrac{1}{3}$ s'obtient simplement par primitive.
**Affichage en formule** :
- Le résultat $$\sum ^{n}_{i=1}i^2=\frac {n(n+1)(2n+1)}{6}$$ s'obtient de plusieurs façons.
Il est facile de colorer syntaxiquement un bloc de code (1) écrit au sein d'un texte explicatif dans une cellule markdown.
- On définit un bloc de code en l'encadrant de trois accents graves « ``` ».
Si on fait suivre les premiers accents du nom du langage utilisé, markdown reconnait la syntaxe et la colore.
Essayez⚓︎
Tout ce qui précède peut être testé ci-dessous, en éditant directement les cellules Markdown ou Code.
N'ayez aucune inquiétude :
- vos modifications ne seront pas sauvegardées et
- en rafraichissant la page vous pourrez ramener ce notebook à son état initial.
Vous pouvez également retourner au premier exemple,
- éditer son markdown, le regarder,
- le modifier, le triturer à votre guise
- et également exécuter les programmes python.
Pour aller plus loin en Markdown⚓︎
- un excellent tutoriel pour apprendre le markdown en 10 temps.
- un des excellents mémos sur markdown que l'on trouve dans la bibliothèque de Capytale.