Installer et compiler Turbo JS

 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

# Installer et compiler Turbo JS

Ce guide montre comment obtenir un binaire `turbo-js` 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-js.git
cd turbo-js
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 `typescript-language-server` — le serveur de langage — 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 dossier contenant un script JavaScript :

```bash
turbo-js main.js
```

### Options

```bash
scripts/install.sh --prefix ~/bin     # installer ailleurs
scripts/install.sh --with-server      # 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`.

`--with-server` lance `npm install -g typescript-language-server typescript@6`, qui installe le serveur de langage et le TypeScript dont il dépend là où npm dépose ses binaires globaux. Il a besoin de `npm`, donc de Node. Le `@6` n'est pas facultatif : TypeScript 7 ne livre pas de `tsserver.js`, et le serveur refuse de démarrer à côté de lui. Si Node manque encore, voir [Installer Node.js](install-node.md).

## Seulement compiler, sans installer

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

`make build` vérifie aussitôt que le binaire produit annonce la version attendue ; c'est pour cela qu'il appelle `scripts/check-version.sh` derrière `go build`.

## Depuis le proxy de modules, sans clone

```bash
go install rickub.com/turbo-editors/turbo-js@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-js -version
turbo-js -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-js@latest main.js`
- **Vous voulez le binaire à un endroit précis** : `go build -o /usr/local/bin/turbo-js .`
- **Votre terminal ne gère pas les couleurs 24 bits** : utilisez `turbo-js -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.

**La barre d'état dit `LSP: no typescript-language-server — npm install -g typescript-language-server typescript@6`.** L'éditeur fonctionne, mais sans complétion : `typescript-language-server` n'est ni dans le `PATH`, ni dans les dossiers où npm, nvm, pnpm et Volta déposent leurs binaires globaux, ni dans `/usr/local/bin` ou `/opt/homebrew/bin`. Voir [Activer la complétion JavaScript](enable-completion.md).

## Exigences côté terminal

Turbo JS 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 JavaScript](enable-completion.md)
- Une première session guidée : [Votre premier programme JavaScript dans Turbo JS](../tutorials/getting-started.md)
- Des projets pour l'essayer : [les démos](../../../demos/)