Référence : menus

Liste complète des entrées de la barre de menus, avec leurs raccourcis et les conditions dans lesquelles elles peuvent être choisies.

Une entrée marquée fichier requis est grisée quand aucune fenêtre n'est ouverte.

La barre porte toujours File, Edit, Search, Run, Code, Options, Window, Snippets, Golo et Help, dans cet ordre :

 File  Edit  Search  Run  Code  Options  Window  Snippets  Golo  Help

Le fichier d'outils d'un projet peut y ajouter ses propres menus, entre Golo et Help ; ils sont décrits sous Menus du projet plus bas.

File

Entrée	Raccourci	Fichier requis	Effet
New	`F4`		Ouvrir une fenêtre vide sans titre
Open…	`F3`		Ouvrir l'explorateur de fichiers et ouvrir ce qui est choisi
Save	`F2`	oui	Écrire le fichier ; demande un nom s'il n'en a pas
Save as…		oui	Demander un nom et écrire dedans, en adoptant ce chemin
Close	`Ctrl-W`	oui	Fermer la fenêtre courante, en proposant d'enregistrer d'abord
Exit	`Alt-X`		Quitter l'éditeur, en proposant d'enregistrer chaque fichier modifié

Edit

Entrée	Raccourci	Fichier requis	Effet
Undo	`Ctrl-Z`	oui	Annuler la dernière modification
Redo	`Ctrl-R`	oui	Rétablir la dernière modification annulée. `Ctrl-Y` le faisait avant ; il supprime désormais une ligne, comme dans Turbo C.
Insert line	`Ctrl-N`	oui	Ouvrir une ligne vide au-dessus du curseur, en laissant le curseur sur son propre texte
Delete line	`Ctrl-Y`	oui	Supprimer la ligne où est le curseur. Le curseur reste au même numéro de ligne : maintenir la touche en supprime une série.
Cut	`Maj-Suppr`	oui	Copier la sélection dans le presse-papier et la supprimer
Copy	`Ctrl-Inser`	oui	Copier la sélection dans le presse-papier
Paste	`Maj-Inser`	oui	Insérer le presse-papier, en remplaçant la sélection
Select all	`Ctrl-A`	oui	Sélectionner tout le fichier

Le presse-papier est partagé entre toutes les fenêtres d'une même session.

Search

Entrée	Raccourci	Fichier requis	Effet
Find…	`Ctrl-F`	oui	Demander un texte et des options, puis aller à la première occurrence
Find next	`F7`	oui	Aller à l'occurrence suivante, en bouclant en fin de fichier
Find previous	`Maj-F7`	oui	Aller à l'occurrence précédente, en bouclant en début de fichier
Go to line…	`Ctrl-G`	oui	Demander un numéro de ligne, à partir de un

Run

Entrée	Raccourci	Fichier requis	Effet
Completion	`Ctrl-Espace`	oui	Ouvrir la liste de complétion au curseur
Language server status			Indiquer si un serveur de langage tourne, et ce qu'il fait

Code

Tout ce que l'éditeur demande au serveur de langage à propos du symbole sous le curseur. Rien ici n'exige de sélection : presque toutes les requêtes du protocole prennent une position et non une plage, il n'y a donc rien de plus à dire en sélectionnant d'abord.

Sa touche d'accès est Alt-C.

Le serveur de Turbo Golo est golo lsp, l'interpréteur lui-même. Il répond à sept des huit entrées ci-dessous et publie les problèmes de lui-même ; la colonne Avec golo lsp dit ce qu'il advient de chacune.

Entrée	Raccourci	Fichier requis	Effet	Avec `golo lsp`
Describe symbol	`F1`	oui	Montre ce que le serveur de langage sait du symbole sous le curseur	Fonctionne : signature et documentation ; pour une fonction du fichier, les commentaires `#` écrits juste au-dessus
Go to definition	`F12`	oui	Où le symbole est déclaré. Une seule réponse l'ouvre ; plusieurs proposent la liste.	Fonctionne, dans le fichier : fonctions et unions du premier niveau
Go to type definition		oui	Où le type du symbole est déclaré, ce qui est une autre question	Répond qu'il n'y a rien : le serveur n'annonce pas `typeDefinition`
Find implementations…		oui	Ce qui l'implémente	Répond par la déclaration de la fonction, là où va Go to definition : Golo n'a pas d'interfaces, une fonction est sa propre implémentation
Find references…	`Shift-F12`	oui	Où il est utilisé, sa déclaration comprise	Fonctionne, dans le fichier : la déclaration et chaque appel
Symbol in file…		oui	Le plan du fichier, indenté, avec la sorte de chaque symbole. En choisir un y va.	Fonctionne : fonctions et unions du premier niveau, les variantes sous leur union
Symbol in project…	`Ctrl-T`	non	Demande un nom et cherche dans tout le projet	Fonctionne : fonctions, unions et noms de module de premier niveau de chaque fichier `.golo` sous la racine du projet, ouvert ou non ; un nom vide les liste tous
Problems…		non	Tous les problèmes signalés par le serveur, pour tous les fichiers dont il a parlé	Fonctionne : erreurs de syntaxe, confusion `:`/`.`, commentaires à la C ; une ligne entière à la fois

Une liste de lieux montre le fichier, la ligne, et le texte de cette ligne — douze entrées affichant shapes.golo:42 ne disent rien de celle qu'on veut. Le texte vient d'une fenêtre ouverte quand il y en a une : un fichier modifié et non enregistré est donc listé tel qu'il se lit maintenant.

Trois réponses sont distinguées, et la différence compte : rien trouvé le dit avec les mots de la question (No references found), le serveur n'est pas prêt montre ce qu'il est en train de faire, et une seule réponse vous y emmène sans dialogue.

Symbol in file n'a pas de raccourci, à dessein. Le raccourci évident serait Ctrl-Shift-O, et un terminal ne sait pas le distinguer de Ctrl-O — la touche Maj est perdue avant que l'éditeur ne la voie.

Options

Entrée	Fichier requis	Effet
Theme…		Lister tous les thèmes chargeables et appliquer immédiatement celui choisi. Si un fichier de réglages de projet existe, y écrit aussi le choix.
Line numbers	oui	Afficher ou masquer la gouttière dans la fenêtre courante
Create project settings		Écrire `.turbo-golo/settings.toml` avec le thème en cours, et l'ouvrir. Grisée dès que le projet en a un.
Project settings…		Ouvrir `.turbo-golo/settings.toml`. Grisée tant que le projet n'en a pas.

Window

Entrée	Raccourci	Fichier requis	Effet
Next	`F6`	oui	Passer au premier plan la fenêtre située derrière
New terminal	`F8`	non	Ouvrir une fenêtre exécutant un shell, dans le dossier du fichier au premier plan
Project tree	`F9`	non	Ouvrir une fenêtre montrant les fichiers du projet ; ramène l'existante au premier plan s'il y en a une
Tile		oui	Disposer toutes les fenêtres en grille, sans recouvrement
Cascade		oui	Empiler les fenêtres décalées, tous les titres visibles
Maximise		oui	Donner tout le bureau à la fenêtre courante, ou la remettre où elle était si elle l'a déjà. Le même bascule que la case `[■]` sur le cadre de la fenêtre.
List…	`Alt-0`	oui	Lister les fenêtres ouvertes et passer la choisie au premier plan

Snippets

Construit depuis .turbo-golo/snippets.toml et votre propre fichier à chaque ouverture. Sa touche d'accès est Alt-N, parce que Search répond déjà au S.

Entrée	Fichier requis	Effet
Un sous-menu par groupe		Insérer le snippet choisi au curseur ; les entrées exigent un fichier ouvert
Create snippets file	non	Écrire `.turbo-golo/snippets.toml` avec des exemples travaillés, puis l'ouvrir. Grisée dès que le projet en a un.
Open snippets file	non	Ouvrir `.turbo-golo/snippets.toml`. Grisée tant que le projet n'en a pas. Toujours le fichier du projet, jamais le vôtre.

Voir Snippets.

Golo

Construit depuis .turbo-golo/tools.toml à chaque ouverture. Sa touche d'accès est Alt-G : les menus fixes prennent F, E, S, R, C, O, W, N et H, et la première lettre du langage était libre.

Entrée	Effet
Une ligne par outil ne nommant aucun `menu`	Lancer cette commande, en montrant sa sortie là où l'outil le demande : une popup, une fenêtre terminal, ou une fenêtre d'édition
Create tools file	Écrire `.turbo-golo/tools.toml` avec les huit commandes GoloScript — exécuter, tester, déboguer, le REPL, un nouveau script, une compilation native et une en WebAssembly — et un exemple de menu à part, puis l'ouvrir. Grisée dès que le projet en a un.
Open tools file	Ouvrir `.turbo-golo/tools.toml`. Grisée tant que le projet n'en a pas.

Voir Outils Golo.

Menus du projet

Non fixes : un menu par nom de menu dans .turbo-golo/tools.toml, dans l'ordre où les noms y apparaissent pour la première fois, entre Golo et Help. Un projet sans fichier d'outils, ou dont tous les outils restent dans Golo, n'en a aucun. Le fichier de départ en crée un, Tools, qui contient un seul echo : c'est l'exemple du mécanisme.

Entrée	Effet
Une ligne par outil nommant ce menu	Lancer cette commande, en montrant sa sortie là où l'outil le demande

Leurs touches d'accès sont attribuées et non fixées, pour qu'un nom venu d'un fichier ne puisse jamais prendre une lettre à laquelle un des menus ci-dessus répond déjà. Les règles sont dans Outils Golo.

Help

Entrée	Effet
Keyboard	Afficher les touches à connaître
About	Afficher la version, le commit et la date de build quand le build les a enregistrés, et le thème courant. Voir le numéro de version.

Barre d'état

Les indices du bas sont cliquables et exécutent les mêmes actions.

Indice	Action
`F1 Describe`	Code ▸ Describe symbol
`F2 Save`	File ▸ Save
`F3 Open`	File ▸ Open…
`F6 Window`	Window ▸ Next
`F7 Next`	Search ▸ Find next
`F10 Menu`	Ouvrir la barre de menus
`Alt-X Exit`	File ▸ Exit

L'extrémité droite affiche, dans cet ordre : le curseur sous la forme ligne:colonne, puis soit la première erreur signalée par le serveur de langage pour ce fichier (précédée de ⚠), soit l'état du serveur de langage — LSP: ready quand golo lsp tourne, LSP: off quand aucun serveur n'a été demandé, et LSP: no golo — see https://codeberg.org/TypeUnsafe/golo-script/releases quand il n'a pas été trouvé.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158


# Référence : menus

> Liste complète des entrées de la barre de menus, avec leurs raccourcis et les conditions dans lesquelles elles peuvent être choisies.

Une entrée marquée **fichier requis** est grisée quand aucune fenêtre n'est ouverte.

La barre porte toujours File, Edit, Search, Run, Code, Options, Window, Snippets, Golo et Help, dans cet ordre :

```
 File  Edit  Search  Run  Code  Options  Window  Snippets  Golo  Help
```

Le fichier d'outils d'un projet peut y ajouter ses propres menus, entre Golo et Help ; ils sont décrits sous [Menus du projet](#menus-du-projet) plus bas.

## File

| Entrée | Raccourci | Fichier requis | Effet |
| --- | --- | --- | --- |
| New | `F4` | | Ouvrir une fenêtre vide sans titre |
| Open… | `F3` | | Ouvrir l'explorateur de fichiers et ouvrir ce qui est choisi |
| Save | `F2` | oui | Écrire le fichier ; demande un nom s'il n'en a pas |
| Save as… | | oui | Demander un nom et écrire dedans, en adoptant ce chemin |
| Close | `Ctrl-W` | oui | Fermer la fenêtre courante, en proposant d'enregistrer d'abord |
| Exit | `Alt-X` | | Quitter l'éditeur, en proposant d'enregistrer chaque fichier modifié |

## Edit

| Entrée | Raccourci | Fichier requis | Effet |
| --- | --- | --- | --- |
| Undo | `Ctrl-Z` | oui | Annuler la dernière modification |
| Redo | `Ctrl-R` | oui | Rétablir la dernière modification annulée. **`Ctrl-Y` le faisait avant** ; il supprime désormais une ligne, comme dans Turbo C. |
| Insert line | `Ctrl-N` | oui | Ouvrir une ligne vide au-dessus du curseur, en laissant le curseur sur son propre texte |
| Delete line | `Ctrl-Y` | oui | Supprimer la ligne où est le curseur. Le curseur reste au même numéro de ligne : maintenir la touche en supprime une série. |
| Cut | `Maj-Suppr` | oui | Copier la sélection dans le presse-papier et la supprimer |
| Copy | `Ctrl-Inser` | oui | Copier la sélection dans le presse-papier |
| Paste | `Maj-Inser` | oui | Insérer le presse-papier, en remplaçant la sélection |
| Select all | `Ctrl-A` | oui | Sélectionner tout le fichier |

Le presse-papier est partagé entre toutes les fenêtres d'une même session.

## Search

| Entrée | Raccourci | Fichier requis | Effet |
| --- | --- | --- | --- |
| Find… | `Ctrl-F` | oui | Demander un texte et des options, puis aller à la première occurrence |
| Find next | `F7` | oui | Aller à l'occurrence suivante, en bouclant en fin de fichier |
| Find previous | `Maj-F7` | oui | Aller à l'occurrence précédente, en bouclant en début de fichier |
| Go to line… | `Ctrl-G` | oui | Demander un numéro de ligne, à partir de un |

## Run

| Entrée | Raccourci | Fichier requis | Effet |
| --- | --- | --- | --- |
| Completion | `Ctrl-Espace` | oui | Ouvrir la liste de complétion au curseur |
| Language server status | | | Indiquer si un serveur de langage tourne, et ce qu'il fait |

## Code

Tout ce que l'éditeur demande au serveur de langage à propos du symbole **sous le curseur**. Rien ici n'exige de sélection : presque toutes les requêtes du protocole prennent une position et non une plage, il n'y a donc rien de plus à dire en sélectionnant d'abord.

Sa touche d'accès est `Alt-C`.

Le serveur de Turbo Golo est `golo lsp`, l'interpréteur lui-même. Il répond à sept des huit entrées ci-dessous et publie les problèmes de lui-même ; la colonne **Avec `golo lsp`** dit ce qu'il advient de chacune.

| Entrée | Raccourci | Fichier requis | Effet | Avec `golo lsp` |
| --- | --- | --- | --- | --- |
| Describe symbol | `F1` | oui | Montre ce que le serveur de langage sait du symbole sous le curseur | Fonctionne : signature et documentation ; pour une fonction du fichier, les commentaires `#` écrits juste au-dessus |
| Go to definition | `F12` | oui | Où le symbole est déclaré. Une seule réponse l'ouvre ; plusieurs proposent la liste. | Fonctionne, dans le fichier : fonctions et unions du premier niveau |
| Go to type definition | | oui | Où le *type* du symbole est déclaré, ce qui est une autre question | Répond qu'il n'y a rien : le serveur n'annonce pas `typeDefinition` |
| Find implementations… | | oui | Ce qui l'implémente | Répond par la déclaration de la fonction, là où va Go to definition : Golo n'a pas d'interfaces, une fonction est sa propre implémentation |
| Find references… | `Shift-F12` | oui | Où il est utilisé, sa déclaration comprise | Fonctionne, dans le fichier : la déclaration et chaque appel |
| Symbol in file… | | oui | Le plan du fichier, indenté, avec la sorte de chaque symbole. En choisir un y va. | Fonctionne : fonctions et unions du premier niveau, les variantes sous leur union |
| Symbol in project… | `Ctrl-T` | non | Demande un nom et cherche dans tout le projet | Fonctionne : fonctions, unions et noms de module de premier niveau de chaque fichier `.golo` sous la racine du projet, ouvert ou non ; un nom vide les liste tous |
| Problems… | | non | Tous les problèmes signalés par le serveur, pour tous les fichiers dont il a parlé | Fonctionne : erreurs de syntaxe, confusion `:`/`.`, commentaires à la C ; une ligne entière à la fois |

Une liste de lieux montre le fichier, la ligne, et le texte de cette ligne — douze entrées affichant `shapes.golo:42` ne disent rien de celle qu'on veut. Le texte vient d'une fenêtre ouverte quand il y en a une : un fichier modifié et non enregistré est donc listé tel qu'il se lit maintenant.

Trois réponses sont distinguées, et la différence compte : **rien trouvé** le dit avec les mots de la question (`No references found`), **le serveur n'est pas prêt** montre ce qu'il est en train de faire, et **une seule réponse** vous y emmène sans dialogue.

*Symbol in file* n'a pas de raccourci, à dessein. Le raccourci évident serait `Ctrl-Shift-O`, et un terminal ne sait pas le distinguer de `Ctrl-O` — la touche Maj est perdue avant que l'éditeur ne la voie.

## Options

| Entrée | Fichier requis | Effet |
| --- | --- | --- |
| Theme… | | Lister tous les thèmes chargeables et appliquer immédiatement celui choisi. Si un fichier de réglages de projet existe, y écrit aussi le choix. |
| Line numbers | oui | Afficher ou masquer la gouttière dans la fenêtre courante |
| Create project settings | | Écrire `.turbo-golo/settings.toml` avec le thème en cours, et l'ouvrir. **Grisée dès que le projet en a un.** |
| Project settings… | | Ouvrir `.turbo-golo/settings.toml`. **Grisée tant que le projet n'en a pas.** |

## Window

| Entrée | Raccourci | Fichier requis | Effet |
| --- | --- | --- | --- |
| Next | `F6` | oui | Passer au premier plan la fenêtre située derrière |
| New terminal | `F8` | non | Ouvrir une fenêtre exécutant un shell, dans le dossier du fichier au premier plan |
| Project tree | `F9` | non | Ouvrir une fenêtre montrant les fichiers du projet ; ramène l'existante au premier plan s'il y en a une |
| Tile | | oui | Disposer toutes les fenêtres en grille, sans recouvrement |
| Cascade | | oui | Empiler les fenêtres décalées, tous les titres visibles |
| Maximise | | oui | Donner tout le bureau à la fenêtre courante, ou la remettre où elle était si elle l'a déjà. Le même bascule que la case `[■]` sur le cadre de la fenêtre. |
| List… | `Alt-0` | oui | Lister les fenêtres ouvertes et passer la choisie au premier plan |

## Snippets

Construit depuis `.turbo-golo/snippets.toml` et votre propre fichier à chaque ouverture. Sa touche d'accès est `Alt-N`, parce que Search répond déjà au S.

| Entrée | Fichier requis | Effet |
| --- | --- | --- |
| Un sous-menu par groupe | | Insérer le snippet choisi au curseur ; les entrées exigent un fichier ouvert |
| Create snippets file | non | Écrire `.turbo-golo/snippets.toml` avec des exemples travaillés, puis l'ouvrir. **Grisée dès que le projet en a un.** |
| Open snippets file | non | Ouvrir `.turbo-golo/snippets.toml`. **Grisée tant que le projet n'en a pas.** Toujours le fichier du projet, jamais le vôtre. |

Voir [Snippets](snippets.md).

## Golo

Construit depuis `.turbo-golo/tools.toml` à chaque ouverture. Sa touche d'accès est `Alt-G` : les menus fixes prennent F, E, S, R, C, O, W, N et H, et la première lettre du langage était libre.

| Entrée | Effet |
| --- | --- |
| Une ligne par outil ne nommant aucun `menu` | Lancer cette commande, en montrant sa sortie là où l'outil le demande : une popup, une fenêtre terminal, ou une fenêtre d'édition |
| Create tools file | Écrire `.turbo-golo/tools.toml` avec les huit commandes GoloScript — exécuter, tester, déboguer, le REPL, un nouveau script, une compilation native et une en WebAssembly — et un exemple de menu à part, puis l'ouvrir. **Grisée dès que le projet en a un.** |
| Open tools file | Ouvrir `.turbo-golo/tools.toml`. **Grisée tant que le projet n'en a pas.** |

Voir [Outils Golo](golo-tools.md).

## Menus du projet

Non fixes : un menu par nom de `menu` dans `.turbo-golo/tools.toml`, dans l'ordre où les noms y apparaissent pour la première fois, entre Golo et Help. Un projet sans fichier d'outils, ou dont tous les outils restent dans Golo, n'en a aucun. Le fichier de départ en crée un, **Tools**, qui contient un seul `echo` : c'est l'exemple du mécanisme.

| Entrée | Effet |
| --- | --- |
| Une ligne par outil nommant ce menu | Lancer cette commande, en montrant sa sortie là où l'outil le demande |

Leurs touches d'accès sont attribuées et non fixées, pour qu'un nom venu d'un fichier ne puisse jamais prendre une lettre à laquelle un des menus ci-dessus répond déjà. Les règles sont dans [Outils Golo](golo-tools.md#touches-daccès).

## Help

| Entrée | Effet |
| --- | --- |
| Keyboard | Afficher les touches à connaître |
| About | Afficher la version, le commit et la date de build quand le build les a enregistrés, et le thème courant. Voir [le numéro de version](versioning.md). |

## Barre d'état

Les indices du bas sont cliquables et exécutent les mêmes actions.

| Indice | Action |
| --- | --- |
| `F1 Describe` | Code ▸ Describe symbol |
| `F2 Save` | File ▸ Save |
| `F3 Open` | File ▸ Open… |
| `F6 Window` | Window ▸ Next |
| `F7 Next` | Search ▸ Find next |
| `F10 Menu` | Ouvrir la barre de menus |
| `Alt-X Exit` | File ▸ Exit |

L'extrémité droite affiche, dans cet ordre : le curseur sous la forme `ligne:colonne`, puis soit la première erreur signalée par le serveur de langage pour ce fichier (précédée de `⚠`), soit l'état du serveur de langage — `LSP: ready` quand `golo lsp` tourne, `LSP: off` quand aucun serveur n'a été demandé, et `LSP: no golo — see https://codeberg.org/TypeUnsafe/golo-script/releases` quand il n'a pas été trouvé.