github.com/siyuan-note/siyuan @v3.7.0 sqlite

Düşünceni Yeniden Şekillendir

English | 中文 | 日本語 | Türkçe

İçindekiler

• 💡 Giriş
• 🔮 Özellikler
• 🏗️ Mimari ve Ekosistem
• 🌟 Yıldız Geçmişi
• 🗺️ Yol Haritası
• 🚀 İndirme ve Kurulum
• Uygulama Mağazası
• Kurulum Paketi
• Paket Yöneticisi
• Docker Barındırma
• Unraid Barındırma
• TrueNAS Barındırma
• Erken Önizleme (Insider Preview)
• ⌨️ Komut Satırı Arayüzü
• 🏘️ Topluluk
• 🛠️ Geliştirme Rehberi
• ❓ SSS (Sıkça Sorulan Sorular)
• SiYuan verileri nasıl saklar?
• Üçüncü taraf senkronizasyon diskiyle veri senkronizasyonu destekleniyor mu?
• SiYuan açık kaynak mı?
• Yeni bir sürüme nasıl yükseltilir?
• Bazı bloklar (örneğin liste öğelerindeki paragraflar) blok simgesini bulamıyorsa ne yapmalıyım?
• Veri deposu anahtarı (data repo key) kaybolursa ne yapmalıyım?
• Ücretli mi?
• 🙏 Teşekkür
• Katkıda Bulunanlar

💡 Giriş

SiYuan, gizliliği ön planda tutan kişisel bir bilgi yönetim sistemidir.
Blok düzeyinde referansları ve Markdown WYSIWYG düzenlemeyi destekler.

Daha fazla bilgi için SiYuan İngilizce Tartışma Forumu’na katılabilirsin.

Çevrimiçi kullanıcı rehberi: English

🔮 Özellikler

Çoğu özellik tamamen ücretsizdir ve ticari kullanım için de geçerlidir.

• İçerik Bloğu
• Blok düzeyinde referans ve çift yönlü bağlantılar
• Özel nitelikler
• Gömülü SQL sorgusu
• siyuan:// protokolü
• Editör
• Blok tabanlı yapı
• Markdown WYSIWYG düzenleme
• Liste taslağı görünümü
• Blok yakınlaştırma (zoom-in)
• Milyon kelimelik büyük belge düzenleme
• Matematiksel formüller, grafikler, akış diyagramları, Gantt diyagramları, zaman diyagramları, notalar vb.
• Web kırpma (web clipping)
• PDF açıklama bağlantısı
• Dışa Aktarım
• Blok referansı ve gömme desteği
• Varlıklarıyla birlikte standart Markdown çıktısı
• PDF, Word ve HTML olarak dışa aktarma
• WeChat MP, Zhihu ve Yuque’a kopyalama
• Veritabanı
• Tablo görünümü
• Aralıklı Tekrar (Flashcard)
• OpenAI API ile yapay zekâ yazma ve Soru-Cevap sohbeti
• Tesseract OCR
• Çok sekmeli görünüm, sürükle-bırak ile ekran bölme
• Şablon parçacıkları
• JavaScript/CSS kod parçacıkları
• Android / iOS / HarmonyOS uygulamaları
• Docker dağıtımı
• API
• Topluluk pazaryeri

Bazı özellikler yalnızca ücretli üyeler için geçerlidir. Detaylar için Fiyatlandırma sayfasına göz atabilirsin.

🏗️ Mimari ve Ekosistem

Proje	Açıklama	Çatallama (Forks)	Yıldız (Stars)
lute	Editör motoru
chrome	Chrome/Edge eklentisi
bazaar	Topluluk pazaryeri
dejavu	Veri deposu (repo)
petal	Eklenti API’si
android	Android uygulaması
ios	iOS uygulaması
harmony	HarmonyOS uygulaması
riff	Aralıklı tekrar motoru

🌟 Yıldız Geçmişi

🗺️ Yol Haritası

• SiYuan geliştirme planı ve ilerleme durumu
• SiYuan değişiklik günlüğü

🚀 İndirme ve Kurulum

Masaüstü ve mobil cihazlarda uygulama mağazası üzerinden kurulumu tercih etmen önerilir. Böylece gelecekte tek tıkla sürüm yükseltmesi yapabilirsin.

Uygulama Mağazası

Mobil:

• App Store
• Google Play
• F-Droid

Masaüstü:

• Microsoft Store

Kurulum Paketi

• B3log
• GitHub

Paket Yöneticisi

siyuan

siyuan-note

Docker Barındırma

Docker Dağıtımı

Genel Bakış

SiYuan’ı bir sunucuda çalıştırmanın en kolay yolu Docker üzerinden dağıtmaktır.

• Görüntü adı: b3log/siyuan
• Docker Görüntüsü

Dosya Yapısı

Tüm program /opt/siyuan/ dizini altındadır. Bu dizin, Electron kurulum paketinin resources klasör yapısına karşılık gelir:

• appearance: simgeler, temalar, diller
• guide: kullanıcı kılavuzu belgeleri
• stage: arayüz ve statik kaynaklar
• kernel: çekirdek program

Giriş Noktası (Entrypoint)

Docker görüntüsü oluşturulurken giriş noktası şu şekilde ayarlanır: ENTRYPOINT ["/opt/siyuan/entrypoint.sh"] Bu betik (script), konteyner içinde çalışacak kullanıcının PUID (Kullanıcı ID) ve PGID (Grup ID) değerlerini değiştirmene olanak tanır. Bu, özellikle host dizinleri bağlarken oluşabilecek izin sorunlarını çözmek için önemlidir.

docker run b3log/siyuan komutunu çalıştırırken aşağıdaki parametreleri kullanabilirsin:

• --workspace: çalışma alanı klasör yolunu belirtir, host üzerinde -v parametresiyle bağlanır
• --accessAuthCode: ekran kilidi şifresini belirtir

Not: v3.7.0'ten itibaren serve alt komutunu açıkça belirtmen gerekir (ör. docker run b3log/siyuan serve --workspace=...). Tüm sunucu seçeneklerini görmek için docker run --rm b3log/siyuan serve --help komutunu çalıştır.

Tüm parametreleri görmek için --help komutunu kullanabilirsin. Yeni ortam değişkenleriyle bir örnek başlatma komutu aşağıdadır:

docker run -d \
  -v workspace_dir_host:workspace_dir_container \
  -p 6806:6806 \
  -e PUID=1001 -e PGID=1002 \
  -e SIYUAN_LANG=tr \
  b3log/siyuan \
  serve \
  --workspace=workspace_dir_container \
  --accessAuthCode=xxx

• PUID: Özel kullanıcı kimliği (isteğe bağlı, belirtilmezse varsayılan değer 1000 olarak kullanılır)
• PGID: Özel grup kimliği (isteğe bağlı, belirtilmezse varsayılan değer 1000 olarak kullanılır)
• workspace_dir_host: Ana makinedeki (host) çalışma alanı klasör yolu
• workspace_dir_container: Konteyner içindeki çalışma alanı klasör yolu (--workspace parametresiyle belirtilir)
• Alternatif olarak, bu yol SIYUAN_WORKSPACE_PATH ortam değişkeniyle de ayarlanabilir. Eğer her iki yöntem de kullanılırsa, komut satırı önceliklidir.
• accessAuthCode: Ekran kilidi şifresi (kesinlikle değiştir, aksi halde herkes verilerine erişebilir)
• Alternatif olarak, ekran kilidi şifresi SIYUAN_ACCESS_AUTH_CODE ortam değişkeniyle de ayarlanabilir. Yine, hem komut satırı hem ortam değişkeni kullanılırsa, komut satırı önceliklidir.
• Ekran kilidi şifresini devre dışı bırakmak için şu ortam değişkenini ayarla: SIYUAN_ACCESS_AUTH_CODE_BYPASS=true
• SIYUAN_LANG: Arayüz dili (isteğe bağlı, Docker'da ayarlanmazsa varsayılan en). BCP 47 etiketlerini (zh-CN/zh-TW/en/ja/pt-BR vb.) kabul eder; eski alt çizgi biçimi (zh_CN/en_US vb.) de geriye dönük uyumluluk için kabul edilir. Ayarlar'da seçtiğin