+
+---
+
+## İçindekiler
+
+* [💡 Giriş](#-giriş)
+* [🔮 Özellikler](#-özellikler)
+* [🏗️ Mimari ve Ekosistem](#-mimari-ve-ekosistem)
+* [🌟 Yıldız Geçmişi](#-yıldız-geçmişi)
+* [🗺️ Yol Haritası](#️-yol-haritası)
+* [🚀 İndirme ve Kurulum](#-indirme-ve-kurulum)
+ * [Uygulama Mağazası](#uygulama-mağazası)
+ * [Kurulum Paketi](#kurulum-paketi)
+ * [Paket Yöneticisi](#paket-yöneticisi)
+ * [Docker Barındırma](#docker-barındırma)
+ * [Unraid Barındırma](#unraid-barındırma)
+ * [Erken Önizleme (Insider Preview)](#erken-önizleme-insider-preview)
+* [🏘️ Topluluk](#️-topluluk)
+* [🛠️ Geliştirme Rehberi](#️-geliştirme-rehberi)
+* [❓ SSS (Sıkça Sorulan Sorular)](#-sss-sıkça-sorulan-sorular)
+ * [SiYuan verileri nasıl saklar?](#siyuan-verileri-nasıl-saklar)
+ * [Üçüncü taraf senkronizasyon diskiyle veri senkronizasyonu destekleniyor mu?](#üçüncü-taraf-senkronizasyon-diskiyle-veri-senkronizasyonu-destekleniyor-mu)
+ * [SiYuan açık kaynak mı?](#siyuan-açık-kaynak-mı)
+ * [Yeni bir sürüme nasıl yükseltilir?](#yeni-bir-sürüme-nasıl-yükseltilir)
+ * [Bazı bloklar (örneğin liste öğelerindeki paragraflar) blok simgesini bulamıyorsa ne yapmalıyım?](#bazı-bloklar-örneğin-liste-öğelerindeki-paragraflar-blok-simgesini-bulamıyorsa-ne-yapmalıyım)
+ * [Veri deposu anahtarını kaybedersem ne olur?](#veri-deposu-anahtarını-kaybedersem-ne-olur)
+ * [Ücretli mi?](#ücretli-mi)
+* [🙏 Teşekkür](#-teşekkür)
+ * [Katkıda Bulunanlar](#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](https://liuyun.io)’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](https://github.com/siyuan-note/siyuan/blob/master/API.md)
+* Topluluk pazaryeri
+
+Bazı özellikler yalnızca ücretli üyeler için geçerlidir. Detaylar için [Fiyatlandırma](https://b3log.org/siyuan/en/pricing.html) sayfasına göz atabilirsin.
+
+## 🏗️ Mimari ve Ekosistem
+
+
+
+| Proje | Açıklama | Çatallama (Forks) | Yıldız (Stars) |
+|----------------------------------------------------------|-----------------------|--------------------------------------------------------------------------------|------------------------------------------------------------------------------------|
+| [lute](https://github.com/88250/lute) | Editör motoru |  |  |
+| [chrome](https://github.com/siyuan-note/siyuan-chrome) | Chrome/Edge eklentisi |  |  |
+| [bazaar](https://github.com/siyuan-note/bazaar) | Topluluk pazaryeri |  |  |
+| [dejavu](https://github.com/siyuan-note/dejavu) | Veri deposu (repo) |  |  |
+| [petal](https://github.com/siyuan-note/petal) | Eklenti API’si |  |  |
+| [android](https://github.com/siyuan-note/siyuan-android) | Android uygulaması | | |
+| [ios](https://github.com/siyuan-note/siyuan-ios) | iOS uygulaması |  |  |
+| [harmony](https://github.com/siyuan-note/siyuan-harmony) | HarmonyOS uygulaması | | |
+| [riff](https://github.com/siyuan-note/riff) | Aralıklı tekrar motoru|  |  |
+
+## 🌟 Yıldız Geçmişi
+
+
+
+
+
+
+
+
+
+## 🗺️ Yol Haritası
+
+* [SiYuan geliştirme planı ve ilerleme durumu](https://github.com/orgs/siyuan-note/projects/1)
+* [SiYuan değişiklik günlüğü](CHANGELOG.md)
+
+## 🚀 İ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](https://apps.apple.com/us/app/siyuan/id1583226508)
+* [Google Play](https://play.google.com/store/apps/details?id=org.b3log.siyuan)
+* [F-Droid](https://f-droid.org/packages/org.b3log.siyuan)
+
+Masaüstü:
+
+* [Microsoft Store](https://apps.microsoft.com/detail/9p7hpmxp73k4)
+
+### Kurulum Paketi
+
+* [B3log](https://b3log.org/siyuan/en/download.html)
+* [GitHub](https://github.com/siyuan-note/siyuan/releases)
+
+### Paket Yöneticisi
+
+#### `siyuan`
+
+[](https://repology.org/project/siyuan/versions)
+
+#### `siyuan-note`
+
+[](https://repology.org/project/siyuan-note/versions)
+
+### 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ü](https://hub.docker.com/r/b3log/siyuan)
+
+#### 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:
+
+```bash
+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:
+
+```bash
+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:
+
+```yaml
+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:
+
+```bash
+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)
+```
+
+
+
+### 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](https://github.com/siyuan-note/insider) adresini ziyaret edin.
+
+## 🏘️ Topluluk
+
+* [İngilizce Tartışma Forumu](https://liuyun.io)
+* [Kullanıcı topluluğu özeti](https://liuyun.io/article/1687779743723)
+* [Harika SiYuan (Awesome SiYuan)](https://github.com/siyuan-note/awesome)
+
+## 🛠️ Geliştirme Rehberi
+
+[Geliştirme Rehberi](https://github.com/siyuan-note/siyuan/blob/master/.github/CONTRIBUTING.md) 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](https://github.com/siyuan-note/siyuan)
+* [Android](https://github.com/siyuan-note/siyuan-android)
+* [iOS](https://github.com/siyuan-note/siyuan-ios)
+* [HarmonyOS](https://github.com/siyuan-note/siyuan-harmony)
+* [Chrome Kırpma Uzantısı](https://github.com/siyuan-note/siyuan-chrome)
+
+Daha fazla bilgi için [Geliştirme Rehberi](https://github.com/siyuan-note/siyuan/blob/master/.github/CONTRIBUTING.md) 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ı](https://b3log.org/siyuan/en/download.html) ya da [GitHub Sürümleri](https://github.com/siyuan-note/siyuan/releases) sayfalarını takip edebilirsiniz.
+
+### Bazı bloklarda (örneğin liste öğelerindeki paragraf bloklarında) blok simgesi görünmü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](https://b3log.org/siyuan/en/pricing.html) 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! 💪
+
+
+
+
diff --git a/README_zh_CN.md b/README_zh_CN.md
index 06ded4116..dc17c9266 100644
--- a/README_zh_CN.md
+++ b/README_zh_CN.md
@@ -25,7 +25,7 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+