Installer et compiler Turbo Go

 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

# Installer et compiler Turbo Go

Ce guide montre comment obtenir un binaire `turbo-go` fonctionnel. Il suppose que vous avez Go 1.26 ou plus récent et que vous savez utiliser un terminal.

## La voie rapide, depuis un clone

```bash
git clone ssh://git@rickub.com/turbo-editors/turbo-go.git
cd turbo-go
make install
```

Cela compile l'éditeur, le place là où votre shell cherche ses commandes, et vous dit ce qu'il a trouvé : la version de Go, où le binaire a été posé, si ce répertoire est dans votre `PATH`, et si `gopls` est installé. La compilation passe d'abord par un fichier temporaire : un échec ne remplace jamais une installation qui marchait.

Ensuite, depuis n'importe quel projet Go :

```bash
turbo-go main.go
```

### Options

```bash
scripts/install.sh --prefix ~/bin     # installer ailleurs
scripts/install.sh --with-gopls       # installer aussi le serveur de langage
scripts/install.sh --uninstall        # le retirer  (make uninstall)
scripts/install.sh --help
```

Sans `--prefix`, l'éditeur va là où `go install` le mettrait : `$GOBIN`, ou `$GOPATH/bin` si `GOBIN` n'est pas défini — le plus souvent `~/go/bin`.

## Seulement compiler, sans installer

```bash
make build
./bin/turbo-go main.go
```

## Depuis le proxy de modules, sans clone

```bash
go install rickub.com/turbo-editors/turbo-go@latest
```

Si la commande est ensuite « introuvable », c'est que le répertoire d'installation n'est pas dans votre `PATH` :

```bash
export PATH="$PATH:$(go env GOPATH)/bin"
```

## Vérifier que ça marche

```bash
turbo-go -version
turbo-go -list-themes
```

La première nomme le commit dont le binaire a été construit, ce qu'il faut citer dans un rapport de bug ; [le numéro de version](../reference/versioning.md) explique ce que signifie chaque forme. La seconde affiche les thèmes compilés dans le binaire et vous indique où placer les vôtres.

## Variantes

- **Vous voulez juste l'essayer une fois** : `go run rickub.com/turbo-editors/turbo-go@latest main.go`
- **Vous voulez le binaire à un endroit précis** : `go build -o /usr/local/bin/turbo-go .`
- **Votre terminal ne gère pas les couleurs 24 bits** : utilisez `turbo-go -theme turbo-classic`, construit uniquement sur les seize couleurs ANSI. `turbo-dark` et `borland-light` utilisent des couleurs 24 bits.

## Quand quelque chose ne va pas

**`the installed binary does not run`.** L'installeur affiche juste au-dessus ce que le système a répondu — lisez-le d'abord, c'est lui qui nomme le vrai problème.

L'installeur **remplace** le binaire au lieu d'écrire par-dessus celui qui est là : une réinstallation donne donc au fichier une identité neuve. Cela compte sous macOS, qui met en cache la signature de code d'un binaire **par inode** : écrire de nouveaux octets dans l'ancien inode laisse une signature en cache qui décrit autre chose, et le noyau refuse alors d'exécuter un binaire qui s'est pourtant compilé et installé sans erreur. Si une ancienne copie a été installée par un outil qui employait `cp`, la supprimer d'abord efface cet état :

```bash
scripts/install.sh --uninstall
scripts/install.sh
```

**`Go x.y or later is needed`.** La version vient de `go.mod` : elle ne peut donc pas diverger de ce dont le code a réellement besoin. Mettez Go à jour, ou compilez depuis une étiquette correspondant à la chaîne d'outils dont vous disposez.

**`build failed; nothing was installed`.** Votre installation existante est intacte — la compilation passe d'abord par un fichier temporaire. La sortie du compilateur est affichée au-dessus du message.

## Exigences côté terminal

Turbo Go a besoin d'un terminal qui rapporte sa taille et gère la souris — tous les terminaux courants le font. Il lit `TERM` via tcell ; si l'affichage est incorrect, vérifiez que `TERM` correspond bien à votre terminal (`xterm-256color` est une valeur sûre).

## Voir aussi

- Toutes les options : [référence de la ligne de commande](../reference/cli.md)
- Faire marcher la complétion : [Activer la complétion Go](enable-completion.md)
- Une première session guidée : [Votre premier fichier dans Turbo Go](../tutorials/getting-started.md)