summaryrefslogtreecommitdiffhomepage
path: root/packages/web/src/content/docs/tr/lsp.mdx
blob: 52a95d1c3c07c608c883ddd24e714fdc9511417b (plain)
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
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
---
title: LSP Sunucuları
description: OpenCode, LSP sunucularınızla bütünleşir.
---

OpenCode, LLM'in kod tabanınızla etkileşime girmesine yardımcı olmak için Dil Sunucusu Protokolünüzle (LSP) bütünleşir. LLM'ye geri bildirim sağlamak için tanılamayı kullanır.

---

## Yerleşik

OpenCode, popüler diller için çeşitli yerleşik LSP sunucularıyla birlikte gelir:

| LSP Sunucu         | Uzantılar                                                           | Gereksinimler                                                         |
| ------------------ | ------------------------------------------------------------------- | --------------------------------------------------------------------- |
| astro              | .astro                                                              | Astro projeleri için otomatik kurulumlar                              |
| bash               | .sh, .bash, .zsh, .ksh                                              | `bash-language-server`'ı otomatik olarak yükler                       |
| clangd             | .c, .cpp, .cc, .cxx, .c++, .h, .hpp, .hh, .hxx, .h++                | C/C++ projeleri için otomatik kurulumlar                              |
| csharp             | .cs                                                                 | `.NET SDK` kurulu                                                     |
| clojure-lsp        | .clj, .cljs, .cljc, .edn                                            | `clojure-lsp` komutu mevcut                                           |
| dart               | .dart                                                               | `dart` komutu mevcut                                                  |
| deno               | .ts, .tsx, .js, .jsx, .mjs                                          | `deno` komutu mevcut (deno.json/deno.jsonc otomatik olarak algılanır) |
| elixir-ls          | .ex, .exs                                                           | `elixir` komutu mevcut                                                |
| eslint             | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts, .vue                  | Projede `eslint` bağımlılığı                                          |
| fsharp             | .fs, .fsi, .fsx, .fsscript                                          | `.NET SDK` kurulu                                                     |
| gleam              | .gleam                                                              | `gleam` komutu mevcut                                                 |
| gopls              | .go                                                                 | `go` komutu mevcut                                                    |
| hls                | .hs, .lhs                                                           | `haskell-language-server-wrapper` komutu mevcut                       |
| jdtls              | .java                                                               | `Java SDK (version 21+)` kurulu                                       |
| julials            | .jl                                                                 | `julia` ve `LanguageServer.jl` kurulu                                 |
| kotlin-ls          | .kt, .kts                                                           | Kotlin projeleri için otomatik kurulumlar                             |
| lua-ls             | .lua                                                                | Lua projeleri için otomatik kurulumlar                                |
| nixd               | .nix                                                                | `nixd` komutu mevcut                                                  |
| ocaml-lsp          | .ml, .mli                                                           | `ocamllsp` komutu mevcut                                              |
| oxlint             | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts, .vue, .astro, .svelte | Projede `oxlint` bağımlılığı                                          |
| php intelephense   | .php                                                                | PHP projeleri için otomatik yüklemeler                                |
| prisma             | .prisma                                                             | `prisma` komutu mevcut                                                |
| pyright            | .py, .pyi                                                           | `pyright` bağımlılığı kurulu                                          |
| ruby-lsp (rubocop) | .rb, .rake, .gemspec, .ru                                           | `ruby` ve `gem` komutları mevcut                                      |
| rust               | .rs                                                                 | `rust-analyzer` komutu mevcut                                         |
| sourcekit-lsp      | .swift, .objc, .objcpp                                              | `swift` kurulu (macOS'ta `xcode`)                                     |
| svelte             | .svelte                                                             | Svelte projeleri için otomatik kurulumlar                             |
| terraform          | .tf, .tfvars                                                        | GitHub sürümlerinden otomatik yüklemeler                              |
| tinymist           | .typ, .typc                                                         | GitHub sürümlerinden otomatik yüklemeler                              |
| typescript         | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts                        | Projede `typescript` bağımlılığı                                      |
| vue                | .vue                                                                | Vue projeleri için otomatik yüklemeler                                |
| yaml-ls            | .yaml, .yml                                                         | Red Hat yaml-language-server'ı otomatik olarak yükler                 |
| zls                | .zig, .zon                                                          | `zig` komutu mevcut                                                   |

Yukarıdaki dosya uzantılarından biri tespit edildiğinde ve gereksinimler karşılandığında LSP sunucuları otomatik olarak etkinleştirilir.

:::note
`OPENCODE_DISABLE_LSP_DOWNLOAD` ortam değişkenini `true` olarak ayarlayarak otomatik LSP sunucu indirmelerini devre dışı bırakabilirsiniz.
:::

---

## Nasıl Çalışır?

opencode bir dosyayı açtığında:

1. Dosya uzantısını tüm etkin LSP sunucularına göre kontrol eder.
2. Henüz çalışmıyorsa uygun LSP sunucusunu başlatır.

---

## Yapılandırma

LSP sunucularını, opencode yapılandırmanızdaki `lsp` bölümü aracılığıyla özelleştirebilirsiniz.

```json title="opencode.json"
{
  "$schema": "https://opencode.ai/config.json",
  "lsp": {}
}
```

Her LSP sunucusu aşağıdakileri destekler:

| Özellik          | Tip      | Açıklama                                                             |
| ---------------- | -------- | -------------------------------------------------------------------- |
| `disabled`       | boolean  | LSP sunucusunu devre dışı bırakmak için bunu `true` olarak ayarlayın |
| `command`        | string[] | LSP sunucusunu başlatma komutu                                       |
| `extensions`     | string[] | Bu LSP sunucusunun işlemesi gereken dosya uzantıları                 |
| `env`            | object   | Sunucuyu başlatırken ayarlanacak ortam değişkenleri                  |
| `initialization` | object   | LSP sunucusuna gönderilecek başlatma seçenekleri                     |

Bazı örneklere bakalım.

---

### Ortam değişkenleri

LSP sunucusunu başlatırken ortam değişkenlerini ayarlamak için `env` özelliğini kullanın:

```json title="opencode.json" {5-7}
{
  "$schema": "https://opencode.ai/config.json",
  "lsp": {
    "rust": {
      "env": {
        "RUST_LOG": "debug"
      }
    }
  }
}
```

---

### Başlatma seçenekleri

Başlatma seçeneklerini LSP sunucusuna iletmek için `initialization` özelliğini kullanın. Bunlar LSP `initialize` isteği sırasında gönderilen sunucuya özel ayarlardır:

```json title="opencode.json" {5-9}
{
  "$schema": "https://opencode.ai/config.json",
  "lsp": {
    "typescript": {
      "initialization": {
        "preferences": {
          "importModuleSpecifierPreference": "relative"
        }
      }
    }
  }
}
```

:::note
Başlatma seçenekleri LSP sunucusuna göre değişir. Mevcut seçenekler için LSP sunucunuzun belgelerine bakın.
:::

---

### LSP sunucularını devre dışı bırakma

**tüm** LSP sunucularını genel olarak devre dışı bırakmak için `lsp`'yi `false` olarak ayarlayın:

```json title="opencode.json" {3}
{
  "$schema": "https://opencode.ai/config.json",
  "lsp": false
}
```

**Belirli** bir LSP sunucusunu devre dışı bırakmak için `disabled`'yi `true` olarak ayarlayın:

```json title="opencode.json" {5}
{
  "$schema": "https://opencode.ai/config.json",
  "lsp": {
    "typescript": {
      "disabled": true
    }
  }
}
```

---

### Özel LSP sunucuları

Komutu ve dosya uzantılarını belirterek özel LSP sunucuları ekleyebilirsiniz:

```json title="opencode.json" {4-7}
{
  "$schema": "https://opencode.ai/config.json",
  "lsp": {
    "custom-lsp": {
      "command": ["custom-lsp-server", "--stdio"],
      "extensions": [".custom"]
    }
  }
}
```

---

## Ek Bilgiler

### PHP Intelephense

PHP Intelephense, bir lisans anahtarı aracılığıyla premium özellikler sunar. Anahtarı (yalnızca) şu adresteki bir metin dosyasına yerleştirerek bir lisans anahtarı sağlayabilirsiniz:

- macOS/Linux'ta: `$HOME/intelephense/license.txt`
- Windows'ta: `%USERPROFILE%/intelephense/license.txt`

Dosya, ek içerik olmadan yalnızca lisans anahtarını içermelidir.