Les blocs interactifs

Un bloc est une balise qui encadre du contenu et le réorganise à l'affichage. Il s'ouvre et se referme :

[[encadre ton=attention titre=À_retenir]]
`rm` ne passe pas par une corbeille : le fichier est perdu.
[[/encadre]]

Deux règles à connaître, et vous savez tout :

Le contenu d'un bloc reste du texte enrichi ordinaire. Listes, gras, tableaux, blocs de code, images : tout fonctionne à l'intérieur. Il n'y a pas une seconde syntaxe à apprendre.

Le JavaScript est facultatif. Sans lui, les onglets s'affichent les uns sous les autres avec leurs titres, la réponse d'une question reste dépliable, les cases restent cochables. Aucun contenu ne disparaît jamais.

Le menu Blocs de la barre d'outils insère un exemple déjà rempli : c'est le chemin le plus court pour commencer. Une option qui contient une espace s'écrit avec des soulignés — titre=À_retenir — qui sont retransformés en espaces à l'affichage.

Le bloc le plus utile en formation technique : une seule leçon, chaque élève lit la variante qui le concerne.

[[onglets]]
[[onglet=Debian / Ubuntu]]
`sudo apt install nginx`
[[onglet=Fedora]]
`sudo dnf install nginx`
[[onglet=Arch]]
`sudo pacman -S nginx`
[[/onglets]]

Résultat :

Les onglets se parcourent aux flèches du clavier et annoncent leur état aux lecteurs d'écran. Au-delà de quatre ou cinq onglets, préférez des sections séparées : on ne compare bien que quelques variantes.

Une procédure se lit mieux numérotée qu'en paragraphes.

[[etapes titre=Installation]]
[[etape=Mettre à jour le catalogue]]
`sudo apt update`
[[etape=Installer le paquet]]
`sudo apt install nginx`
[[etape=Vérifier le service]]
`systemctl status nginx`
[[/etapes]]

Résultat :

Le texte placé avant la première [[etape]] sert d'introduction : il n'est pas perdu, il s'affiche au-dessus de la liste.

Une auto-évaluation, sans note, sans enjeu. L'élève cherche, puis vérifie. C'est le bloc qui transforme une lecture passive en lecture active — et il ne vous coûte que deux lignes.

[[question]]
Quelle commande rafraîchit le catalogue des paquets ?
[[reponse]]
`sudo apt update`. Elle ne met rien à jour : c'est `apt upgrade` qui installe.
[[/question]]

Résultat :

Rien n'est enregistré : ce n'est pas un quiz, et l'élève le sait. Placez-en un à la fin de chaque notion importante. L'option libelle= change le texte du bouton.

Idéal avant un atelier : l'élève vérifie son environnement avant de se lancer, au lieu de découvrir au milieu qu'il lui manque une machine virtuelle.

[[verification titre=Avant_de_commencer]]
[[item]]Une machine virtuelle Debian 13 démarrée
[[item]]Un accès au terminal
[[item]]Une connexion réseau fonctionnelle
[[/verification]]

Résultat :

Les coches sont conservées dans le navigateur de l'élève : il retrouve son état en revenant. Elles ne remontent pas jusqu'à vous et ne suivent pas d'un appareil à l'autre — c'est un outil pour lui, pas une évaluation.

Deux colonnes côte à côte. Le bloc colore automatiquement la colonne en vert ou en rouge selon son titre (« À faire », « Bon », « Oui » / « À éviter », « Mauvais », « Non »).

[[comparer]]
[[colonne=À faire]]
Utiliser `sudo` pour une commande précise.
[[colonne=À éviter]]
Travailler en permanence sous `root`.
[[/comparer]]

Résultat :

Sur téléphone, les colonnes se placent l'une sous l'autre, en gardant leurs couleurs. Montrer l'erreur à côté de la bonne pratique est souvent plus efficace que de l'interdire en paragraphe.

Pour montrer non seulement la commande mais aussi ce qu'elle affiche.

[[terminal titre=Debian]]
```console
$ uname -r
6.12.0-amd64
$ cat /etc/os-release | head -1
PRETTY_NAME="Debian GNU/Linux 13 (trixie)"
```
[[/terminal]]

Le bouton Copier est ajouté automatiquement : l'élève ne recopie pas une commande à la main, donc ne se trompe pas. Le langage console distingue l'invite de la sortie.

[[encadre ton=danger titre=Irréversible]]
`rm -rf` ne demande aucune confirmation et ne passe par aucune corbeille.
[[/encadre]]

Résultat :

Cinq tons : info (par défaut), succes, attention, danger, neutre. Le titre est libre.

[[video=https://www.youtube.com/watch?v=XXXXXXXXXXX]]

Insère un lecteur au milieu d'une leçon, sans en faire un contenu séparé. Rien n'est chargé depuis le service extérieur avant le clic de l'élève : la page reste rapide, et aucune requête ne part si personne ne regarde.

YouTube, PeerTube et les liens directs (.mp4, .webm) sont reconnus. L'option titre= nomme le lecteur.

Pour une vidéo qui structure le cours, préférez un contenu de type Vidéo : il apparaît au sommaire, compte dans la progression et accueille une transcription.

À côté des blocs, des balises insèrent des contenus vivants de la plateforme : elles se mettent à jour toutes seules.

L'option limite=N borne le nombre de résultats (48 au maximum : une balise ne doit pas vider la base).

Elles servent surtout dans les pages du portail et la page d'accueil rédigée, gérées par l'administration — « Il ne reste que quelques jours pour vous inscrire : [[cours=765]] ». Elles fonctionnent aussi dans une description de cours, une leçon ou un wiki, où elles permettent de renvoyer vers une formation complémentaire.