siyuan/README_tr_TR.md

Düşünceni Yeniden Şekillendir

English | 中文 | 日本語

---

İç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
  • Erken Önizleme (Insider Preview)
• 🏘️ 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.

🔮 Ö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: erişim yetkilendirme kodunu belirtir

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 \
  b3log/siyuan \
  --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: Erişim yetkilendirme kodu (kesinlikle değiştir, aksi halde herkes verilerine erişebilir)
  • Alternatif olarak, yetkilendirme kodu 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.
  • Erişim yetkilendirme kodunu devre dışı bırakmak için şu ortam değişkenini ayarla: SIYUAN_ACCESS_AUTH_CODE_BYPASS=true

Kurulumu basitleştirmek için, host ve konteyner üzerindeki çalışma alanı yollarını aynı şekilde ayarlaman önerilir. Örneğin her ikisini de /siyuan/workspace olarak tanımlayabilirsin. Buna karşılık gelen başlatma komutu şu şekildedir:

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

Docker Compose

SiYuan’ı Docker Compose ile çalıştıran kullanıcılar için, PUID ve PGID ortam değişkenleri kullanılarak kullanıcı ve grup kimlikleri özelleştirilebilir. Aşağıda örnek bir Docker Compose yapılandırması bulunmaktadır:

version: "3.9"
services:
  main:
    image: b3log/siyuan
    command: ['--workspace=/siyuan/workspace/', '--accessAuthCode=${AuthCode}']
    ports:
      - 6806:6806
    volumes:
      - /siyuan/workspace:/siyuan/workspace
    restart: unless-stopped
    environment:
      # A list of time zone identifiers can be found at https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
      - TZ=${YOUR_TIME_ZONE}
      - PUID=${YOUR_USER_PUID}  # Customize user ID
      - PGID=${YOUR_USER_PGID}  # Customize group ID

Bu yapılandırmada:

• PUID ve PGID dinamik olarak ayarlanır ve konteynere aktarılır.
• Eğer bu değişkenler belirtilmezse, varsayılan değer olarak 1000 kullanılır.

PUID ve PGID değişkenlerini ortamda (environment) belirterek, docker-compose.yml dosyasında user: '1000:1000' satırını açıkça yazmana gerek kalmaz. Konteyner, başlatma sırasında bu ortam değişkenlerine göre kullanıcı ve grup ayarlarını otomatik olarak düzenler.

Kullanıcı İzinleri

Docker görüntüsünde yer alan entrypoint.sh betiği, belirtilen PUID ve PGID değerleriyle birlikte siyuan adlı kullanıcı ve grubun oluşturulmasını sağlar. Bu nedenle, ana makine (host) üzerinde çalışma alanı klasörü oluştururken, bu klasörün kullanıcı ve grup sahipliğini kullanmayı planladığın PUID ve PGID ile eşleşecek şekilde ayarladığından emin olmalısın. Örneğin:

chown -R 1001:1002 /siyuan/workspace

Eğer özel PUID ve PGID değerleri kullanıyorsan, entrypoint betiği konteyner içinde doğru kullanıcı ve grubun oluşturulmasını sağlar ve bağlanan (mount edilen) birimlerin sahipliği buna göre otomatik olarak ayarlanır. Bu nedenle docker run veya docker-compose komutlarında manuel olarak -u parametresi vermene gerek yoktur; ortam değişkenleri bu özelleştirmeyi zaten otomatik olarak halleder.

Gizli Port

Port 6806’yı gizlemek için NGINX ters proxy (reverse proxy) kullan. Dikkat edilmesi gerekenler:

• WebSocket ters proxy’sini /ws yoluna göre yapılandır.

Notlar

• Bağlanan (mount edilen) disk birimlerinin doğru olduğundan emin ol; aksi halde konteyner silindiğinde veriler kaybolur.
• Yönlendirme (redirect) için URL yeniden yazımı (rewrite) kullanma; bu, kimlik doğrulamayla ilgili sorunlara neden olabilir. Bunun yerine ters proxy yapılandırmanı öneririz.
• Eğer izin sorunlarıyla karşılaşırsan, PUID ve PGID ortam değişkenlerinin, ana makinedeki bağlanan dizinlerin sahipliğiyle uyuştuğundan emin ol.

Kısıtlamalar

• Masaüstü ve mobil uygulama bağlantılarını desteklemez; yalnızca tarayıcı üzerinden kullanım mümkündür.
• PDF, HTML ve Word formatlarına dışa aktarma desteklenmez.
• Markdown dosyası içe aktarma desteklenmez.

Unraid Barındırma

Unraid Dağıtımı

Not: Terminalde önce şu komutu çalıştır: chown -R 1000:1000 /mnt/user/appdata/siyuan

Şablon referansı:

Web UI: 6806
Container Port: 6806
Container Path: /home/siyuan
Host path: /mnt/user/appdata/siyuan
PUID: 1000
PGID: 1000
Publish parameters: --accessAuthCode=******(Access authorization code)

Erken Önizleme (Insider Preview)

Büyük güncellemelerden önce erken erişim (Insider Preview) sürümlerini yayınlıyoruz. Lütfen https://github.com/siyuan-note/insider adresini ziyaret edin.

🏘️ Topluluk

• İngilizce Tartışma Forumu
• Kullanıcı topluluğu özeti
• Harika SiYuan (Awesome SiYuan)

🛠️ Geliştirme Rehberi

Geliştirme Rehberi sayfasına göz atın.

❓ SSS (Sıkça Sorulan Sorular)

SiYuan verileri nasıl saklar?

Veriler, çalışma alanı klasöründeki data klasöründe saklanır:

• assets: eklenen tüm varlıkların (dosya, resim vb.) kaydedildiği klasör
• emojis: emoji görsellerinin kaydedildiği klasör
• snippets: kod parçacıklarının kaydedildiği klasör
• storage: sorgular, düzenler ve ezber kartları gibi verilerin saklandığı klasör
• templates: şablon parçacıklarının kaydedildiği klasör
• widgets: bileşenlerin kaydedildiği klasör
• plugins: eklentilerin kaydedildiği klasör
• public: genel verilerin saklandığı klasör
• Diğer klasörler, kullanıcının oluşturduğu not defteri (notebook) klasörleridir. .sy uzantılı dosyalar belge verilerini saklar ve JSON formatındadır.

Üçüncü taraf senkronizasyon diskiyle veri senkronizasyonu destekleniyor mu?

Üçüncü taraf senkronizasyon diskleriyle (örneğin OneDrive, Dropbox vb.) veri senkronizasyonu desteklenmez. Aksi takdirde veriler bozulabilir.

Bununla birlikte, üyelik avantajları kapsamında üçüncü taraf bulut depolama hizmetleriyle bağlantı desteklenmektedir.

Alternatif olarak, verileri elle dışa aktarıp içe aktararak senkronizasyon sağlayabilirsin:

• Masaüstü: Ayarlar → Dışa Aktar → Verileri Dışa Aktar / Verileri İçe Aktar
• Mobil: Sağ panel → Hakkında → Verileri Dışa Aktar / Verileri İçe Aktar

SiYuan açık kaynak mı?

Evet, SiYuan tamamen açık kaynaklıdır ve katkılara açıktır:

• Kullanıcı Arayüzü ve Çekirdek
• Android
• iOS
• HarmonyOS
• Chrome Kırpma Uzantısı

Daha fazla bilgi için Geliştirme Rehberi sayfasına bakabilirsiniz.

Yeni bir sürüme nasıl yükseltilir?

• Uygulama mağazası üzerinden kurduysanız, güncellemeyi yine uygulama mağazası üzerinden yapın.
• Masaüstü kurulum paketiyle yüklediyseniz, Ayarlar → Hakkında → Güncelleme kurulum paketini otomatik indir seçeneğini etkinleştirin. Böylece SiYuan, en son sürüm kurulum paketini otomatik indirip yükleme uyarısı gösterecektir.
• Manuel yükleme yaptıysanız, en son kurulum paketini indirip yeniden yüklemeniz gerekir.

Ayrıca, Ayarlar → Hakkında → Geçerli Sürüm sekmesinden Güncellemeyi kontrol et seçeneğini kullanabilir veya Resmî İndirme Sayfası ya da GitHub Sürümleri sayfalarını takip edebilirsiniz.

Bazı bloklar (örneğin liste öğelerindeki paragraflar) blok simgesini bulamıyorsa ne yapmalıyım?

Liste öğesinin altındaki ilk alt blok, blok simgesi görünmeyen bloktur. İmleci bu bloğa getirip Ctrl+/ tuş kombinasyonuyla blok menüsünü açabilirsin.

Veri deposu anahtarı (data repo key) kaybolursa ne yapmalıyım?

• Eğer daha önce birden fazla cihazda doğru şekilde başlatıldıysa, tüm cihazlarda aynı anahtar kullanılır. Bu durumda anahtarı şu adımlarla kopyalayabilirsin: Ayarlar → Hakkında → Veri deposu anahtarı → Anahtar dizgesini kopyala

• Eğer cihazlar arasında farklı anahtarlar kullanılmışsa veya hiçbiri erişilebilir değilse, aşağıdaki adımlarla yeni bir anahtar oluşturabilirsin:

  1. Verilerini manuel olarak yedekle (Verileri Dışa Aktar seçeneğiyle veya dosya sisteminde workspace/data/ klasörünü kopyalayarak).
  2. Ayarlar → Hakkında → Veri deposu anahtarı → Veri deposunu sıfırla.
  3. Anahtarı yeniden başlat. Bir cihazda oluşturduktan sonra diğer cihazlara bu anahtarı aktar.
  4. Bulutta yeni senkronizasyon dizinini kullan; eski dizin artık erişilemez ve silinebilir.
  5. Mevcut bulut anlık görüntüleri (snapshot) artık geçerli değildir, bunlar da silinebilir.

Ücretli mi?

Çoğu özellik ücretsizdir — ticari kullanım da dahil.

Ancak üyelik ayrıcalıkları yalnızca ödeme sonrasında kullanılabilir. Detaylar için Fiyatlandırma sayfasına bakabilirsiniz.

🙏 Teşekkür

SiYuan’ın doğuşu, birçok açık kaynak projesi ve katkıcısının emeğiyle mümkün olmuştur. Daha fazla bilgi için proje kaynak kodlarındaki kernel/go.mod, app/package.json ve proje anasayfasına bakabilirsiniz.

SiYuan’ın gelişimi, kullanıcı geri bildirimleri ve desteğiyle büyümeye devam ediyor. SiYuan’a katkı sağlayan herkese teşekkürler ❤️

Katkıda Bulunanlar

Bize katıl ve SiYuan’a birlikte katkı yap! 💪