Documentation de turbo-core

 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

# Documentation de turbo-core

turbo-core est la bibliothèque sur laquelle repose chaque éditeur Turbo. Turbo Go, Turbo Rust, Turbo Python, Turbo MoonBit, Turbo Golo et Turbo JS sont le même éditeur avec six valeurs différentes d'un même type.

Cette documentation suit [Diátaxis](https://diataxis.fr) : quatre sortes de pages, chacune répondant à une sorte de question.

## [Tutoriels](tutorials/) — apprendre en faisant

- [Construire un éditeur](tutorials/build-an-editor.md) — un IDE de terminal complet pour votre propre langage, en quatre-vingts lignes environ.

## [Guides pratiques](how-to/) — faire une chose précise

- [Ajouter un langage](how-to/add-a-language.md) — écrire un analyseur et l'enregistrer.
- [Dialoguer avec un serveur de langage](how-to/talk-to-a-language-server.md) — brancher l'éditeur sur gopls, rust-analyzer, ou tout autre serveur LSP.
- [Écrire les fichiers de départ](how-to/write-the-starter-files.md) — les modèles de réglages, d'extraits et d'outils que votre éditeur propose de créer.
- [Lancer les tests](how-to/run-the-tests.md) — la commande unique, et ce qu'elle couvre.
- [Tester sans publier](how-to/test-without-publishing.md) — faire tourner les éditeurs sur un turbo-core modifié seulement en local.
- [Publier la bibliothèque](how-to/release-the-library.md) — poser une version dont les éditeurs peuvent dépendre.

## [Référence](reference/) — les détails exacts

- [Profile](reference/profile.md) — tous les champs du type par lequel les éditeurs diffèrent.
- [Paquets](reference/packages.md) — ce que contient chaque paquet, et ce dont il a le droit de dépendre.
- [Le point d'extension syntaxique](reference/syntax.md) — `Definition`, `Register`, `LineScanner`, `LineIndex`.
- [L'API app](reference/app.md) — ce qu'une commande peut appeler sur un éditeur en marche.

## [Explications](explanation/) — pourquoi c'est ainsi

- [Architecture](explanation/architecture.md) — la forme de la bibliothèque, et la règle qui la maintient.
- [Ce qui appartient ici](explanation/what-belongs-here.md) — la frontière entre la bibliothèque et un éditeur bâti dessus, et comment elle a été tracée.

## Où sont les éditeurs

- **Turbo Go** — `codeberg.org/turbo-editors/turbo-go`
- **Turbo Rust** — `codeberg.org/turbo-editors/turbo-rust`

Les deux sont minces : une commande, un profil, un analyseur. Si vous cherchez comment *utiliser* l'un d'eux, c'est sa propre documentation qu'il faut lire.