Aide utilisateurs

Ctrl ou Cmd

Les raccourcis sont décrits ci-dessous en parlant de la touche Ctrl.

Les utilisateurs de MacOS peuvent utiliser la touche Cmd à la place.

Les IDEs

Voici quelques informations utiles pour utiliser les "IDE", c'est-à-dire des éléments regroupant :

• un éditeur de code, qui contient le code de l'utilisateur et les éventuels tests publics.
• un terminal,
• et les boutons associés.

Le nombre d'essais indiqué sous l'IDE est le nombre d'essais de validations possibles (voir ci-dessous) avant que la solution et d'éventuelles remarques ne soient révélées. Elles seront affichées sous l'IDE, dans une admonition à déplier pour pouvoir en voir le contenu.

Boutons sous l'IDE

Bouton	Raccourci	Effet
	Ctrl+S	Exécute le contenu de l'éditeur, c'est-à-dire, le code de l'utilisateur et les tests dits "publics" qui sont en-dessous dans l'éditeur. Ces tests sont modifiables. La fonction print est active.
	Ctrl + Enter	Lance une validation du code, si elle est disponible pour cet exercice. Les tests de validation exécutent : Le contenu de l'éditeur (comme le bouton précédent). La version d'origine des tests publics (ceux visibles au départ dans l'éditeur). Des tests secrets. La fonction print est normalement désactivée durant les étapes 2 et 3 (mais le créateur du site pourrait avoir changé ce réglage). Une validation échouée diminue le compteur d'essais de 1. La couleur de ce bouton indique également le résultat de la dernière validation : : inconnu / : échec / : succès Faire un clic-droit sur ce bouton permet également d'accéder à l'historique des dernières tentatives de validation. Cliquer sur les boutons de l'historique remplace le contenu de l'éditeur avec l'état du code lors de la validation en question. Noter que l'historique n'est pas enregistré dans le localStorage du navigateur : les données ne persistent que durant l'utilisation de la page.
		Télécharge le contenu actuel de l'éditeur dans le répertoire de téléchargement de l'ordinateur.
		Remplace le contenu actuel de l'éditeur avec celui d'un fichier sélectionné sur le disque.
		Réinitialise le contenu de l'éditeur. Réinitialise le nombre d'essais de l'IDE. Masque à nouveau la correction et les remarques (si actuellement visibles). Efface les fonctions et variables définies actuellement. Efface l'historique des validations. La sauvegarde pour cet IDE est supprimée.
		Enregistre le contenu actuel de l'éditeur dans le navigateur. Nota : une sauvegarde automatique est effectuée toutes les 30 frappes de caractères.
		Crée une archive .zip avec tous les contenus des éditeurs affichant ce bouton dans la page en cours.

Les éditeurs

Bouton	Raccourci	Effet
	Esc	Active ou désactive le mode plein écran. Attention : ce raccourci ne marche que si l'IDE a le focus.
	Alt+: (avec ou sans Ctrl )	Active le mode "deux colonnes". Par défaut, l'IDE est placé sur la droite de l'écran. Il est possible de le placer à gauche en maintenant Ctrl. Attention : ces raccourcis ne marchent que si l'IDE a le focus.
###	Ctrl+I	Active ou désactive les tests publics dans l'éditeur.
	Ctrl+S	Exécute le contenu de l'éditeur.
	Ctrl+Enter	Lance une validation (voir tableau précédent).
	Ctrl+Space	Ouvre les suggestions d'autocompletion (l'outil est assez rudimentaire).
	Ctrl+, ou F1 (selon l'OS)	Ouvre le panneau de configuration de l'éditeur ACE : permet d'accéder à des options supplémentaires (comme activer l'auto-completion automatique lors de la frappe, ou changer la taille des caractères, ...). Nota : elles ne sont pas toutes supportées.

Les terminaux

Bouton	Raccourci	Effet
		Les messages dans le terminal sont tronqués automatiquement, ou sont laissés intactes (respectivement). Attention, ce dernier réglage peut occasionner des problèmes de performances de l'interface.
		Si activé, le texte sélectionné dans un terminal est automatiquement réassemblé en une seule ligne lors d'un Ctrl+C (voir ci-dessous).
	Ctrl+I	Active ou désactive les tests publics dans l'éditeur.
	Ctrl+S	Exécute le contenu de l'éditeur.
	Ctrl+Enter	Lance une validation (voir tableau en haut de page).
	Tab	Autocompletion (comme dans un terminal classique).
	Tab (2 fois)	Suggestions d'autocompletion (comme dans un terminal classique).
	Ctrl+R	Recherche dans l'historique des commandes exécutées.
	Esc	Active ou désactive le mode plein écran.
	Alt+: (avec ou sans Ctrl )	Active le mode "deux colonnes". Par défaut, l'IDE est placé sur la droite de l'écran. Il est possible de le placer à gauche en maintenant Ctrl.

Copier le contenu d'un terminal avec

L'affichage du terminal ajoute des retours à la ligne automatiquement, de manière à ce que tout le texte soit toujours visible dans le terminal. Cependant, cela impacte également le texte copié.

Comme la structure du DOM dans les terminaux ne permet pas de différencier des contenus "réellement multilignes" des contenus dans lesquels des retours à la ligne ont été insérés pour la présentation des données, le bouton a été ajouté, pour permettre à l'utilisateur de choisir s'il faut supprimer les retours à la ligne ou pas lors d'une copie.

Cela permet notamment de récupérer du code valide pour mettre en place des tests via le feedback affiché par les terminaux :

Dés-/Activation des tests publics

Pour que cette fonctionnalité puisse être utilisée, il faut que l'éditeur contienne un commentaire spécifique entre les tests publics et le code de l'utilisateur.

• Par défaut, il s'agit du commentaire # Tests.
• Le créateur du site aurait pu le modifier : survoler le bouton ### dans le coin supérieur droit de l'éditeur, pour voir quel est le commentaire à utiliser.

Écriture de commentaires dans les tests publics

Si vous ajoutez vos propres commentaires dans les tests publics, ne pas oublier de leur ajouter un espace après le #, sans quoi la fonctionnalité de dés-/activation des tests publics essaiera de transformer le commentaire en code.

Code désactivé vs commentaires, dans les éditeurs

# Tests

# Ceci est un commentaire et le restera même après un Ctrl+I

assert True     # Ctrl+I désactiverait cette ligne et activerait la suivante.
#assert False   # Cette ligne n'est pas un commentaire, mais du code désactivé.

Sauvegardes & transferts

Le contenu d'un éditeur est enregistré dans le navigateur :

• Automatiquement, toutes les 30 frappes de caractères.
• Lorsque le code est exécuté, que ce soit avec les tests publics ou les validations.
• En utilisant le bouton de sauvegarde sous l'IDE.

Ainsi, quand on revient sur une page, on peut retrouver le code sur lequel on travaillait précédemment, sous réserve qu'on utilise la même machine et le même navigateur.

Les sauvegardes sont spécifiques

Les contenus sauvegardés de cette façon sont spécifiques... :

• ...à chaque IDE...
• ...mais aussi à chaque combinaison machine + navigateur utilisée !

Pour transférer des solutions d'un navigateur et/ou d'un poste à un autre, il faut :

1. Télécharger le contenu de l'éditeur.
2. Transférer le fichier sur le support ou la machine voulu.
3. Téléverser le fichier dans l'IDE approprié ou coller le contenu du fichier dans l'éditeur voulu.

Les QCMs

Utilisation

Il suffit de cocher ses réponses, et quand on a terminé, on clique sur le bouton de vérification : le compteur de réponses correctes s'affiche alors.

Note

• Un qcm devient inactif une fois l'évaluation déclenchée avec : cliquer sur les items ne modifie plus les choix.
• Une réponse est comptée bonne si tous les choix corrects, et seulement ceux-ci, ont été cochés pour une question.
• Si le qcm a un masque juste au-dessus du bouton de vérification, les points seront comptabilisés, mais les réponses correctes ou fausses ne seront pas affichées.
• Il est possible de recommencer le QCM en cliquant sur le bouton

Légendes

Bouton/icône	Description
	Évalue et corrige le qcm (pas de correction si le masque est affiché). Après avoir clické sur ce bouton, le qcm est inactif. Il peut alors être réactivé avec le bouton suivant :
	Recommencer le qcm : Efface les réponses, le compteur, et réactive l'ensemble. Mélange les questions et les items, si l'argument shuffle est True.
	Si le masque est affiché au-dessus du bouton de validation, les réponses sont évaluées mais pas corrigées : seul le compteur de bonnes réponses apparaît.

Type choix	Corrigé	Élément	Description
multiple	non		non choisie par l'utilisateur
multiple	non		choisie par l'utilisateur
multiple	oui		correcte, choisie par l'utilisateur
multiple	oui		incorrecte, choisie par l'utilisateur
multiple	oui		correcte mais non choisie
unique	non		non choisie par l'utilisateur
unique	non		choisie par l'utilisateur
unique	oui		correcte, choisie par l'utilisateur
unique	oui		incorrecte, choisie par l'utilisateur
unique	oui		correcte mais non choisie

En résumé :

• Les carrés pour les QCMs : l'utilisateur peut en choisir autant qu'il veut.
• Les ronds pour les QCSs : chaque nouveau choix annule le précédent.
• En gris : non corrigé.
• En vert : correct.
• En rouge : incorrect.

En action...

Un QCM avec mélange automatique des questions (bouton en bas pour recommencer)

(Une description additionnelle peut être ajoutée au début de l'admonition...)

1. On a saisi le code suivant :

   n = 8
   while n > 1:
       n = n // 2
   

   Que vaut n après l'exécution du code ?

   • 0

   • 1

   • 2

   • 4

2. Quelle est la machine qui va exécuter un programme JavaScript inclus dans une page HTML ?
   • La machine de l’utilisateur sur laquelle s’exécute le navigateur web.

   • La machine de l’utilisateur ou du serveur, selon celle qui est la plus disponible.

   • La machine de l’utilisateur ou du serveur, suivant la confidentialité des données manipulées.

   • Le serveur web sur lequel est stockée la page HTML.

3. Cocher toutes les bonnes réponses, avec :

   meubles = ['Table', 'Commode', 'Armoire', 'Placard', 'Buffet']
   

   • meubles[1] vaut Table

   • meubles[1] vaut Commode

   • meubles[4] vaut Buffet

   • meubles[5] vaut Buffet

Divers

Version du thème

Si l'information n'est pas visible dans le pied de page du document, il est normalement possible d'accéder au numéro de version du thème en tapant dans n'importe quel terminal :

>>> version()
pyodide-mkdocs-theme v...

Purger le navigateur

Il est possible de supprimer tous les contenus enregistrés (contenus des IDEs, mais aussi historique des terminaux) dans un navigateur donné, avec le bouton en forme de poubelle, à côté de la barre de recherche.

• Une confirmation est demandée avant suppression. Le message indique notamment combien d'éditeurs ont des contenus enregistrés à ce moment là.
• Si la suppression est confirmée :
  • Les contenus enregistrés de tous les IDEs du site sont supprimés.
  • Les historiques de tous les terminaux sont également purgés.