> ## Documentation Index
> Fetch the complete documentation index at: https://ziva.zeleza.ru/llms.txt
> Use this file to discover all available pages before exploring further.

# Kurulum

> Ziva'u Go projenizde nasıl kuracağınız ve yapılandıracağınız

# Ziva Kurulumu

## Gereksinimler

* **Go 1.23.0+** (toolchain 1.24.5 önerilir)
* Pseudografiklerin doğru görüntülenmesi için UTF-8 destekli terminal
* Terminal renk desteği (opsiyonel)

## Kurulum

### go get ile

```bash theme={null}
go get github.com/qzeleza/ziva
```

### go mod ile

`go.mod` dosyanıza ekleyin:

```go theme={null}
require github.com/qzeleza/ziva latest
```

Sonra çalıştırın:

```bash theme={null}
go mod tidy
```

## Kurulum Doğrulaması

Doğrulama için basit bir `main.go` dosyası oluşturun:

```go theme={null}
package main

import (
    "fmt"
    "log"
    "github.com/qzeleza/ziva"
)

func main() {
    // Basit görev oluştur
    task := ziva.NewYesNoTask("Test", "Ziva doğru kuruldu mu?")

    // Kuyruk oluştur ve görev ekle
    queue := ziva.NewQueue("Ziva Kurulum Kontrolü")
    queue.AddTasks(task)

    // Çalıştır
    if err := queue.Run(); err != nil {
        log.Fatal(err)
    }

    // Sonucu kontrol et
    if task.IsYes() {
        fmt.Println("✅ Harika! Ziva çalışmaya hazır.")
    } else {
        fmt.Println("❌ Kurulumu kontrol etmek gerekiyor.")
    }
}
```

Çalıştırın:

```bash theme={null}
go run main.go
```

## Ortam Yapılandırması

### Yerel Ayar Yapılandırması (Türkçe için)

Türkçe metnin doğru görüntülenmesi için yerel ayarları yapılandırın:

**Ubuntu/Debian:**

```bash theme={null}
sudo locale-gen tr_TR.UTF-8
sudo update-locale LANG=tr_TR.UTF-8
export LANG=tr_TR.UTF-8
export LC_ALL=tr_TR.UTF-8
```

**Entware/BusyBox:**

```bash theme={null}
opkg install locale-full glibc-binary-locales
export LANG=tr_TR.UTF-8
```

### Font Yapılandırması

Gömülü sistemler için font yapılandırması gerekebilir:

```bash theme={null}
setterm -reset
setterm -store
setterm -font ter-116n  # Turkish character support
```

### Ortam Değişkenleri

Ziva, ortam değişkenleri ile yapılandırmayı destekler:

```bash theme={null}
# Arayüz dili
export ZIVA_LANG=tr
export ZIVA_DEFAULT_LANG=tr

# Gömülü sistemler için
export ZIVA_MEMORY_PRESSURE_THRESHOLD=50M
export ZIVA_MAX_COMPLETED_TASKS=10

# Terminal renkleri
export COLORTERM=truecolor
export TERM=xterm-256color
```

## Proje Yapısı

Ziva ile önerilen Go projesi yapısı:

```
uygulamam/
├── go.mod
├── go.sum
├── main.go
├── cmd/
│   └── uygulamam/
│       └── main.go
├── internal/
│   ├── tasks/
│   ├── config/
│   └── ui/
└── pkg/
    └── validation/
```

## Bağımlılıklar

Ziva şu ana bağımlılıkları kullanır:

* **Bubble Tea** - TUI için temel
* **Lip Gloss** - stil ve renkler
* **Cobra** - CLI (opsiyonel)

Tüm bağımlılıklar `go get` ile otomatik olarak yüklenir.

<Card title="Sonraki Adım" icon="arrow-right" href="/tr/quick-start">
  İlk TUI uygulamanızı oluşturun
</Card>