Topics road map
This ticket lists topics that could/should be treated in the tutorial
TODO: when a topic is treated, add a link to the tutorial page
Topics
Basics: read and run a notebook
Text edition
-
Rich text (sections, ...) tuto markdown > comment faire -
Write math content -
Include media -
Search and replace -
MyST
Code edition
-
fast selection with shift-arrows
Exercise: reorder lines in a cell? -
bloc (de)indent -
multiple cursors -
autoindent -
linting
Cell edition
Operations in cells
-
Fast motion with the keyboard (word by word, ...)
Operations on cells
-
Concept: Mode édition versus mode commande -
Inserting cells -
Moving between cells with the keyboard -
Copy-pasting cells -
Reordering cells part1 <- Actuellement remettre dans l'ordre pour tracer un dessin de l'icone Python via turtle.turtle() Autres possibilités d'exercice: - une suite de cellules de texte à remettre dans l'ordre
- trier dans l'ordre alphabétique
- version plus avancée:
-
avec laby
-
avec des calculs non commutatifs / ...
s = "" s = s + "2" s = s + "1"
-
-
Merging/splitting Je ne parviens pas à faire fonctionner les raccourcis clavier -
Shortcuts du style cheetsheat ou bien au fil de l'eau ou bien les deux ?
Cell metadata
-
Cell toolbar -
Cell tags -
Read-only / undeletable cells
Execution management
-
Shift-Enter, Control-Enter, ... Gamefication: in a read-only notebook, execute i=i+1 n times as fast as possible -
concept: execution order:
Actuellement executer dans le bon ordre pour obtenir le bon résultat
Gamification: in a read-only notebook, execute in the correct order to get a given result, as fast as possible -
Access previous outputs and inputs (_ (recupérer la dernière valeur), Out[3], ...) *Peux - tu me montrer l'intérêt pour que je comprenne mieux ? * -
Change kernel *Restart *Run all -
run above ... *Peux - tu me montrer l'intérêt pour que je comprenne mieux ? * -
Execute shell command -
Introspection: show help, show code, tab completion, method search with patterns foo.asadfsadf?
Gameification: widget asking to retrieve some information, as past as possible
The JupyterLab workspace
The "running notebooks and kernels" tab
The file browser
-
Browse files -
Create new file / notebook / ... -
Move files around
Window management
Goal: adapt the layout to the task, typically to see more content at once, especially in low resolution (presentations)
-
change font size -
show/hide toolbars -
make the browser full-screen -
presentation mode (with link to RISE) -
tab management (e.g. notebooks side by side)
Best practices
- Cleaning up process: your notebook should be a story
- Be clear about what your current notebook is about
- a scratchpad
- a story
- ...
- Separate code and notebooks
Tools
-
Slides with RISE (depends on cell metadata), for teacher and student presentations See Intro Science Données, Semaine6/diaporama.md -
Dashboards with Voilà -
jupytext -
jupyter-book -
nbgrader (depends on cell metadata) -
nbconvert -
nbdime -
jupyterlite -
widgets -
magics -
jupytercards -
jupyterquiz -
jupytergraffiti -
line-by-line execution: nbtutor, debogger ... -
folding -
code reformating -
spelling/grammar checker
Publishing notebooks
-
forges (gitlab/github) -
nbviewer -
binder -
...
Reproducible environments
-
pip / conda
Tips and tricks
-
collect tips and tricks / advanced features from the web
Modification effectuée par Souphiane Jender