Ana içeriğe atla

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.

​
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

go get github.com/qzeleza/ziva

​
go mod ile

go.mod dosyanıza ekleyin: 
require github.com/qzeleza/ziva latest
Sonra çalıştırın: 
go mod tidy

​
Kurulum Doğrulaması

Doğrulama için basit bir main.go dosyası oluşturun: 
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: 
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: 
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: 
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: 
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: 
# 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.

Sonraki Adım

İlk TUI uygulamanızı oluşturun