Skip to content

Commit 8b92f64

Browse files
starptechstarptech
starptech
authored and
starptech
committed
docs(web): update LSP docs wording
1 parent 28dbd4a commit 8b92f64

18 files changed

Lines changed: 418 additions & 87 deletions

File tree

‎packages/web/src/content/docs/ar/lsp.mdx‎

Lines changed: 24 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: خوادم LSP
33
description: يتكامل OpenCode مع خوادم LSP لديك.
44
---
55

6-
يتكامل OpenCode مع بروتوكول خادم اللغة (LSP) لمساعدة LLM على التفاعل مع قاعدة الشيفرة لديك. ويستخدم التشخيصات لتزويد LLM بتغذية راجعة.
6+
يمكن أن يتكامل OpenCode مع خوادم Language Server Protocol (LSP) لاستخدام التشخيصات كملاحظات للوكيل.
77

88
---
99

@@ -46,7 +46,7 @@ description: يتكامل OpenCode مع خوادم LSP لديك.
4646
| yaml-ls | .yaml, .yml | يثبت `yaml-language-server` من Red Hat تلقائيا |
4747
| zls | .zig, .zon | توفر أمر `zig` |
4848

49-
تُفعَّل خوادم LSP تلقائيا عند اكتشاف أحد امتدادات الملفات المذكورة أعلاه واستيفاء المتطلبات.
49+
تكون ميزة LSP معطلة افتراضيا. عند تفعيلها، تبدأ الخوادم عند اكتشاف أحد امتدادات الملفات المذكورة أعلاه واستيفاء المتطلبات.
5050

5151
:::note
5252
يمكنك تعطيل تنزيلات خوادم LSP التلقائية عبر ضبط متغير البيئة `OPENCODE_DISABLE_LSP_DOWNLOAD` على `true`.
@@ -56,16 +56,35 @@ description: يتكامل OpenCode مع خوادم LSP لديك.
5656

5757
## كيف يعمل
5858

59-
عندما يفتح opencode ملفا، فإنه:
59+
عند تفعيل LSP وفتح opencode لملف، فإنه:
6060

6161
1. يفحص امتداد الملف مقابل جميع خوادم LSP المفعّلة.
6262
2. يشغّل خادم LSP المناسب إذا لم يكن قيد التشغيل بالفعل.
6363

6464
---
6565

66+
## أفضل الممارسات
67+
68+
يمكن أن تساعد LSP الوكيل على العثور على المشاكل وإصلاحها عبر توفير التشخيصات من خوادم اللغة. هذا مفيد في بعض المشاريع، لكنه ليس دائما مكسبا صافيا.
69+
70+
قد تخرج خوادم اللغة عن المزامنة، وتستهلك ذاكرة كبيرة، وتختلف حسب الإصدار أو المشروع، وتبطئ سير عمل الوكيل. في كثير من المشاريع، يكون من الأفضل أن يشغّل الوكيل lint أو typecheck أو أدوات CLI التشخيصية الأخرى مباشرة، بحيث تعود الأخطاء إلى حلقة الوكيل دون هذه المفاضلات. فعّل LSP عندما يستفيد مشروعك من ملاحظات إضافية من خادم اللغة.
71+
72+
---
73+
6674
## الإعداد
6775

68-
يمكنك تخصيص خوادم LSP عبر قسم `lsp` في إعدادات opencode.
76+
يمكنك تفعيل خوادم LSP وتخصيصها عبر قسم `lsp` في إعدادات opencode.
77+
78+
لتفعيل جميع خوادم LSP المدمجة، اضبط `lsp` على `true`.
79+
80+
```json title="opencode.json"
81+
{
82+
"$schema": "https://opencode.ai/config.json",
83+
"lsp": true
84+
}
85+
```
86+
87+
استخدم كائنا لإبقاء الخوادم المدمجة مفعلة أثناء إعداد التجاوزات أو الخوادم المخصصة.
6988

7089
```json title="opencode.json"
7190
{
@@ -134,7 +153,7 @@ description: يتكامل OpenCode مع خوادم LSP لديك.
134153

135154
### تعطيل خوادم LSP
136155

137-
لتعطيل **جميع** خوادم LSP على مستوى التطبيق، اضبط `lsp` على `false`:
156+
إذا تم حذف `lsp`، فستكون جميع خوادم LSP معطلة. لتعطيل جميع خوادم LSP بعد أن فعّلها إعداد آخر، اضبط `lsp` على `false`:
138157

139158
```json title="opencode.json" {3}
140159
{

‎packages/web/src/content/docs/bs/lsp.mdx‎

Lines changed: 24 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: LSP serveri
33
description: OpenCode se integriše sa vašim LSP serverima.
44
---
55

6-
OpenCode se integriše sa vašim Language Server Protocol (LSP) serverima kako bi pomogao LLM-u u interakciji s kodnom bazom. Koristi dijagnostiku za slanje povratnih informacija modelu.
6+
OpenCode se može integrisati sa Language Server Protocol (LSP) serverima kako bi koristio dijagnostiku kao feedback za agenta.
77

88
## Ugrađeni
99

@@ -45,7 +45,7 @@ OpenCode dolazi sa nekoliko ugrađenih LSP servera za popularne jezike:
4545
| yaml-ls | .yaml, .yml | Automatski instalira Red Hat yaml-language-server |
4646
| zls | .zig, .zon | `zig` komanda dostupna |
4747

48-
LSP serveri su automatski omogućeni kada se otkrije jedna od gore navedenih ekstenzija datoteke i zahtjevi su ispunjeni.
48+
LSP je podrazumijevano isključen. Kada je omogućen, serveri se pokreću kada se otkrije jedna od gore navedenih ekstenzija datoteke i zahtjevi su ispunjeni.
4949
:::note
5050
Možete onemogućiti automatska preuzimanja LSP servera tako što ćete postaviti varijablu okruženja `OPENCODE_DISABLE_LSP_DOWNLOAD` na `true`.
5151
:::
@@ -54,16 +54,35 @@ Možete onemogućiti automatska preuzimanja LSP servera tako što ćete postavit
5454

5555
## Kako radi
5656

57-
Kada opencode otvori fajl, on:
57+
Kada je LSP omogućen i opencode otvori fajl, on:
5858

5959
1. Provjerava ekstenziju datoteke u odnosu na sve omogućene LSP servere.
6060
2. Pokreće odgovarajući LSP server ako već nije pokrenut.
6161

6262
---
6363

64+
## Najbolje prakse
65+
66+
LSP može pomoći agentu da pronađe i popravi probleme pružanjem dijagnostike iz jezičkih servera. Ovo je korisno u nekim projektima, ali nije uvijek neto pozitivno.
67+
68+
Jezički serveri mogu ispasti iz sinhronizacije, koristiti mnogo memorije, razlikovati se po verziji ili projektu i usporiti agent workflow. U mnogim projektima je bolje da agent direktno pokreće lint, typecheck ili druge dijagnostičke CLI alate, tako da se greške vraćaju u agent loop bez tih kompromisa. Uključite LSP kada vaš projekt ima koristi od dodatnog feedbacka jezičkog servera.
69+
70+
---
71+
6472
## Konfiguracija
6573

66-
Možete prilagoditi LSP servere kroz `lsp` odjeljak u vašoj opencode konfiguraciji.
74+
Možete omogućiti i prilagoditi LSP servere kroz `lsp` odjeljak u vašoj opencode konfiguraciji.
75+
76+
Da biste omogućili sve ugrađene LSP servere, postavite `lsp` na `true`.
77+
78+
```json title="opencode.json"
79+
{
80+
"$schema": "https://opencode.ai/config.json",
81+
"lsp": true
82+
}
83+
```
84+
85+
Koristite objekt da zadržite ugrađene servere omogućene dok konfigurirate izmjene ili prilagođene servere.
6786

6887
```json title="opencode.json"
6988
{
@@ -132,7 +151,7 @@ Opcije inicijalizacije razlikuju se od LSP servera. Provjerite dokumentaciju va
132151

133152
### Onemogućavanje LSP servera
134153

135-
Da biste onemogućili **sve** LSP servere globalno, postavite `lsp` na `false`:
154+
Ako je `lsp` izostavljen, svi LSP serveri su onemogućeni. Da biste onemogućili sve LSP servere nakon što ih je druga konfiguracija omogućila, postavite `lsp` na `false`:
136155

137156
```json title="opencode.json" {3}
138157
{

‎packages/web/src/content/docs/da/lsp.mdx‎

Lines changed: 24 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: LSP-servere
33
description: OpenCode integreres med dine LSP-servere.
44
---
55

6-
OpenCode integreres med Language Server Protocol (LSP) for at hjælpe LLM med at interagere med din kodebase. Den bruger diagnostik til at give feedback til LLM.
6+
OpenCode kan integreres med Language Server Protocol (LSP)-servere for at bruge diagnostik som feedback til agenten.
77

88
---
99

@@ -47,7 +47,7 @@ OpenCode leveres med flere indbyggede LSP-servere til populære sprog:
4747
| yaml-ls | .yaml,.yml | Autoinstallerer Red Hat yaml-language-server |
4848
| zls | .zig,.zon | `zig` kommando tilgængelig |
4949

50-
LSP-servere aktiveres automatisk, når en af ​​ovenstående filtypenavne opdages, og kravene er opfyldt.
50+
LSP er deaktiveret som standard. Når det er aktiveret, starter servere, når en af ovenstående filtypenavne opdages, og kravene er opfyldt.
5151

5252
:::note
5353
Du kan deaktivere automatisk LSP-serverdownloads ved at indstille miljøvariablen `OPENCODE_DISABLE_LSP_DOWNLOAD` til `true`.
@@ -57,16 +57,35 @@ Du kan deaktivere automatisk LSP-serverdownloads ved at indstille miljøvariable
5757

5858
## Sådan fungerer det
5959

60-
Når opencode åbner en fil, vil den:
60+
Når LSP er aktiveret, og opencode åbner en fil, vil den:
6161

6262
1. Kontrollerer filtypenavnet mod alle aktiverede LSP-servere.
6363
2. Starter den relevante LSP-server, hvis den ikke allerede kører.
6464

6565
---
6666

67+
## Bedste praksis
68+
69+
LSP kan hjælpe agenten med at finde og rette problemer ved at levere diagnostik fra sprogservere. Det er nyttigt i nogle projekter, men er ikke altid en klar fordel.
70+
71+
Sprogservere kan komme ud af sync, bruge meget hukommelse, variere efter version eller projekt og gøre agentarbejdsgange langsommere. I mange projekter er det bedre, at agenten kører lint, typecheck eller andre diagnostiske CLI-værktøjer direkte, så fejl føres tilbage i agentens loop uden disse afvejninger. Aktivér LSP, når dit projekt har gavn af ekstra sprogserverfeedback.
72+
73+
---
74+
6775
## Konfiguration
6876

69-
Du kan tilpasse LSP-servere gennem sektionen `lsp` i din opencode-konfiguration.
77+
Du kan aktivere og tilpasse LSP-servere gennem sektionen `lsp` i din opencode-konfiguration.
78+
79+
For at aktivere alle indbyggede LSP-servere skal du indstille `lsp` til `true`.
80+
81+
```json title="opencode.json"
82+
{
83+
"$schema": "https://opencode.ai/config.json",
84+
"lsp": true
85+
}
86+
```
87+
88+
Brug et objekt til at holde indbyggede servere aktiveret, mens du konfigurerer tilsidesættelser eller brugerdefinerede servere.
7089

7190
```json title="opencode.json"
7291
{
@@ -135,7 +154,7 @@ Initialiseringsmuligheder forskellige afhængige af LSP-serveren. Se din LSP-ser
135154

136155
### Deaktivering af LSP-servere
137156

138-
For at deaktivere **alle** LSP-servere globalt, skal du indstille `lsp` til `false`:
157+
Hvis `lsp` udelades, er alle LSP-servere deaktiveret. For at deaktivere alle LSP-servere efter at en anden konfiguration har aktiveret dem, skal du indstille `lsp` til `false`:
139158

140159
```json title="opencode.json" {3}
141160
{

‎packages/web/src/content/docs/de/lsp.mdx‎

Lines changed: 24 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: LSP Server
33
description: OpenCode lässt sich in Ihren LSP-Server integrieren.
44
---
55

6-
OpenCode lässt sich in Ihr Language Server Protocol (LSP) integrieren, um die Interaktion von LLM mit Ihrer Codebasis zu unterstützen. Es verwendet Diagnosefunktionen, um dem LLM Feedback zu geben.
6+
OpenCode kann sich in Language Server Protocol (LSP)-Server integrieren, um Diagnosen als Feedback für den Agenten zu verwenden.
77

88
---
99

@@ -46,7 +46,7 @@ OpenCode verfügt über mehrere integrierte LSP-Server für gängige Sprachen:
4646
| yaml-ls | .yaml, .yml | Installiert den Red Hat yaml-language-server automatisch |
4747
| zls | .zig, .zon | `zig`-Befehl verfügbar |
4848

49-
LSP-Server werden automatisch aktiviert, wenn eine der oben genannten Dateierweiterungen erkannt wird und die Anforderungen erfüllt sind.
49+
LSP ist standardmäßig deaktiviert. Wenn es aktiviert ist, starten Server, sobald eine der oben genannten Dateierweiterungen erkannt wird und die Anforderungen erfüllt sind.
5050

5151
:::note
5252
Sie können LSP-Server-Downloads automatisch deaktivieren, indem Sie die Umgebungsvariable `OPENCODE_DISABLE_LSP_DOWNLOAD` auf `true` setzen.
@@ -56,16 +56,35 @@ Sie können LSP-Server-Downloads automatisch deaktivieren, indem Sie die Umgebun
5656

5757
## Funktionsweise
5858

59-
Wenn OpenCode eine Datei öffnet, geschieht Folgendes:
59+
Wenn LSP aktiviert ist und OpenCode eine Datei öffnet, geschieht Folgendes:
6060

6161
1. Überprüft die Dateierweiterung anhand aller aktivierten LSP-Server.
6262
2. Startet den entsprechenden LSP-Server, falls er noch nicht ausgeführt wird.
6363

6464
---
6565

66+
## Bewährte Praktiken
67+
68+
LSP kann dem Agenten helfen, Probleme zu finden und zu beheben, indem es Diagnosen von Sprachservern bereitstellt. Das ist in einigen Projekten nützlich, aber nicht immer ein klarer Vorteil.
69+
70+
Sprachserver können aus dem Sync geraten, viel Speicher verwenden, je nach Version oder Projekt unterschiedlich arbeiten und Agent-Workflows verlangsamen. In vielen Projekten ist es besser, wenn der Agent lint, typecheck oder andere diagnostische CLI-Tools direkt ausführt, damit Fehler in die Agent-Schleife zurückfließen, ohne diese Kompromisse einzugehen. Aktivieren Sie LSP, wenn Ihr Projekt von zusätzlichem Sprachserver-Feedback profitiert.
71+
72+
---
73+
6674
## Konfiguration
6775

68-
Sie können LSP-Server über den Abschnitt `lsp` in Ihrer OpenCode-Konfiguration anpassen.
76+
Sie können LSP-Server über den Abschnitt `lsp` in Ihrer OpenCode-Konfiguration aktivieren und anpassen.
77+
78+
Um alle integrierten LSP-Server zu aktivieren, setzen Sie `lsp` auf `true`.
79+
80+
```json title="opencode.json"
81+
{
82+
"$schema": "https://opencode.ai/config.json",
83+
"lsp": true
84+
}
85+
```
86+
87+
Verwenden Sie ein Objekt, um integrierte Server aktiviert zu lassen und gleichzeitig Überschreibungen oder benutzerdefinierte Server zu konfigurieren.
6988

7089
```json title="opencode.json"
7190
{
@@ -134,7 +153,7 @@ Die Initialisierungsoptionen variieren je nach LSP-Server. Überprüfen Sie die
134153

135154
### Deaktivieren von LSP-Servern
136155

137-
Um **alle** LSP-Server global zu deaktivieren, setzen Sie `lsp` auf `false`:
156+
Wenn `lsp` ausgelassen wird, sind alle LSP-Server deaktiviert. Um alle LSP-Server zu deaktivieren, nachdem sie durch eine andere Konfiguration aktiviert wurden, setzen Sie `lsp` auf `false`:
138157

139158
```json title="opencode.json" {3}
140159
{

‎packages/web/src/content/docs/es/lsp.mdx‎

Lines changed: 24 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Servidores LSP
33
description: OpenCode se integra con sus servidores LSP.
44
---
55

6-
OpenCode se integra con su protocolo de servidor de idiomas (LSP) para ayudar a LLM a interactuar con su código base. Utiliza diagnósticos para proporcionar retroalimentación al LLM.
6+
OpenCode puede integrarse con servidores Language Server Protocol (LSP) para usar diagnósticos como feedback para el agente.
77

88
---
99

@@ -47,7 +47,7 @@ OpenCode viene con varios servidores LSP integrados para idiomas populares:
4747
| yaml-ls | .yaml, .yml | Autoinstala Red Hat yaml-language-server |
4848
| zls | .zig, .zon | Comando `zig` disponible |
4949

50-
Los servidores LSP se habilitan automáticamente cuando se detecta una de las extensiones de archivo anteriores y se cumplen los requisitos.
50+
LSP está deshabilitado por defecto. Cuando está habilitado, los servidores se inician cuando se detecta una de las extensiones de archivo anteriores y se cumplen los requisitos.
5151

5252
:::note
5353
Puede deshabilitar las descargas automáticas del servidor LSP configurando la variable de entorno `OPENCODE_DISABLE_LSP_DOWNLOAD` en `true`.
@@ -57,16 +57,35 @@ Puede deshabilitar las descargas automáticas del servidor LSP configurando la v
5757

5858
## Cómo funciona
5959

60-
Cuando opencode abre un archivo:
60+
Cuando LSP está habilitado y opencode abre un archivo:
6161

6262
1. Comprueba la extensión del archivo con todos los servidores LSP habilitados.
6363
2. Inicia el servidor LSP apropiado si aún no se está ejecutando.
6464

6565
---
6666

67+
## Buenas prácticas
68+
69+
LSP puede ayudar al agente a encontrar y corregir problemas proporcionando diagnósticos de los servidores de lenguaje. Esto es útil en algunos proyectos, pero no siempre es una mejora neta.
70+
71+
Los servidores de lenguaje pueden desincronizarse, usar bastante memoria, variar según la versión o el proyecto y ralentizar los flujos de trabajo del agente. En muchos proyectos es mejor hacer que el agente ejecute lint, typecheck u otras herramientas CLI de diagnóstico directamente, para que los errores vuelvan al ciclo del agente sin esas compensaciones. Habilita LSP cuando tu proyecto se beneficie de feedback adicional del servidor de lenguaje.
72+
73+
---
74+
6775
## Configuración
6876

69-
Puede personalizar los servidores LSP a través de la sección `lsp` en su configuración opencode.
77+
Puede habilitar y personalizar los servidores LSP a través de la sección `lsp` en su configuración opencode.
78+
79+
Para habilitar todos los servidores LSP integrados, configure `lsp` como `true`.
80+
81+
```json title="opencode.json"
82+
{
83+
"$schema": "https://opencode.ai/config.json",
84+
"lsp": true
85+
}
86+
```
87+
88+
Use un objeto para mantener habilitados los servidores integrados mientras configura anulaciones o servidores personalizados.
7089

7190
```json title="opencode.json"
7291
{
@@ -135,7 +154,7 @@ Las opciones de inicialización varían según el servidor LSP. Consulte la docu
135154

136155
### Deshabilitar servidores LSP
137156

138-
Para deshabilitar **todos** los servidores LSP globalmente, configure `lsp` en `false`:
157+
Si se omite `lsp`, todos los servidores LSP están deshabilitados. Para deshabilitar todos los servidores LSP después de que otra configuración los haya habilitado, configure `lsp` en `false`:
139158

140159
```json title="opencode.json" {3}
141160
{

0 commit comments

Comments
 (0)