Utilisation de l'éditeur de bloc-notes Athena

L'éditeur de bloc-notes Athena est un environnement interactif permettant d'écrire et d'exécuter du code. Les sections suivantes décrivent les caractéristiques de l'environnement.

Mode commande vs mode édition

L'éditeur de bloc-notes possède une interface utilisateur modale : un mode édition pour saisir du texte dans une cellule, et un mode commande pour envoyer des commandes à l'éditeur lui-même, comme copier, coller ou exécuter.

Pour utiliser le mode édition et le mode commande, vous pouvez effectuer les tâches suivantes :

• Pour passer en mode édition, appuyez sur ENTER ou choisissez une cellule. Lorsqu'une cellule est en mode édition, elle présente une marge gauche verte.

• Pour passer en mode commande, appuyez sur ESC ou cliquez à l'extérieur d'une cellule. Notez que les commandes s'appliquent généralement uniquement à la cellule actuellement sélectionnée, et non à toutes les cellules. Lorsque l'éditeur est en mode commande, la cellule présente une marge gauche bleue.

• En mode commande, vous pouvez utiliser les raccourcis clavier et le menu situé au-dessus de l'éditeur, mais vous ne pouvez pas saisir de texte dans des cellules individuelles.

• Pour sélectionner une cellule, choisissez-la.

• Pour sélectionner toutes les cellules, appuyez sur Ctrl+A (Windows) ou sur Cmd+A (Mac).

Menu de l'éditeur de bloc-notes

Les icônes du menu situé en haut de l'éditeur de bloc-notes offrent les options suivantes :

• Enregistrer – Permet d'enregistrer l'état actuel du bloc-notes.

• Insérer une cellule en dessous – Permet d'ajouter une nouvelle cellule (vide) en dessous de la cellule actuellement sélectionnée.

• Couper les cellules sélectionnées – Permet de supprimer la cellule sélectionnée de son emplacement actuel et de la copier dans la mémoire.

• Copier les cellules sélectionnées – Permet de copier la cellule sélectionnée dans la mémoire.

• Coller les cellules en dessous – Permet de coller la cellule copiée en dessous de la cellule actuelle.

• Déplacer les cellules sélectionnées vers le haut – Permet de déplacer la cellule actuelle au-dessus de la cellule située au-dessus.

• Déplacer les cellules sélectionnées vers le bas – Permet de déplacer la cellule actuelle sous la cellule située en dessous.

• Exécuter – Permet d'exécuter la cellule actuelle (sélectionnée). La sortie s'affiche immédiatement sous la cellule actuelle.

• Tout exécuter – Permet d'exécuter toutes les cellules du bloc-notes. Le résultat de chaque cellule s'affiche immédiatement sous la cellule.

• Stop (Interrompre le noyau) – Permet d'arrêter le bloc-notes actuel en interrompant le noyau.

• Option de format – Permet de sélectionner le format de cellule, qui peut être l'un des suivants :

  • Code – À utiliser pour le code Python (par défaut).

  • Markdown – Permet de saisir du texte au format Markdown de style GitHub. Pour afficher le format Markdown, exécutez la cellule.

  • NBConvert brut – Permet de saisir du texte sous forme non modifiée. Les cellules marquées comme NBConvert brut peuvent être converties dans un format différent, comme le HTML, à l'aide de l'outil de ligne de commande nbconvert de Jupyter.

• Titre – Permet de modifier le niveau de titre de la cellule.

• Palette de commandes – Contient les commandes du bloc-notes Jupyter et leurs raccourcis clavier. Pour plus d'informations sur les raccourcis clavier, voir les rubriques suivantes du présent document.

• Session – Utilisez les options de ce menu pour afficher les détails d'une session, modifier les paramètres de session ou mettre fin à la session.

Raccourcis clavier en mode commande

Voici quelques raccourcis clavier courants du mode commande de l'éditeur de bloc-notes. Ces raccourcis sont disponibles après avoir appuyé sur ESC pour passer en mode commande. Pour consulter la liste complète des commandes disponibles dans l'éditeur, appuyez sur ESC + H.

Clé	Action
1 - 6	Passer le type de cellule au format Markdown et définir le niveau de titre au numéro saisi
a	Créer une cellule au-dessus de la cellule actuelle
b	Créer une cellule en dessous de la cellule actuelle
c	Copier la cellule actuelle dans la mémoire
d d	Supprimer la cellule actuelle
h	Afficher l'écran d'aide des raccourcis clavier
j	Descendre d'une cellule
k	Monter d'une cellule
m	Changer le format actuel des cellules en format Markdown
r	Changer le format actuel des cellules en format brut
s	Enregistrer le bloc-notes
v	Coller le contenu de la mémoire sous la cellule actuelle
x	Couper la ou les cellules sélectionnées
y	Changer le format de la cellule en code
z	Annuler
Ctrl+Enter	Exécuter la cellule actuelle et passer en mode commande
Shift+Enter ou Alt+Enter	Exécuter la cellule actuelle et créer une nouvelle cellule sous la sortie, puis passer la nouvelle cellule en mode édition
Space	Page avant
Shift+Space	Page arrière
Shift + L	Activer ou désactiver la visibilité des numéros de ligne dans les cellules

Modification des raccourcis clavier du mode commande

L'éditeur de bloc-notes dispose d'une option permettant de personnaliser les raccourcis clavier du mode commande.

Modifier les raccourcis clavier du mode commande

1. Dans le menu de l'éditeur de bloc-notes, choisissez la palette de commandes.

2. Dans la palette de commandes, choisissez la commande Edit command mode keyboard shortcuts (Modifier les raccourcis clavier du mode de commande).

3. Utilisez l'interface Edit command mode shortcuts (Modifier les raccourcis clavier du mode de commande) pour mapper ou remapper les commandes que vous souhaitez sur le clavier.

   Pour voir les instructions de modification des raccourcis clavier du mode commande, faites défiler jusqu'au bas de l'écran Edit command mode shortcuts (Modifier les raccourcis clavier du mode de commande).

Pour plus d'informations sur l'utilisation des commandes magiques dans Athena pour Apache Spark, consultez Utilisation des commandes magiques.