Conseils de lecture

Ce livre est réalisé avec mdbook, l’outil de documentation de la communauté Rust.

Zoom d’affichage

Les sites web modernes ont la fâcheuse habitude de gaspiller de l’espace disponible et d’user nos organes visuels prématurémement.

Je vous recommande vivement de régler le zoom d’affichage pour un confort optimal.
Niveau de zoom à mon avis confortable :

150 % pour un moniteur 1920 x 1080 ;
180 % pour un moniteur 2560 x 1440 ;
240 % pour un moniteur 3840 x 2160.

Nos yeux et nos oreilles sont précieux (et les dégâts que nous leur causons sont irréversibles) :
PRÉSERVONS-LES !

Blocs de codes

Cela permet de disposer d’un outil avec des blocs de codes Rust interactifs riches.

Tous les blocs de codes sont copiables directement ou avec le bouton « Copy to clipboard ».

Nous pouvons en plus :

les éditer (modifier) en nous plaçant dans le code et en supprimant ou saisissant du code ;
- un bouton permet de remettre le code dans son état d’origine si besoin ;
compiler le bloc de code ;
lorsque c’est prévu pour, exécuter le bloc de code.

Lorsque des codes comportent des exemples d’erreurs qui ne passent pas à la compilation, ces parties sont commentées. Décommentez-les, cliquez sur le bouton pour compiler et / ou exécuter, et lisez les retours du compilateur que vous obtenez à l’écran.

Vous pouvez également tout à loisir modifier le code et faire vos propres essais.

Exemple

Exercez-vous avec ce bloc simple :

retirez les // à gauche de x += 1; puis
cliquez sur « Run this code » (flèche « play »).
Cliquez sur le bouton pour rétablir le code (Undo changes) puis
cliquez sur « Run this code » (flèche « play ») à nouveau.

fn main() {
    let x = 7;
    // x += 1;  // Erreur à la compilation
}

Nota : les boutons interactifs apparaissent

lorsque nous survolons le bloc de code avec notre souris ou

lorsque nous touchons l’écran une première fois dans la zone du bloc de code (écrans tactiles de tablettes et d’ordiphones).

Note à propos des limitations

Certains comportements ne sont pas possibles avec l’espace de jeu (playground) Rust qui est utilisé pour ce faire.

C’est la raison pour laquelle certains codes retournent des erreurs de compilation sur le site alors qu’ils sont opérationnels « en conditions réelles ». C’est très rare, mais cela arrive (codes liés aux macros procédurales en fin de livre).

Dans de tels cas, copiez-collez le code dans une machine où Rust est installé pour les tester.

Lecture à deux niveaux

Vous croiserez parfois des blocs comme celui-ci :

Compléments de lecture (avancés)

Ces blocs contiennent des compléments utiles mais qui peuvent comporter des notions complexes.

Je vous recommande de réaliser DEUX LECTURES de ce livre :

ignorez ces blocs pendant la première ;
prenez le temps de les parcourir une fois que vous maîtrisez les concepts du premier niveau de lecture.

Nota :

Cliquez sur le bloc « Compléments de lecture (avancés) » pour le développer.

Cliquez à nouveau pour le réduire.

Utilisation des outils de mdbook

Prenez le temps d’interagir avec les espaces de ce site pour savoir ce que vous pouvez faire :

parcours facilité
- « tourner la page à droite » (flèche sur le côté droit) ;
- « tourner la page à gauche » (flèche sur le côté gauche) ;
options de l’inteface
- masquer la barre latérale (hamburger) ;
- modifier le thème d’affichage (pinceau) ;
- rechercher (loupe) ;
imprimer
- vous pouvez produire une version imprimable du contenu de l’ensemble de ce livre (imprimante à droite).
  - en perdant toutefois toute l’interactivité des blocs de code…
  - que vous pouvez enregistrer au format pdf pour le parcourir hors connexion par exemple.

Recherche au clavier

La recherche est accessible via le clavier :

s : ouvre recherche et place le curseur dans la zone de saisie.
Échappement : Ferme la recherche (conserve le contenu de la saisie).
Flèche Bas / Flèche Haut : navigue dans les résultats proposés.
Entrée : Ouvre le résultat surligné.

Retirer le surlignement

Pour retirer le surlignement une fois à bon port, il suffit de retirer les paramètres en fin d’URL.

Par exemple dans

https://apprendre-rust-par-l-exemple.marcjestin.fr/conseils_de_lecture.html?highlight=ceci%20est%20un%20test#zoom-daffichage

nous retirons le ? après .html et tout ce qui suit pour ne conserver que

https://apprendre-rust-par-l-exemple.marcjestin.fr/conseils_de_lecture.html

Keyboard shortcuts