mdBook : Cacher des parties du code Rust

Il est possible de cacher des parties de code en insérant un croisillon suivi d’une espace # au début des lignes que l’on souhaite cacher.

Par exemple :

```rust
# use std::any::type_name;
#
fn type_of<T>(_: T) -> &'static str {
	type_name::<T>()
}

fn main() {
# 	let x = 11;
# 	let y = 11.;
# 	let z = "Merci";
#    
	println!("Type de x définie par let x = {x:?} : {}", type_of(x));
	println!("Type de y définie par let y = {y:?} : {}", type_of(y));
	println!("Type de z définie par let z = {z:?} : {}", type_of(z));
}
```

affiche :

use std::any::type_name;

fn type_of<T>(_: T) -> &'static str {
	type_name::<T>()
}

fn main() {
	let x = 11;
	let y = 11.;
	let z = "Merci";
   
	println!("Type de x définie par let x = {x:?} : {}", type_of(x));
	println!("Type de y définie par let y = {y:?} : {}", type_of(y));
	println!("Type de z définie par let z = {z:?} : {}", type_of(z));
}

Le·la lecteur·trice peut afficher / masquer les lignes concernées en cliquant sur l’œil qui est proposé automatiquement lorsque la fonction est utilisable.

L’intérêt de la manœuvre est de masquer une partie du code pour rendre l’affichage plus lisible tout en laissant ce code à disposition :

• pour le lecteur·trice intéressé·e à en savoir plus ;
• pour le compilateur qui peut ainsi faire tourner le code complet, code qui ne serait plus valide si nous supprimions réellement ces lignes plutôt que de simplement les masquer.

Nota : Malheureusement, cette fonction n’est pas accessible dans des blocs de code marqués comme editable.