wip(docs): i18n (#12681)
This commit is contained in:
Adam
@@ -0,0 +1,188 @@
|
||||
---
|
||||
title: Serveurs LSP
|
||||
description: OpenCode s'intègre à vos serveurs LSP.
|
||||
---
|
||||
|
||||
OpenCode s'intègre à votre protocole de serveur de langue (LSP) pour aider le LLM à interagir avec votre base de code. Il utilise des diagnostics pour fournir des commentaires au LLM.
|
||||
|
||||
---
|
||||
|
||||
## Intégré
|
||||
|
||||
OpenCode est livré avec plusieurs serveurs LSP intégrés pour les langues populaires :
|
||||
|
||||
| Serveur LSP | Rallonges | Exigences |
|
||||
| ------------------ | ------------------------------------------------------------------- | ------------------------------------------------------------ |
|
||||
| astro | .astro | Installations automatiques pour les projets Astro |
|
||||
| coup | .sh, .bash, .zsh, .ksh | Installe automatiquement le serveur bash-langage |
|
||||
| clangd | .c, .cpp, .cc, .cxx, .c++, .h, .hpp, .hh, .hxx, .h++ | Installations automatiques pour les projets C/C++ |
|
||||
| cpointu | .cs | `.NET SDK` installé |
|
||||
| clojure-lsp | .clj, .cljs, .cljc, .edn | Commande `clojure-lsp` disponible |
|
||||
| fléchette | .dart | Commande `dart` disponible |
|
||||
| déno | .ts, .tsx, .js, .jsx, .mjs | Commande `deno` disponible (détection automatique deno.json/deno.jsonc) |
|
||||
| élixir-ls | .ex, .ex | Commande `elixir` disponible |
|
||||
| eslint | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts, .vue | Dépendance `eslint` dans le projet |
|
||||
| fsharp | .fs, .fsi, .fsx, .fsscript | `.NET SDK` installé |
|
||||
| lueur | .lueur | Commande `gleam` disponible |
|
||||
| gopls | .aller | Commande `go` disponible |
|
||||
| hls | .hs, .lhs | Commande `haskell-language-server-wrapper` disponible |
|
||||
| jdtls | .java | `Java SDK (version 21+)` installé |
|
||||
| kotlin-ls | .kt, .kts | Installations automatiques pour les projets Kotlin |
|
||||
| lua-ls | .lua | Installations automatiques pour les projets Lua |
|
||||
| rien | .nix | Commande `nixd` disponible |
|
||||
| ocaml-lsp | .ml, .mli | Commande `ocamllsp` disponible |
|
||||
| plinthe de boeuf | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts, .vue, .astro, .svelte | Dépendance `oxlint` dans le projet |
|
||||
| php intelligence | .php | Installations automatiques pour les projets PHP |
|
||||
| prisme | .prisma | Commande `prisma` disponible |
|
||||
| droit d'auteur | .py, .pyi | Dépendance `pyright` installée |
|
||||
| rubis-lsp (rubocop) | .rb, .rake, .gemspec, .ru | Commandes `ruby` et `gem` disponibles |
|
||||
| rouille | .rs | Commande `rust-analyzer` disponible |
|
||||
| sourcekit-lsp | .swift, .objc, .objcpp | `swift` installé (`xcode` sur macOS) |
|
||||
| svelte | .svelte | Installations automatiques pour les projets Svelte |
|
||||
| terraformer | .tf, .tfvars | Installations automatiques à partir des versions GitHub |
|
||||
| petite brume | .typ, .typc | Installations automatiques à partir des versions GitHub |
|
||||
| dactylographié | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts | Dépendance `typescript` dans le projet |
|
||||
| vue | .vue | Installations automatiques pour les projets Vue |
|
||||
| yaml-ls | .yaml, .yml | Installe automatiquement le serveur yaml-langage-Red Hat |
|
||||
| zls | .zig, .zon | Commande `zig` disponible |
|
||||
|
||||
Les serveurs LSP sont automatiquement activés lorsque l'une des extensions de fichier ci-dessus est détectée et que les exigences sont remplies.
|
||||
|
||||
:::note
|
||||
Vous pouvez désactiver les téléchargements automatiques du serveur LSP en définissant la variable d'environnement `OPENCODE_DISABLE_LSP_DOWNLOAD` sur `true`.
|
||||
:::
|
||||
|
||||
---
|
||||
|
||||
## Comment ça marche
|
||||
|
||||
Lorsque opencode ouvre un fichier, il :
|
||||
|
||||
1. Vérifie l'extension du fichier par rapport à tous les serveurs LSP activés.
|
||||
2. Démarre le serveur LSP approprié s'il n'est pas déjà en cours d'exécution.
|
||||
|
||||
---
|
||||
|
||||
## Configurer
|
||||
|
||||
Vous pouvez personnaliser les serveurs LSP via la section `lsp` de votre configuration opencode.
|
||||
|
||||
```json title="opencode.json"
|
||||
{
|
||||
"$schema": "https://opencode.ai/config.json",
|
||||
"lsp": {}
|
||||
}
|
||||
```
|
||||
|
||||
Chaque serveur LSP prend en charge les éléments suivants :
|
||||
|
||||
| Propriété | Tapez | Descriptif |
|
||||
| ---------------- | -------- | ------------------------------------------------- |
|
||||
| `disabled` | booléen | Définissez ceci sur `true` pour désactiver le serveur LSP |
|
||||
| `command` | chaîne[] | La commande pour démarrer le serveur LSP |
|
||||
| `extensions` | chaîne[] | Extensions de fichiers que ce serveur LSP doit gérer |
|
||||
| `env` | objet | Variables d'environnement à définir lors du démarrage du serveur |
|
||||
| `initialization` | objet | Options d'initialisation à envoyer au serveur LSP |
|
||||
|
||||
Regardons quelques exemples.
|
||||
|
||||
---
|
||||
|
||||
### Variables d'environnement
|
||||
|
||||
Utilisez la propriété `env` pour définir les variables d'environnement lors du démarrage du serveur LSP :
|
||||
|
||||
```json title="opencode.json" {5-7}
|
||||
{
|
||||
"$schema": "https://opencode.ai/config.json",
|
||||
"lsp": {
|
||||
"rust": {
|
||||
"env": {
|
||||
"RUST_LOG": "debug"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Options d'initialisation
|
||||
|
||||
Utilisez la propriété `initialization` pour transmettre les options d'initialisation au serveur LSP. Il s'agit de paramètres spécifiques au serveur envoyés lors de la requête LSP `initialize` :
|
||||
|
||||
```json title="opencode.json" {5-9}
|
||||
{
|
||||
"$schema": "https://opencode.ai/config.json",
|
||||
"lsp": {
|
||||
"typescript": {
|
||||
"initialization": {
|
||||
"preferences": {
|
||||
"importModuleSpecifierPreference": "relative"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
:::note
|
||||
Les options d'initialisation varient selon le serveur LSP. Consultez la documentation de votre serveur LSP pour connaître les options disponibles.
|
||||
:::
|
||||
|
||||
---
|
||||
|
||||
### Désactivation des serveurs LSP
|
||||
|
||||
Pour désactiver **tous** les serveurs LSP dans le monde, définissez `lsp` sur `false` :
|
||||
|
||||
```json title="opencode.json" {3}
|
||||
{
|
||||
"$schema": "https://opencode.ai/config.json",
|
||||
"lsp": false
|
||||
}
|
||||
```
|
||||
|
||||
Pour désactiver un serveur LSP **spécifique**, définissez `disabled` sur `true` :
|
||||
|
||||
```json title="opencode.json" {5}
|
||||
{
|
||||
"$schema": "https://opencode.ai/config.json",
|
||||
"lsp": {
|
||||
"typescript": {
|
||||
"disabled": true
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Serveurs LSP personnalisés
|
||||
|
||||
Vous pouvez ajouter des serveurs LSP personnalisés en spécifiant les extensions de commande et de fichier :
|
||||
|
||||
```json title="opencode.json" {4-7}
|
||||
{
|
||||
"$schema": "https://opencode.ai/config.json",
|
||||
"lsp": {
|
||||
"custom-lsp": {
|
||||
"command": ["custom-lsp-server", "--stdio"],
|
||||
"extensions": [".custom"]
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Informations Complémentaires
|
||||
|
||||
### PHP Intelligence
|
||||
|
||||
PHP Intelephense offre des fonctionnalités premium via une clé de licence. Vous pouvez fournir une clé de licence en plaçant (uniquement) la clé dans un fichier texte à l'adresse :
|
||||
|
||||
- Le macOS/Linux : `$HOME/intelephense/licence.txt`
|
||||
- Le Windows : `%USERPROFILE%/intelephense/licence.txt`
|
||||
|
||||
Le fichier doit contenir uniquement la clé de licence sans contenu supplémentaire.
|
||||
Reference in New Issue
Block a user