turbo-editors/turbo-rust · getting-started.md

⑂ 5adadd10bd599bcb7e6091b2a7e061728f3afd16

getting-started.md · 205 lines · 6.1 KBmarkdown    Blame HistoryRaw
📦 Turbo Rust   1# Tutoriel : votre premier fichier dans Turbo Rust
3À la fin de ce tutoriel, vous aurez construit l'éditeur, écrit un petit programme Rust à l'intérieur, vu les mots-clés changer de couleur pendant que vous tapiez, enregistré le fichier et exécuté le programme. Cela prend une dizaine de minutes.
5Aucune connaissance préalable de Turbo Rust n'est nécessaire. Il vous faut Go 1.26 ou plus récent pour construire l'éditeur, et Rust pour exécuter ce que vous écrirez dedans.
7## Prérequis
9Vérifiez que Go est là — l'éditeur est écrit en Go, même si c'est un éditeur pour Rust :
12
15Vous devriez voir quelque chose comme :
18go version go1.26.5 linux/arm64
21Si cette commande échoue, installez d'abord Go : https://go.dev/dl/
23Vérifiez que Rust est là aussi :
26cargo --version
29Vous devriez voir quelque chose comme :
32cargo 1.97.1 (8bab26f4f 2026-07-14)
35Si cette commande échoue, installez Rust depuis https://rustup.rs
37## Étape 1 — Construire l'éditeur
39Depuis le répertoire du projet, tapez :
42
45Vous devriez voir une ligne `go build`, puis plus rien. Le silence est un succès : Go ne dit rien quand une construction fonctionne.
47Nous avons maintenant un exécutable dans `bin/turbo-rust`. Retenez où il est, pour pouvoir le lancer de n'importe où :
50export TURBO="$PWD/bin/turbo-rust"
53## Étape 2 — Créer un endroit où travailler
55Turbo Rust est à son meilleur à l'intérieur d'une caisse, alors créons-en une :
58cd /tmp && cargo new hello && cd hello
61Vous devriez voir :
64    Creating binary (application) `hello` package
67`cargo new` écrit un `Cargo.toml` et un `src/main.rs` contenant un hello-world. Nous allons remplacer le contenu de ce fichier par le nôtre.
69## Étape 3 — Ouvrir l'éditeur
71Lancez Turbo Rust sur le fichier que cargo vient de créer :
74$TURBO src/main.rs
77L'écran se remplit d'un bureau bleu. Vous devriez voir :
79- une **barre de menus** en haut : `File  Edit  Search  Run  Code  Options  Window  Snippets  Rust  Help`
80- une **fenêtre** encadrée d'un double trait, intitulée `main.rs`
81- une **barre d'état** en bas : `F1 Describe  F2 Save  F3 Open …`
83Le curseur clignote à la ligne 1, colonne 1 — la barre d'état affiche `1:1` à droite.
85Nous sommes dans l'éditeur.
87## Étape 4 — Vider le fichier et taper un programme Rust
89Appuyez sur **Ctrl-A** pour tout sélectionner, puis sur **Suppr** pour effacer ce que cargo avait écrit. La fenêtre est vide et son titre affiche `main.rs *` — l'étoile signifie qu'il y a des modifications non enregistrées.
91Tapez ces deux lignes, en appuyant sur Entrée à la fin de chacune :
94fn main() {
95    let name = "Turbo Rust";
98Regardez les couleurs pendant que vous tapez. `fn` et `let` deviennent **blanc et gras** dès que le mot se termine : ce sont des mots-clés. `main` devient **jaune et gras** dès que vous tapez le `(` qui suit, parce que cela en fait une fonction. `"Turbo Rust"` devient **vert** : c'est une chaîne.
100(Ce sont les couleurs de Turbo Classic, celles dans lesquelles l'éditeur démarre. L'étape 8 les change.)
102Appuyez sur **Entrée**. Regardez la nouvelle ligne : le curseur est *déjà* indenté comme la ligne précédente. Turbo Rust a recopié l'indentation, ce qui est ce que l'on veut neuf fois sur dix.
104Tapez la ligne suivante :
107println!("Hello from {name}!");
110`println!` devient **cyan et gras**, le `!` compris : une macro est un seul nom, et colorer le `!` à part le ferait lire comme une négation.
112> Quand vous tapez le `.` après un nom, la barre d'état affiche brièvement un message sur le serveur de langage. C'est normal : la complétion a besoin de `rust-analyzer`, que nous n'avons pas installé. Le [guide de la complétion](../how-to/enable-completion.md) s'en occupe plus tard ; ignorez-le pour l'instant.
114Appuyez sur **Entrée**, puis sur **Maj-Tab** pour retirer l'indentation, puis tapez l'accolade fermante :
120Nous venons d'écrire un programme Rust complet, l'éditeur le colorant au fur et à mesure.
122## Étape 5 — L'enregistrer
124Appuyez sur **F2**.
126L'étoile disparaît du titre, et la barre d'état affiche :
129Saved src/main.rs
132Nous venons d'écrire le fichier sur le disque.
134## Étape 6 — Regarder le fichier de l'extérieur
136Quittez l'éditeur avec **Alt-X**. Le terminal revient comme il était.
138Vérifiez ce que nous avons écrit :
141cat src/main.rs
144Vous devriez voir :
147fn main() {
148    let name = "Turbo Rust";
149    println!("Hello from {name}!");
153## Étape 7 — L'exécuter
156
159Vous devriez voir, après une ligne ou deux de cargo :
162Hello from Turbo Rust!
165C'est un programme Rust qui fonctionne, écrit entièrement dans l'éditeur.
167## Étape 8 — Changer de thème
169Rouvrez le fichier :
172$TURBO src/main.rs
175Appuyez sur **F10**. Le menu `File` s'ouvre. Appuyez cinq fois sur **→** : le menu se déplace le long de la barre jusqu'à `Options`, dont le premier élément, `Theme…`, est mis en évidence. Appuyez sur **Entrée**.
177Une liste de onze apparaît, par ordre alphabétique, le thème que vous utilisez étant déjà mis en évidence :
180borland-light
181
182catppuccin-frappe
183catppuccin-latte
186intellij-light
187monochrome-dark
188monochrome-light
189turbo-classic
190
193`turbo-classic` est la ligne en évidence, puisque c'est le thème dans lequel vous êtes. Appuyez une fois sur **↓** pour aller sur `turbo-dark`, puis sur **Entrée**.
195Tout l'éditeur se repeint en gris foncé, et la barre d'état affiche `Theme: Turbo Dark`.
197Appuyez sur **Alt-X** pour sortir.
199## Et maintenant ?
201Vous avez construit l'éditeur, écrit un programme Rust dedans, l'avez enregistré, exécuté, et vous en avez changé l'apparence.
203- Pour faire des choses précises — activer la complétion, écrire votre propre thème, chercher dans un fichier → voir les [guides pratiques](../how-to/)
204- Pour retrouver une touche ou une entrée de menu → voir la [référence](../reference/)
205- Pour comprendre comment la coloration et la complétion fonctionnent vraiment → voir les [explications](../explanation/)

📦 Turbo Rust 713ea5c k33g yesterday	1	# Tutoriel : votre premier fichier dans Turbo Rust
	2
	3	À la fin de ce tutoriel, vous aurez construit l'éditeur, écrit un petit programme Rust à l'intérieur, vu les mots-clés changer de couleur pendant que vous tapiez, enregistré le fichier et exécuté le programme. Cela prend une dizaine de minutes.
	4
	5	Aucune connaissance préalable de Turbo Rust n'est nécessaire. Il vous faut Go 1.26 ou plus récent pour construire l'éditeur, et Rust pour exécuter ce que vous écrirez dedans.
	6
	7	## Prérequis
	8
	9	Vérifiez que Go est là — l'éditeur est écrit en Go, même si c'est un éditeur pour Rust :
	10
	11	```bash
	12	go version
	13	```
	14
	15	Vous devriez voir quelque chose comme :
	16
	17	```
	18	go version go1.26.5 linux/arm64
	19	```
	20
	21	Si cette commande échoue, installez d'abord Go : https://go.dev/dl/
	22
	23	Vérifiez que Rust est là aussi :
	24
	25	```bash
	26	cargo --version
	27	```
	28
	29	Vous devriez voir quelque chose comme :
	30
	31	```
	32	cargo 1.97.1 (8bab26f4f 2026-07-14)
	33	```
	34
	35	Si cette commande échoue, installez Rust depuis https://rustup.rs
	36
	37	## Étape 1 — Construire l'éditeur
	38
	39	Depuis le répertoire du projet, tapez :
	40
	41	```bash
	42	make build
	43	```
	44
	45	Vous devriez voir une ligne `go build`, puis plus rien. Le silence est un succès : Go ne dit rien quand une construction fonctionne.
	46
	47	Nous avons maintenant un exécutable dans `bin/turbo-rust`. Retenez où il est, pour pouvoir le lancer de n'importe où :
	48
	49	```bash
	50	export TURBO="$PWD/bin/turbo-rust"
	51	```
	52
	53	## Étape 2 — Créer un endroit où travailler
	54
	55	Turbo Rust est à son meilleur à l'intérieur d'une caisse, alors créons-en une :
	56
	57	```bash
	58	cd /tmp && cargo new hello && cd hello
	59	```
	60
	61	Vous devriez voir :
	62
	63	```
	64	Creating binary (application) `hello` package
65	```
66
67	`cargo new` écrit un `Cargo.toml` et un `src/main.rs` contenant un hello-world. Nous allons remplacer le contenu de ce fichier par le nôtre.
68
69	## Étape 3 — Ouvrir l'éditeur
70
71	Lancez Turbo Rust sur le fichier que cargo vient de créer :
72
73	```bash
74	$TURBO src/main.rs
75	```
76
77	L'écran se remplit d'un bureau bleu. Vous devriez voir :
78
79	- une barre de menus en haut : `File Edit Search Run Code Options Window Snippets Rust Help`
80	- une fenêtre encadrée d'un double trait, intitulée `main.rs`
81	- une barre d'état en bas : `F1 Describe F2 Save F3 Open …`
82
83	Le curseur clignote à la ligne 1, colonne 1 — la barre d'état affiche `1:1` à droite.
84
85	Nous sommes dans l'éditeur.
86
87	## Étape 4 — Vider le fichier et taper un programme Rust
88
89	Appuyez sur Ctrl-A pour tout sélectionner, puis sur Suppr pour effacer ce que cargo avait écrit. La fenêtre est vide et son titre affiche `main.rs *` — l'étoile signifie qu'il y a des modifications non enregistrées.
90
91	Tapez ces deux lignes, en appuyant sur Entrée à la fin de chacune :
92
93	```rust
94	fn main() {
95	let name = "Turbo Rust";
96	```
97
98	Regardez les couleurs pendant que vous tapez. `fn` et `let` deviennent blanc et gras dès que le mot se termine : ce sont des mots-clés. `main` devient jaune et gras dès que vous tapez le `(` qui suit, parce que cela en fait une fonction. `"Turbo Rust"` devient vert : c'est une chaîne.
99
100	(Ce sont les couleurs de Turbo Classic, celles dans lesquelles l'éditeur démarre. L'étape 8 les change.)
101
102	Appuyez sur Entrée. Regardez la nouvelle ligne : le curseur est déjà indenté comme la ligne précédente. Turbo Rust a recopié l'indentation, ce qui est ce que l'on veut neuf fois sur dix.
103
104	Tapez la ligne suivante :
105
106	```rust
107	println!("Hello from {name}!");
108	```
109
110	`println!` devient cyan et gras, le `!` compris : une macro est un seul nom, et colorer le `!` à part le ferait lire comme une négation.
111
112	> Quand vous tapez le `.` après un nom, la barre d'état affiche brièvement un message sur le serveur de langage. C'est normal : la complétion a besoin de `rust-analyzer`, que nous n'avons pas installé. Le [guide de la complétion](../how-to/enable-completion.md) s'en occupe plus tard ; ignorez-le pour l'instant.
113
114	Appuyez sur Entrée, puis sur Maj-Tab pour retirer l'indentation, puis tapez l'accolade fermante :
115
116	```rust
117	}
118	```
119
120	Nous venons d'écrire un programme Rust complet, l'éditeur le colorant au fur et à mesure.
121
122	## Étape 5 — L'enregistrer
123
124	Appuyez sur F2.
125
126	L'étoile disparaît du titre, et la barre d'état affiche :
127
128	```
129	Saved src/main.rs
130	```
131
132	Nous venons d'écrire le fichier sur le disque.
133
134	## Étape 6 — Regarder le fichier de l'extérieur
135
136	Quittez l'éditeur avec Alt-X. Le terminal revient comme il était.
137
138	Vérifiez ce que nous avons écrit :
139
140	```bash
141	cat src/main.rs
142	```
143
144	Vous devriez voir :
145
146	```rust
147	fn main() {
148	let name = "Turbo Rust";
149	println!("Hello from {name}!");
150	}
151	```
152
153	## Étape 7 — L'exécuter
154
155	```bash
156	cargo run
157	```
158
159	Vous devriez voir, après une ligne ou deux de cargo :
160
161	```
162	Hello from Turbo Rust!
163	```
164
165	C'est un programme Rust qui fonctionne, écrit entièrement dans l'éditeur.
166
167	## Étape 8 — Changer de thème
168
169	Rouvrez le fichier :
170
171	```bash
172	$TURBO src/main.rs
173	```
174
175	Appuyez sur F10. Le menu `File` s'ouvre. Appuyez cinq fois sur → : le menu se déplace le long de la barre jusqu'à `Options`, dont le premier élément, `Theme…`, est mis en évidence. Appuyez sur Entrée.
176
177	Une liste de onze apparaît, par ordre alphabétique, le thème que vous utilisez étant déjà mis en évidence :
178
179	```
180	borland-light
181	cappuccino
182	catppuccin-frappe
183	catppuccin-latte
184	cobalt
185	darcula
186	intellij-light
187	monochrome-dark
188	monochrome-light
189	turbo-classic
190	turbo-dark
191	```
192
193	`turbo-classic` est la ligne en évidence, puisque c'est le thème dans lequel vous êtes. Appuyez une fois sur ↓ pour aller sur `turbo-dark`, puis sur Entrée.
194
195	Tout l'éditeur se repeint en gris foncé, et la barre d'état affiche `Theme: Turbo Dark`.
196
197	Appuyez sur Alt-X pour sortir.
198
199	## Et maintenant ?
200
201	Vous avez construit l'éditeur, écrit un programme Rust dedans, l'avez enregistré, exécuté, et vous en avez changé l'apparence.
202
203	- Pour faire des choses précises — activer la complétion, écrire votre propre thème, chercher dans un fichier → voir les [guides pratiques](../how-to/)
204	- Pour retrouver une touche ou une entrée de menu → voir la [référence](../reference/)
205	- Pour comprendre comment la coloration et la complétion fonctionnent vraiment → voir les [explications](../explanation/)