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

⑂ v1.0.1

getting-started.md · 202 lines · 5.5 KBmarkdown    Blame HistoryRaw
   1# Tutoriel : votre premier fichier dans Turbo Go
3À la fin de ce tutoriel, vous aurez compilé l'éditeur, écrit un petit programme Go à l'intérieur, vu les mots-clés se colorer au fil de la frappe, enregistré le fichier et exécuté le programme. Comptez une dizaine de minutes.
5Aucune connaissance préalable de Turbo Go n'est nécessaire. Il vous faut Go 1.26 ou plus récent et un terminal — rien d'autre.
7## Prérequis
9Vérifiez que Go est présent :
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/
23## Étape 1 — Compiler l'éditeur
25Depuis le répertoire du projet, tapez :
28
31Vous devriez voir :
34go build -o bin/turbo-go .
37puis plus rien. Le silence est le signe du succès : Go ne dit rien quand une compilation réussit.
39Nous avons maintenant un exécutable dans `bin/turbo-go`. Retenons où il est, pour pouvoir le lancer de n'importe où :
42export TURBO="$PWD/bin/turbo-go"
45## Étape 2 — Créer un endroit où travailler
47Turbo Go donne le meilleur de lui-même à l'intérieur d'un module Go ; créons-en un :
50mkdir -p /tmp/hello && cd /tmp/hello
51go mod init hello
54Vous devriez voir :
57go: creating new go.mod: module hello
60Nous venons de créer un module Go vide.
62## Étape 3 — Ouvrir l'éditeur
64Lancez Turbo Go sur un fichier qui n'existe pas encore :
67$TURBO main.go
70L'écran se remplit d'un bureau bleu. Vous devriez voir :
72- une **barre de menus** en haut : `File  Edit  Search  Run  Code  Options  Window  Snippets  Go  Help`
73- une **fenêtre** encadrée d'un double trait, intitulée `main.go`
74- une **barre d'état** en bas : `F1 Describe  F2 Save  F3 Open …`
76Le curseur clignote ligne 1, colonne 1 — la barre d'état affiche `1:1` à droite.
78Nous sommes dans l'éditeur.
80## Étape 4 — Écrire un programme Go
82Tapez ces cinq lignes, en appuyant sur Entrée à la fin de chacune :
85package main
87import "fmt"
89func main() {
92Observez les couleurs pendant que vous tapez. `package`, `import` et `func` deviennent **blanc gras** dès que le mot est terminé : ce sont des mots-clés. `"fmt"` devient **vert** : c'est une chaîne. `main` devient **jaune gras** dès que vous tapez la `(` qui le suit, car cela en fait une fonction.
94Appuyez maintenant sur **Tab**. Le curseur saute en colonne 9 — la barre d'état à droite passe à `5:2`, parce qu'une tabulation occupe un seul caractère dans le fichier même si elle remplit huit colonnes à l'écran.
96Tapez le corps de la fonction :
99fmt.Println("Hello from Turbo Go!")
102> Quand vous tapez le `.` après `fmt`, la barre d'état affiche brièvement un message à propos du serveur de langage. C'est normal : la complétion a besoin de `gopls`, 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.
104Appuyez sur **Entrée**. Regardez la nouvelle ligne : le curseur est *déjà* en colonne 9. Turbo Go a recopié l'indentation de la ligne précédente, ce qui est ce que l'on veut neuf fois sur dix.
106Cette fois nous n'en voulons pas : appuyez sur **Maj-Tab** pour retirer cette indentation, puis tapez l'accolade fermante :
112Le titre de la fenêtre affiche désormais `main.go *`. L'étoile signale des modifications non enregistrées.
114Nous venons d'écrire un programme Go complet, coloré au fil de la frappe.
116## Étape 5 — L'enregistrer
118Appuyez sur **F2**.
120L'étoile disparaît du titre et la barre d'état affiche :
123Saved main.go
126Nous venons d'écrire le fichier sur le disque.
128## Étape 6 — Regarder le fichier depuis l'extérieur
130Quittez l'éditeur avec **Alt-X**. Le terminal revient tel qu'il était.
132Vérifiez ce que nous avons écrit :
135cat main.go
138Vous devriez voir :
141package main
143import "fmt"
145func main() {
146	fmt.Println("Hello from Turbo Go!")
150## Étape 7 — L'exécuter
153go run main.go
156Vous devriez voir :
159Hello from Turbo Go!
162C'est un programme Go qui fonctionne, écrit entièrement dans l'éditeur.
164## Étape 8 — Changer de thème
166Rouvrez le fichier :
169$TURBO main.go
172Appuyez sur **F10**. Le menu `File` se déroule. Appuyez cinq fois sur **→** : le menu se déplace le long de la barre jusqu'à `Options`, dont la première entrée, `Theme…`, est surlignée. Appuyez sur **Entrée**.
174Une liste de onze apparaît, par ordre alphabétique, le thème que vous utilisez étant déjà mis en évidence :
177borland-light
178
179catppuccin-frappe
180catppuccin-latte
183intellij-light
184monochrome-dark
185monochrome-light
186turbo-classic
187
190`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**.
192Tout l'éditeur se repeint en gris sombre, et la barre d'état affiche `Theme: Turbo Dark`.
194Appuyez sur **Alt-X** pour quitter.
196## Et maintenant ?
198Vous avez compilé l'éditeur, écrit un programme Go dedans, l'avez enregistré, exécuté, et vous avez changé son apparence.
200- 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/)
201- Pour retrouver une touche ou une entrée de menu → voir la [référence](../reference/)
202- Pour comprendre comment fonctionnent réellement la coloration et la complétion → voir les [explications](../explanation/)

📦 Turbo Go 3d7798b k33g 13h ago	1	# Tutoriel : votre premier fichier dans Turbo Go
	2
	3	À la fin de ce tutoriel, vous aurez compilé l'éditeur, écrit un petit programme Go à l'intérieur, vu les mots-clés se colorer au fil de la frappe, enregistré le fichier et exécuté le programme. Comptez une dizaine de minutes.
	4
	5	Aucune connaissance préalable de Turbo Go n'est nécessaire. Il vous faut Go 1.26 ou plus récent et un terminal — rien d'autre.
	6
	7	## Prérequis
	8
	9	Vérifiez que Go est présent :
	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	## Étape 1 — Compiler l'éditeur
	24
	25	Depuis le répertoire du projet, tapez :
	26
	27	```bash
	28	make build
	29	```
	30
	31	Vous devriez voir :
	32
	33	```
	34	go build -o bin/turbo-go .
	35	```
	36
	37	puis plus rien. Le silence est le signe du succès : Go ne dit rien quand une compilation réussit.
	38
	39	Nous avons maintenant un exécutable dans `bin/turbo-go`. Retenons où il est, pour pouvoir le lancer de n'importe où :
	40
	41	```bash
	42	export TURBO="$PWD/bin/turbo-go"
	43	```
	44
	45	## Étape 2 — Créer un endroit où travailler
	46
	47	Turbo Go donne le meilleur de lui-même à l'intérieur d'un module Go ; créons-en un :
	48
	49	```bash
	50	mkdir -p /tmp/hello && cd /tmp/hello
	51	go mod init hello
	52	```
	53
	54	Vous devriez voir :
	55
	56	```
	57	go: creating new go.mod: module hello
	58	```
	59
	60	Nous venons de créer un module Go vide.
	61
	62	## Étape 3 — Ouvrir l'éditeur
	63
	64	Lancez Turbo Go sur un fichier qui n'existe pas encore :
65
66	```bash
67	$TURBO main.go
68	```
69
70	L'écran se remplit d'un bureau bleu. Vous devriez voir :
71
72	- une barre de menus en haut : `File Edit Search Run Code Options Window Snippets Go Help`
73	- une fenêtre encadrée d'un double trait, intitulée `main.go`
74	- une barre d'état en bas : `F1 Describe F2 Save F3 Open …`
75
76	Le curseur clignote ligne 1, colonne 1 — la barre d'état affiche `1:1` à droite.
77
78	Nous sommes dans l'éditeur.
79
80	## Étape 4 — Écrire un programme Go
81
82	Tapez ces cinq lignes, en appuyant sur Entrée à la fin de chacune :
83
84	```go
85	package main
86
87	import "fmt"
88
89	func main() {
90	```
91
92	Observez les couleurs pendant que vous tapez. `package`, `import` et `func` deviennent blanc gras dès que le mot est terminé : ce sont des mots-clés. `"fmt"` devient vert : c'est une chaîne. `main` devient jaune gras dès que vous tapez la `(` qui le suit, car cela en fait une fonction.
93
94	Appuyez maintenant sur Tab. Le curseur saute en colonne 9 — la barre d'état à droite passe à `5:2`, parce qu'une tabulation occupe un seul caractère dans le fichier même si elle remplit huit colonnes à l'écran.
95
96	Tapez le corps de la fonction :
97
98	```go
99	fmt.Println("Hello from Turbo Go!")
100	```
101
102	> Quand vous tapez le `.` après `fmt`, la barre d'état affiche brièvement un message à propos du serveur de langage. C'est normal : la complétion a besoin de `gopls`, 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.
103
104	Appuyez sur Entrée. Regardez la nouvelle ligne : le curseur est déjà en colonne 9. Turbo Go a recopié l'indentation de la ligne précédente, ce qui est ce que l'on veut neuf fois sur dix.
105
106	Cette fois nous n'en voulons pas : appuyez sur Maj-Tab pour retirer cette indentation, puis tapez l'accolade fermante :
107
108	```go
109	}
110	```
111
112	Le titre de la fenêtre affiche désormais `main.go *`. L'étoile signale des modifications non enregistrées.
113
114	Nous venons d'écrire un programme Go complet, coloré au fil de la frappe.
115
116	## Étape 5 — L'enregistrer
117
118	Appuyez sur F2.
119
120	L'étoile disparaît du titre et la barre d'état affiche :
121
122	```
123	Saved main.go
124	```
125
126	Nous venons d'écrire le fichier sur le disque.
127
128	## Étape 6 — Regarder le fichier depuis l'extérieur
129
130	Quittez l'éditeur avec Alt-X. Le terminal revient tel qu'il était.
131
132	Vérifiez ce que nous avons écrit :
133
134	```bash
135	cat main.go
136	```
137
138	Vous devriez voir :
139
140	```go
141	package main
142
143	import "fmt"
144
145	func main() {
146	fmt.Println("Hello from Turbo Go!")
147	}
148	```
149
150	## Étape 7 — L'exécuter
151
152	```bash
153	go run main.go
154	```
155
156	Vous devriez voir :
157
158	```
159	Hello from Turbo Go!
160	```
161
162	C'est un programme Go qui fonctionne, écrit entièrement dans l'éditeur.
163
164	## Étape 8 — Changer de thème
165
166	Rouvrez le fichier :
167
168	```bash
169	$TURBO main.go
170	```
171
172	Appuyez sur F10. Le menu `File` se déroule. Appuyez cinq fois sur → : le menu se déplace le long de la barre jusqu'à `Options`, dont la première entrée, `Theme…`, est surlignée. Appuyez sur Entrée.
173
174	Une liste de onze apparaît, par ordre alphabétique, le thème que vous utilisez étant déjà mis en évidence :
175
176	```
177	borland-light
178	cappuccino
179	catppuccin-frappe
180	catppuccin-latte
181	cobalt
182	darcula
183	intellij-light
184	monochrome-dark
185	monochrome-light
186	turbo-classic
187	turbo-dark
188	```
189
190	`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.
191
192	Tout l'éditeur se repeint en gris sombre, et la barre d'état affiche `Theme: Turbo Dark`.
193
194	Appuyez sur Alt-X pour quitter.
195
196	## Et maintenant ?
197
198	Vous avez compilé l'éditeur, écrit un programme Go dedans, l'avez enregistré, exécuté, et vous avez changé son apparence.
199
200	- 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/)
201	- Pour retrouver une touche ou une entrée de menu → voir la [référence](../reference/)
202	- Pour comprendre comment fonctionnent réellement la coloration et la complétion → voir les [explications](../explanation/)