zengen 0.2.6 → 0.3.1

package/.zen/src/th-TH/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md

@@ -0,0 +1,71 @@
+---
+'title': 'ZEN - เครื่องสร้างเว็บไซต์แบบสแตติกสุดมินิมอลสำหรับ Markdown + AI'
+'summary': 'ZEN เป็นเครื่องสร้างเว็บไซต์แบบสแตติกที่ผสานความสามารถของ AI ออกแบบมาสำหรับเอกสาร Markdown โดยเฉพาะ ช่วยให้ผู้ใช้สามารถแปลงโฟลเดอร์ Git ที่มีไฟล์ Markdown ไปเป็นเว็บไซต์ HTML แบบสแตติกได้โดยไม่ต้องตั้งค่าซับซ้อน การตั้งค่าทั้งหมดถูกซ่อนไว้ในไดเรกทอรี .zen ฟีเจอร์หลักประกอบด้วยการนำทางแบบจัดหมวดหมู่อัจฉริยะ (ใช้ AI วิเคราะห์เนื้อหาเพื่อสร้างแผนที่เว็บไซต์) การแปลแบบเพิ่มเติมอัตโนมัติ (รองรับหลายภาษา ผู้ใช้สามารถเขียนด้วยภาษาหลักได้ โดยให้ AI จัดการแปล) และประสบการณ์การเขียนที่รบกวนผู้ใช้น้อยที่สุด คู่มือเริ่มต้นเร็วกำหนดให้ต้องติดตั้ง Node.js, รับ OpenAI API Key และ Git จากนั้นสร้างเว็บไซต์ผ่าน command line โดยรองรับการระบุภาษาและ URL ฐาน'
+'tags':
+  - 'เครื่องสร้างเว็บไซต์แบบสแตติก'
+  - 'Markdown'
+  - 'AI'
+  - 'การแปลหลายภาษา'
+  - 'มินิมอลลิสต์'
+  - 'เครื่องมือเอกสาร'
+  - 'Git'
+'inferred_lang': 'zh-Hans'
+---
+
+# ZEN - เครื่องสร้างเว็บไซต์แบบสแตติกสุดมินิมอลสำหรับ Markdown + AI
+
+[> ตัวอย่างเว็บไซต์](https://zen.zccz14.com/)
+
+## ฟังก์ชันพื้นฐาน
+
+1. 📃 **การสร้างเว็บไซต์แบบสแตติก**: แปลงโฟลเดอร์ git ใดๆ ที่มี Markdown ไปเป็นเว็บไซต์ HTML แบบสแตติก
+2. 🧭 **การนำทางแบบจัดหมวดหมู่อัจฉริยะ**: ใช้ AI วิเคราะห์เนื้อหาเพื่อสร้างแผนที่เว็บไซต์และการนำทาง โดยไม่ขึ้นกับตำแหน่งของไฟล์ต้นฉบับ
+3. 🌍 **การแปลแบบเพิ่มเติมอัตโนมัติ**: ใช้ AI ทำการแปลแบบเพิ่มเติม ทำให้ผู้ใช้สามารถเขียน Markdown ด้วยภาษาหลักของตน แต่ผู้ใช้สามารถเข้าถึงเนื้อหาได้หลายภาษา
+
+ทำไมถึงต้องสร้างเครื่องสร้างเว็บไซต์แบบสแตติกสำหรับ Markdown ขึ้นมาอีก? ผมได้ทบทวนใหม่ว่าในยุคของ AI เครื่องมือเอกสารสามารถบริการผู้เขียนได้ดีขึ้นอย่างไร:
+
+- กลับสู่เนื้อหา: รบกวนน้อยที่สุด มุ่งเน้นที่การเขียน
+
+  ทำให้เอกสารกลับสู่แก่นแท้ ทำให้การเขียนกลับสู่ความสงบ
+
+  ประการแรก ผมไม่อยากเป็นบรรณารักษ์ บางครั้งผมอยากเขียนอะไรบางอย่าง แต่ผมอาจยังไม่ได้คิดชื่อเรื่องให้ดี หรือยังไม่ได้จัดระเบียบเป็นพิเศษ ผมหวังว่า LLM จะช่วยสร้างชื่อเรื่อง สรุปเนื้อหา จัดหมวดหมู่ สร้างการนำทาง และงานจัดระเบียบอื่นๆ ให้โดยอัตโนมัติ
+
+  ประการที่สอง ห้องทำงานของผมต้องสะอาดเรียบร้อย ผมไม่ต้องการเครื่องมือสร้างที่ต้องตั้งค่าซับซ้อน ยุ่งยากกับการตั้งค่าเอกสารที่ซับซ้อน ไม่ชอบโครงสร้างที่วุ่นวาย ทุกครั้งที่เห็นไฟล์การตั้งค่าและโครงสร้างโปรเจกต์ของเครื่องมืออย่าง Docusaurus, VuePress, Astro ผมก็ปวดหัว ตอนนี้ ZEN เลือกที่จะซ่อนการตั้งค่าทั้งหมดไว้ในไดเรกทอรี .zen ซ่อนไว้ในมุมห้อง ผู้ใช้เพียงแค่ต้องโฟกัสที่การเขียนเนื้อหา ส่วนที่เหลือให้ ZEN จัดการ ไดเรกทอรีอื่นๆ ทั้งหมดคือพื้นที่การเขียนของคุณ คุณสามารถจัดระเบียบไฟล์ Markdown ของคุณได้ตามต้องการ
+
+- กลับสู่ภาษาหลัก: เขียนด้วยภาษาหลัก สร้างเวอร์ชันหลายภาษาได้อย่างลื่นไหล
+
+  ชีวิตสั้นนัก ผมขี้เกียจแปล เวลาที่คนใช้ภาษาหลักของตน นั่นคือเวลาที่สามารถดึงเอาความลึกซึ้งของการคิดออกมาได้มากที่สุด แต่ในขณะเดียวกัน การเชื่อมต่อกับโลกก็เป็นสิ่งจำเป็น ผมไม่อยากเสียโอกาสในการสื่อสารหลายภาษา ดังนั้นผมจึงหวังว่าจะมีเครื่องมือที่ทำให้ผมเขียนด้วยภาษาหลักได้ ในขณะเดียวกันก็ทำให้คนอื่นๆ ได้เห็นเนื้อหาของผมมากขึ้น ปัจจุบัน i18n นั้นนอกจากต้องแปลเองแล้ว ยังต้องดูแลการอัปเดตเนื้อหาด้วยตัวเองอีก ซึ่งยุ่งยากมาก ผมเลือกใช้ LLM ช่วยแปล ประหยัดเวลาไปได้มาก และสามารถแปลเป็นหลายภาษาได้ด้วยคลิกเดียว
+
+## เริ่มต้นเร็ว
+
+ข้อกำหนดเบื้องต้น:
+
+- ติดตั้ง [Node.js](https://nodejs.org/) แล้ว (แนะนำเวอร์ชัน 18 ขึ้นไป ต้องมีคำสั่ง npx)
+- ได้รับ [OpenAI API Key](https://platform.openai.com/account/api-keys) แล้ว หรือ OPENAI compatible API Key
+- ติดตั้ง Git แล้ว (ใช้สำหรับแสดงรายการไฟล์ Markdown จาก Git และไม่รวมไฟล์ที่ถูกกรองโดยกฎ .gitignore)
+
+ขั้นแรก ทำงานในโฟลเดอร์ที่ถูกจัดการโดย git อยู่แล้ว:
+
+ตั้งค่าตัวแปรสภาพแวดล้อม
+
+```bash
+export OPENAI_API_KEY="sk-xxxxxx"  # จำเป็น: โปรดแทนที่ด้วย OpenAI API Key ของคุณ
+export OPENAI_BASE_URL="https://api.openai.com/v1"  # ไม่บังคับ ค่าเริ่มต้นใช้ OpenAI official API
+export OPENAI_MODEL="gpt-3.5-turbo"  # ไม่บังคับ ค่าเริ่มต้นใช้โมเดล gpt-3.5-turbo
+```
+
+สร้างเว็บไซต์ รองรับการแปลหลายภาษา ใช้ไดเรกทอรีปัจจุบันเป็นไดเรกทอรีต้นทาง และส่งออกไปยังไดเรกทอรี `.zen/dist`
+
+- สามารถระบุเวอร์ชันภาษาที่ต้องการสร้างได้โดยใช้พารามิเตอร์ `--lang` หลายครั้ง (เช่น `--lang zh-Hans --lang en-US`)
+- สามารถระบุ URL ฐานของเว็บไซต์ได้โดยใช้พารามิเตอร์ `--base-url` (เช่น ชื่อรีพอสิทอรีบน GitHub Pages)
+- ไม่จำเป็นต้องตั้งค่าภาษาต้นทาง ZEN จะตรวจจับโดยอัตโนมัติ
+
+```bash
+npx zengen@latest build --lang zh-Hans --lang en-US
+```
+
+**ดูพารามิเตอร์เพิ่มเติมหรือความช่วยเหลือ**:
+
+```bash
+npx zengen@latest
+```

package/.zen/src/tr-TR/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md

@@ -0,0 +1,121 @@
+---
+'title': 'Mermaid Diyagram Test Dokümanı'
+'summary': "Bu doküman, ZEN'deki Mermaid diyagram oluşturma işlevini doğrulamak için kullanılan bir test dosyasıdır. Akış şeması, sıralama diyagramı, Gantt şeması, sınıf diyagramı, durum diyagramı ve pasta grafik gibi çeşitli Mermaid diyagram türlerinin örneklerini içerir ve hata mesajı görüntülemesini kontrol etmek için hatalı bir sözdizimi testi de bulunur. Doküman, Mermaid entegrasyonunun ZEN'de düzgün çalıştığını göstermeyi amaçlamaktadır."
+'tags':
+  - 'Mermaid'
+  - 'Diyagram Testi'
+  - 'ZEN'
+  - 'Akış Şeması'
+  - 'Sıralama Diyagramı'
+  - 'Gantt Şeması'
+  - 'Sınıf Diyagramı'
+  - 'Durum Diyagramı'
+'inferred_date': '2024-01-01'
+'inferred_lang': 'tr-TR'
+---
+
+# Mermaid Diyagram Testi
+
+Bu, ZEN'deki Mermaid diyagram oluşturma işlevini doğrulamak için kullanılan bir test dosyasıdır.
+
+## Akış Şeması Örneği
+
+```mermaid
+graph TD
+    A[Başla] --> B{Devam edilsin mi?}
+    B -->|Evet| C[İşlemi gerçekleştir]
+    B -->|Hayır| D[Son]
+    C --> E[Sonucu kontrol et]
+    E --> F{Başarılı mı?}
+    F -->|Evet| G[Tamamlandı]
+    F -->|Hayır| H[Yeniden dene]
+    H --> C
+    G --> D
+```
+
+## Sıralama Diyagramı Örneği
+
+```mermaid
+sequenceDiagram
+    participant Kullanıcı
+    participant Sistem
+    participant Veritabanı
+
+    Kullanıcı->>Sistem: İstek gönder
+    Sistem->>Veritabanı: Veri sorgula
+    Veritabanı-->>Sistem: Sonuçları döndür
+    Sistem-->>Kullanıcı: Sonuçları göster
+```
+
+## Gantt Şeması Örneği
+
+```mermaid
+gantt
+    title Proje Zaman Çizelgesi
+    dateFormat  YYYY-MM-DD
+    section Tasarım
+    Gereksinim Analizi     :done,    des1, 2024-01-01, 7d
+    Prototip Tasarımı      :active,  des2, 2024-01-08, 5d
+    Detaylı Tasarım        :         des3, after des2, 5d
+    section Geliştirme
+    Ön Yüz Geliştirme      :         dev1, after des3, 10d
+    Arka Yüz Geliştirme    :         dev2, after des3, 15d
+    section Test
+    Birim Testleri         :         test1, after dev1, 5d
+    Entegrasyon Testleri   :         test2, after dev2, 5d
+```
+
+## Sınıf Diyagramı Örneği
+
+```mermaid
+classDiagram
+    class Hayvan {
+        +String ad
+        +int yaş
+        +void ye()
+        +void uyu()
+    }
+    class Köpek {
+        +void havla()
+    }
+    class Kedi {
+        +void miyavla()
+    }
+
+    Hayvan <|-- Köpek
+    Hayvan <|-- Kedi
+```
+
+## Durum Diyagramı Örneği
+
+```mermaid
+stateDiagram-v2
+    [*] --> Boşta
+    Boşta --> İşleniyor : İşlemi başlat
+    İşleniyor --> Başarılı : İşlem başarılı
+    İşleniyor --> Hata : İşlem başarısız
+    Başarılı --> [*]
+    Hata --> [*]
+```
+
+## Pasta Grafik Örneği
+
+```mermaid
+pie title Tarayıcı Kullanım Oranları
+    "Chrome" : 65.2
+    "Firefox" : 15.3
+    "Safari" : 12.5
+    "Edge" : 5.2
+    "Diğer" : 1.8
+```
+
+## Hatalı Sözdizimi Testi (hata mesajı göstermeli)
+
+```mermaid
+graph TD
+    A --> B
+    // Burada ok tanımı eksik
+    C --> D
+```
+
+Bu test dosyası, ZEN'deki Mermaid entegrasyonunun düzgün çalışıp çalışmadığını doğrulamak için çeşitli Mermaid diyagram türlerini içermektedir.

package/.zen/src/tr-TR/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md

@@ -0,0 +1,70 @@
+---
+'title': 'ZEN - Minimalist Markdown + AI Statik Site Oluşturucu'
+'summary': "ZEN, AI entegreli bir statik site oluşturucudur ve belge yazımı ile site inşa sürecini basitleştirmeye odaklanır. Kullanıcıların, git ile yönetilen bir klasörde Markdown kullanarak karmaşık yapılandırmaya gerek kalmadan statik HTML siteler oluşturmasına olanak tanır; tüm ayarlar .zen dizini altında gizlidir. Temel özellikleri arasında akıllı kategorilendirme ve navigasyon (AI ile içerik analizi yaparak site haritası oluşturur), otomatik artımlı çeviri (çok dilli versiyonları destekler, kullanıcılar ana dillerinde yazabilir, AI çeviriyi halleder) ve en az rahatsızlık veren bir yazım deneyimi bulunur. Araç, Node.js, OpenAI API Anahtarı ve Git'e bağımlıdır; komut satırı üzerinden hızlıca inşa edilebilir ve zh-Hans, en-US gibi dil parametrelerini belirlemeyi destekler."
+'tags':
+  - 'Statik Site Oluşturucu'
+  - 'Markdown'
+  - 'AI'
+  - 'Çok Dilli Çeviri'
+  - 'Minimalizm'
+  - 'Belge Aracı'
+  - 'ZEN'
+'inferred_lang': 'zh-Hans'
+---
+
+# ZEN - Minimalist Markdown + AI Statik Site Oluşturucu
+
+[> Website Demo](https://zen.zccz14.com/)
+
+## Temel Özellikler
+
+1. 📃 **Statik Site Oluşturma**: Markdown içeren herhangi bir git klasörünü statik bir HTML sitesine dönüştürür.
+2. 🧭 **Akıllı Kategorilendirme ve Navigasyon**: AI kullanarak içerik analizi yapar, site haritası ve navigasyon oluşturur; kaynak dosyaların konumu önemli değildir.
+3. 🌍 **Otomatik Artımlı Çeviri**: AI ile artımlı çeviri yapar, kullanıcıların ana dillerinde Markdown yazmasına izin verir, ancak kullanıcılar çok dilli olabilir.
+
+Neden bir Markdown statik site oluşturucusu daha yapıldı? AI çağında, belge araçlarının yazarlara nasıl daha iyi hizmet edebileceğini yeniden düşündüm:
+
+- İçeriğe Dönüş: Minimum rahatsızlık, yazmaya odaklanma
+
+  Belgeleri özüne döndürmek, yazmayı huzura kavuşturmak.
+
+  Birincisi, kütüphaneci olmak istemiyorum. Bazen bir şeyler yazmak isterim ama henüz başlığını düşünmemiş, özel bir organizasyon oluşturmamış olabilirim. LLM'nin başlık oluşturma, özet çıkarma, kategorilendirme, navigasyon gibi düzenleme işlerini otomatik yapmasını umuyorum.
+
+  İkincisi, çalışma odam temiz olmalı. Karmaşık yapılandırmalı inşa araçları, karmaşık belge ayarlarıyla uğraşmak, karmaşık yapılar istemiyorum. Docusaurus, VuePress, Astro gibi araçların yapılandırma dosyalarını ve proje yapılarını her gördüğümde başım ağrıyor. Şimdi, ZEN tüm ayarları .zen dizini altına gizlemeyi, köşeye süpürmeyi seçiyor; kullanıcı sadece yazım içeriğine odaklanıyor, gerisini ZEN halleder. Diğer dizinler sizin yazım alanınızdır, Markdown dosyalarınızı istediğiniz gibi düzenleyebilirsiniz.
+
+- Ana Dile Dönüş: Ana dilde yazın, akıcı çok dilli versiyonlar oluşturun
+
+  Hayat kısa, çeviri yapmaya üşeniyorum. İnsanlar ana dillerini kullanırken düşünme derinliklerini en iyi şekilde ortaya koyabilir. Ancak aynı zamanda dünyayla bağlantıda kalmak gereklidir, çok dilli iletişimden vazgeçmek istemiyorum. Bu yüzden, ana dilimde yazmama izin veren, aynı zamanda içeriğimi daha fazla kişinin görmesini sağlayan bir araç istiyorum. Mevcut i18n, kendi çevirinizi yapmanızı gerektiriyor, üstelik içerik güncellemelerini de kendiniz yönetmelisiniz, çok zahmetli. Çeviriyi yapmak için LLM'yi kullanmayı seçiyorum, bu bana çok zaman kazandırıyor ve tek tıkla çoklu dil çevirisi yapılabiliyor.
+
+## Hızlı Başlangıç
+
+Önkoşullar:
+
+- [Node.js](https://nodejs.org/) kurulu olmalı (tercihen sürüm 18 ve üzeri, npx komutu gereklidir)
+- [OpenAI API Anahtarı](https://platform.openai.com/account/api-keys) alınmış olmalı veya OPENAI uyumlu bir API Anahtarı
+- Git kurulu olmalı (Git'ten Markdown dosyalarını listelemek, .gitignore kurallarıyla filtrelenen dosyaları yok saymak için)
+
+Öncelikle, git ile yönetilen bir klasörde çalışın:
+
+Ortam değişkenlerini yapılandırın
+
+```bash
+export OPENAI_API_KEY="sk-xxxxxx"  # Zorunlu: Lütfen kendi OpenAI API Anahtarınızla değiştirin
+export OPENAI_BASE_URL="https://api.openai.com/v1"  # İsteğe bağlı, varsayılan olarak OpenAI resmi API'si kullanılır
+export OPENAI_MODEL="gpt-3.5-turbo"  # İsteğe bağlı, varsayılan olarak gpt-3.5-turbo modeli kullanılır
+```
+
+Siteyi inşa edin, çok dilli çeviriyi destekler. Mevcut dizini kaynak dizin olarak kullanır, `.zen/dist` dizinine çıktı verir.
+
+- `--lang` parametresini birden fazla kez kullanarak oluşturulacak dil versiyonlarını belirtebilirsiniz (örneğin `--lang zh-Hans --lang en-US`).
+- Kaynak dili yapılandırmaya gerek yoktur, ZEN otomatik algılar.
+
+```bash
+npx zengen@latest build --lang zh-Hans --lang en-US
+```
+
+**Daha fazla parametre veya yardım görüntüleyin**:
+
+```bash
+npx zengen@latest
+```

package/.zen/src/tr-TR/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md

@@ -0,0 +1,71 @@
+---
+'title': 'ZEN - Minimalist Markdown + AI Statik Site Oluşturucu'
+'summary': 'ZEN, Markdown belgeleri için tasarlanmış, AI özellikleriyle birleştirilmiş bir statik site oluşturucudur. Kullanıcıların Markdown dosyaları içeren bir Git klasörünü, karmaşık yapılandırmaya gerek kalmadan statik bir HTML sitesine dönüştürmesine olanak tanır; tüm ayarlar .zen dizininde gizlidir. Temel özellikler arasında akıllı kategorilendirme ve navigasyon (AI kullanarak içerik analizi yaparak site haritası oluşturma), otomatik artımlı çeviri (çok dilli sürümleri destekler, kullanıcılar ana dillerinde yazabilir, AI çeviriyi işler) ve en az rahatsızlık veren bir yazma deneyimi bulunur. Hızlı başlangıç kılavuzu, Node.js kurulumu, OpenAI API Anahtarı ve Git edinimi gerektirir; komut satırı üzerinden site oluşturmayı destekler ve dil ile temel URL belirtmeye izin verir.'
+'tags':
+  - 'Statik Site Oluşturucu'
+  - 'Markdown'
+  - 'AI'
+  - 'Çok Dilli Çeviri'
+  - 'Minimalizm'
+  - 'Belge Aracı'
+  - 'Git'
+'inferred_lang': 'zh-Hans'
+---
+
+# ZEN - Minimalist Markdown + AI Statik Site Oluşturucu
+
+[> Website Demo](https://zen.zccz14.com/)
+
+## Temel Özellikler
+
+1. 📃 **Statik Site Oluşturma**: Markdown içeren herhangi bir git klasörünü statik bir HTML sitesine dönüştürür.
+2. 🧭 **Akıllı Kategorilendirme ve Navigasyon**: AI kullanarak içerik analizi yapar, site haritası ve navigasyon oluşturur; kaynak dosyaların konumu önemli değildir.
+3. 🌍 **Otomatik Artımlı Çeviri**: AI kullanarak artımlı çeviri yapar, kullanıcıların ana dillerinde Markdown yazmasına olanak tanır, ancak kullanıcılar çok dilli olabilir.
+
+Neden bir Markdown statik site oluşturucusu daha yapıldı? AI çağında, belge araçlarının yazarlara nasıl daha iyi hizmet edebileceğini yeniden düşündüm:
+
+- İçeriğe Dönüş: En az rahatsızlık, yazmaya odaklanma
+
+  Belgeleri özüne döndürmek, yazmayı huzura kavuşturmak.
+
+  Birincisi, kütüphaneci olmak istemiyorum. Bazen bir şeyler yazmak isterim, ancak henüz başlığını düşünmemiş, özel bir organizasyon oluşturmamış olabilirim. LLM'nin başlık oluşturma, özet çıkarma, kategorilendirme, navigasyon gibi düzenleme işlerini otomatik olarak yapmasını umuyorum.
+
+  İkincisi, çalışma odam temiz olmalı. Karmaşık yapılandırmalı derleme araçları, karmaşık belge ayarlarıyla uğraşmak, karmaşık yapıları sevmiyorum. Docusaurus, VuePress, Astro gibi araçların yapılandırma dosyalarını ve proje yapılarını her gördüğümde başım ağrıyor. Şimdi, ZEN tüm yapılandırmaları .zen dizinine gizlemeyi seçiyor, köşeye süpürüyor; kullanıcılar sadece yazma içeriğine odaklanıyor, gerisini ZEN hallediyor. Diğer dizinler sizin yazma alanınızdır, Markdown dosyalarınızı istediğiniz gibi düzenleyebilirsiniz.
+
+- Ana Dile Dönüş: Ana dilde yazma, akıcı çok dilli sürüm oluşturma
+
+  Hayat kısa, çeviri yapmaya üşeniyorum. İnsanlar ana dillerini kullanırken düşünme derinliklerini en iyi şekilde ortaya koyabilirler. Ancak aynı zamanda dünyayla bağlantıda kalmak gereklidir, çok dilli iletişimi bırakmak istemiyorum. Bu yüzden, ana dilimde yazmama izin veren, aynı zamanda içeriğimi daha fazla kişinin görmesini sağlayan bir araç istiyorum. Mevcut i18n, kendi çevirinizi yapmanızı gerektiriyor, ayrıca içerik güncellemelerini de kendiniz yönetmelisiniz, çok zahmetli. Çeviriyi yapmak için LLM'yi kullanmayı seçiyorum, bu bana çok zaman kazandırıyor ve tek tıkla çoklu dil çevirisi yapılabiliyor.
+
+## Hızlı Başlangıç
+
+Önkoşullar:
+
+- [Node.js](https://nodejs.org/) kurulu (18 ve üzeri sürüm önerilir, npx komutu gereklidir)
+- [OpenAI API Anahtarı](https://platform.openai.com/account/api-keys) edinilmiş veya OPENAI uyumlu bir API Anahtarı
+- Git kurulu (Git'ten Markdown dosyalarını listelemek ve .gitignore kurallarıyla filtrelenen dosyaları yok saymak için)
+
+Öncelikle, zaten git tarafından yönetilen bir klasörde çalışın:
+
+Ortam değişkenlerini yapılandırın
+
+```bash
+export OPENAI_API_KEY="sk-xxxxxx"  # Zorunlu: Lütfen kendi OpenAI API Anahtarınızla değiştirin
+export OPENAI_BASE_URL="https://api.openai.com/v1"  # İsteğe bağlı, varsayılan olarak OpenAI resmi API'si kullanılır
+export OPENAI_MODEL="gpt-3.5-turbo"  # İsteğe bağlı, varsayılan olarak gpt-3.5-turbo modeli kullanılır
+```
+
+Siteyi oluşturun, çok dilli çeviriyi destekler. Kaynak dizin olarak mevcut dizini kullanır, çıktıyı `.zen/dist` dizinine verir.
+
+- `--lang` parametresini birden fazla kez kullanarak oluşturulacak dil sürümlerini belirtebilirsiniz (örneğin `--lang zh-Hans --lang en-US`).
+- `--base-url` parametresiyle sitenin temel URL önekini belirtebilirsiniz (örneğin GitHub Pages'teki depo adı).
+- Kaynak dili yapılandırmaya gerek yoktur, ZEN otomatik olarak algılar.
+
+```bash
+npx zengen@latest build --lang zh-Hans --lang en-US
+```
+
+**Daha fazla parametre veya yardım görüntüleyin**:
+
+```bash
+npx zengen@latest
+```

package/.zen/src/uk-UA/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md

@@ -0,0 +1,121 @@
+---
+'title': 'Тестовий документ для діаграм Mermaid'
+'summary': 'Цей документ є тестовим файлом для перевірки функціоналу відображення діаграм Mermaid у ZEN. Він містить приклади різних типів діаграм Mermaid, таких як блок-схеми, діаграми послідовності, діаграми Ганта, діаграми класів, діаграми станів та кругові діаграми, а також включає тест з помилковою синтаксичною конструкцією для перевірки відображення повідомлень про помилки. Документ призначений для демонстрації коректної роботи інтеграції Mermaid у ZEN.'
+'tags':
+  - 'Mermaid'
+  - 'Тестування діаграм'
+  - 'ZEN'
+  - 'Блок-схеми'
+  - 'Діаграми послідовності'
+  - 'Діаграми Ганта'
+  - 'Діаграми класів'
+  - 'Діаграми станів'
+'inferred_date': '2024-01-01'
+'inferred_lang': 'uk-UA'
+---
+
+# Тестування діаграм Mermaid
+
+Це тестовий файл для перевірки функціоналу відображення діаграм Mermaid у ZEN.
+
+## Приклад блок-схеми
+
+```mermaid
+graph TD
+    A[Початок] --> B{Продовжити?}
+    B -->|Так| C[Виконати дію]
+    B -->|Ні| D[Кінець]
+    C --> E[Перевірити результат]
+    E --> F{Успішно?}
+    F -->|Так| G[Завершено]
+    F -->|Ні| H[Повторити]
+    H --> C
+    G --> D
+```
+
+## Приклад діаграми послідовності
+
+```mermaid
+sequenceDiagram
+    participant Користувач
+    participant Система
+    participant БазаДаних
+
+    Користувач->>Система: Надіслати запит
+    Система->>БазаДаних: Запит даних
+    БазаДаних-->>Система: Повернути результат
+    Система-->>Користувач: Показати результат
+```
+
+## Приклад діаграми Ганта
+
+```mermaid
+gantt
+    title Розклад проекту
+    dateFormat  YYYY-MM-DD
+    section Дизайн
+    Аналіз вимог     :done,    des1, 2024-01-01, 7d
+    Проектування прототипу :active,  des2, 2024-01-08, 5d
+    Детальне проектування :         des3, after des2, 5d
+    section Розробка
+    Фронтенд-розробка :         dev1, after des3, 10d
+    Бекенд-розробка  :         dev2, after des3, 15d
+    section Тестування
+    Модульне тестування :         test1, after dev1, 5d
+    Інтеграційне тестування :         test2, after dev2, 5d
+```
+
+## Приклад діаграми класів
+
+```mermaid
+classDiagram
+    class Тварина {
+        +String ім'я
+        +int вік
+        +void їсти()
+        +void спати()
+    }
+    class Собака {
+        +void гавкати()
+    }
+    class Кіт {
+        +void нявкати()
+    }
+
+    Тварина <|-- Собака
+    Тварина <|-- Кіт
+```
+
+## Приклад діаграми станів
+
+```mermaid
+stateDiagram-v2
+    [*] --> Очікування
+    Очікування --> Обробка : Почати обробку
+    Обробка --> Успіх : Обробка успішна
+    Обробка --> Помилка : Обробка невдала
+    Успіх --> [*]
+    Помилка --> [*]
+```
+
+## Приклад кругової діаграми
+
+```mermaid
+pie title Частка використання браузерів
+    "Chrome" : 65.2
+    "Firefox" : 15.3
+    "Safari" : 12.5
+    "Edge" : 5.2
+    "Інші" : 1.8
+```
+
+## Тест з помилковою синтаксичною конструкцією (має відображати повідомлення про помилку)
+
+```mermaid
+graph TD
+    A --> B
+    // Тут відсутнє визначення стрілки
+    C --> D
+```
+
+Цей тестовий файл містить різні типи діаграм Mermaid для перевірки коректної роботи інтеграції Mermaid у ZEN.

package/.zen/src/uk-UA/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md

@@ -0,0 +1,70 @@
+---
+'title': 'ZEN - Мінімалістичний Markdown + AI генератор статичних сайтів'
+'summary': 'ZEN — це генератор статичних сайтів з інтеграцією штучного інтелекту, орієнтований на спрощення процесу написання та створення документації. Він дозволяє користувачам створювати статичні HTML-сайти з використанням Markdown у папках, що керуються через git, без складних налаштувань — усі конфігурації приховані в каталозі .zen. Ключові функції включають інтелектуальну навігацію за категоріями (генерація карти сайту через аналіз контенту AI), автоматичний інкрементний переклад (підтримка багатомовних версій, дозволяє писати рідною мовою з перекладом AI) та мінімалістичний досвід написання без зайвих відволікань. Інструмент вимагає Node.js, ключ API OpenAI та Git, швидко будується через командний рядок і підтримує параметри мов, такі як zh-Hans та en-US.'
+'tags':
+  - 'Генератор статичних сайтів'
+  - 'Markdown'
+  - 'Штучний інтелект'
+  - 'Багатомовний переклад'
+  - 'Мінімалізм'
+  - 'Інструмент для документації'
+  - 'ZEN'
+'inferred_lang': 'zh-Hans'
+---
+
+# ZEN - Мінімалістичний Markdown + AI генератор статичних сайтів
+
+[> Демо сайту](https://zen.zccz14.com/)
+
+## Основні функції
+
+1. 📃 **Генерація статичних сайтів**: Перетворює будь-яку папку з файлами Markdown, що керується через git, на статичний HTML-сайт.
+2. 🧭 **Інтелектуальна навігація за категоріями**: Використовує AI для аналізу контенту, генерує карту сайту та навігацію, незалежно від розташування вихідних файлів.
+3. 🌍 **Автоматичний інкрементний переклад**: Використовує AI для поступового перекладу, дозволяючи користувачам писати Markdown рідною мовою, але отримувати багатомовний контент.
+
+Чому я створив ще один генератор статичних сайтів на Markdown? Я переосмислив, як інструменти для документації можуть краще служити авторам в епоху AI:
+
+- Повернення до контенту: Мінімум відволікань, максимум зосередженості на написанні
+
+  Поверніть документацію до її сутності, а написанню — спокій.
+
+  По-перше, я не хочу бути бібліотекарем. Іноді я хочу щось записати, але ще не визначився з заголовком або структурою. Я хочу, щоб LLM автоматично генерував заголовки, робив резюме, класифікував та створював навігацію.
+
+  По-друге, мій робочий простір має бути чистим. Мені не потрібні складні інструменти зі заплутаними налаштуваннями та структурою. Кожного разу, коли я бачу конфігураційні файли та структуру проектів у Docusaurus, VuePress чи Astro, у мене болить голова. Тепер ZEN ховає всі налаштування в каталозі .zen, залишаючи користувачам лише написання контенту, а решту обробляє сам. Всі інші каталоги — ваш робочий простір, де ви можете вільно організовувати файли Markdown.
+
+- Повернення до рідної мови: Пишіть рідною мовою, легко створюйте багатомовні версії
+
+  Життя коротке, мені ліньки перекладати. Коли людина пише рідною мовою, вона може найглибше висловлювати свої думки. Але підтримка зв'язку зі світом також важлива, і я не хочу втрачати можливість спілкування багатьма мовами. Тому мені потрібен інструмент, який дозволить мені писати рідною мовою, але також зробить мій контент доступним для більшої аудиторії. Сучасні рішення для i18n вимагають самостійного перекладу та підтримки оновлень, що займає багато часу. Я використовую LLM для перекладу, що економить мій час і дозволяє створювати багатомовні версії в один клік.
+
+## Швидкий старт
+
+Передумови:
+
+- Встановлений [Node.js](https://nodejs.org/) (рекомендована версія 18 або вище, потрібна команда npx)
+- Отриманий [OpenAI API Key](https://platform.openai.com/account/api-keys) або сумісний з OpenAI ключ API
+- Встановлений Git (для отримання списку файлів Markdown з Git, ігноруючи файли, відфільтровані за правилами .gitignore)
+
+Спочатку працюйте в папці, яка вже керується через git:
+
+Налаштуйте змінні середовища
+
+```bash
+export OPENAI_API_KEY="sk-xxxxxx"  # Обов'язково: замініть на ваш OpenAI API Key
+export OPENAI_BASE_URL="https://api.openai.com/v1"  # Опціонально, за замовчуванням використовується офіційний API OpenAI
+export OPENAI_MODEL="gpt-3.5-turbo"  # Опціонально, за замовчуванням використовується модель gpt-3.5-turbo
+```
+
+Побудуйте сайт з підтримкою багатомовного перекладу. Використовуйте поточний каталог як вихідний, результат буде в каталозі `.zen/dist`.
+
+- Можна вказати необхідні мовні версії, використовуючи параметр `--lang` кілька разів (наприклад, `--lang zh-Hans --lang en-US`).
+- Вихідну мову налаштовувати не потрібно, ZEN визначить її автоматично.
+
+```bash
+npx zengen@latest build --lang zh-Hans --lang en-US
+```
+
+**Переглянути більше параметрів або отримати довідку**:
+
+```bash
+npx zengen@latest
+```

package/.zen/src/uk-UA/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md

@@ -0,0 +1,71 @@
+---
+'title': 'ZEN - Мінімалістичний генератор статичних сайтів Markdown + AI'
+'summary': 'ZEN — це генератор статичних сайтів з функціями AI, розроблений для документів Markdown. Він дозволяє користувачам перетворювати Git-папки з файлами Markdown на статичні HTML-сайти без складних налаштувань, усі конфігурації приховані в каталозі .zen. Основні функції включають інтелектуальну навігацію за категоріями (використовуючи AI для аналізу вмісту та створення карти сайту), автоматичний інкрементний переклад (підтримка багатомовних версій, дозволяє користувачам писати рідною мовою, а AI обробляє переклад) та мінімалістичний досвід письма. Швидкий старт вимагає встановлення Node.js, отримання OpenAI API Key та Git, побудова сайту через командний рядок з підтримкою вказання мови та базової URL-адреси.'
+'tags':
+  - 'Генератор статичних сайтів'
+  - 'Markdown'
+  - 'AI'
+  - 'Багатомовний переклад'
+  - 'Мінімалізм'
+  - 'Інструмент для документів'
+  - 'Git'
+'inferred_lang': 'uk-UA'
+---
+
+# ZEN - Мінімалістичний генератор статичних сайтів Markdown + AI
+
+[> Демо сайту](https://zen.zccz14.com/)
+
+## Основні функції
+
+1. 📃 **Генерація статичних сайтів**: Перетворює будь-яку Git-папку з файлами Markdown на статичний HTML-сайт.
+2. 🧭 **Інтелектуальна навігація за категоріями**: Використовує AI для аналізу вмісту, створення карти сайту та навігації, незалежно від розташування вихідних файлів.
+3. 🌍 **Автоматичний інкрементний переклад**: Використовує AI для інкрементного перекладу, дозволяючи користувачам писати Markdown рідною мовою, але з підтримкою багатомовності.
+
+Чому я створив ще один генератор статичних сайтів для Markdown? Я переосмислив, як інструменти для документів можуть краще служити письменникам в епоху AI:
+
+- Повернення до змісту: Мінімалізувати відволікання, зосередитись на письмі
+
+  Повернути документам їхню сутність, а письму — спокій.
+
+  По-перше, я не хочу бути бібліотекарем. Іноді я хочу щось записати, але ще не визначився з заголовком або структурою. Я хочу, щоб LLM автоматично генерував заголовки, робив резюме, класифікував та організовував навігацію.
+
+  По-друге, мій робочий простір має бути чистим. Я не хочу складних інструментів зборки, заплутаних конфігурацій документів або складної структури. Кожного разу, коли я бачу конфігураційні файли та структуру проектів у Docusaurus, VuePress чи Astro, у мене болить голова. Тепер ZEN ховає всі налаштування в каталозі .zen, залишаючи користувачам можливість зосередитись лише на написанні контенту, а решту обробляє ZEN. Всі інші каталоги — це ваш робочий простір, де ви можете вільно організовувати свої файли Markdown.
+
+- Повернення до рідної мови: Пишіть рідною мовою, легко створюйте багатомовні версії
+
+  Життя коротке, мені ліньки перекладати. Коли людина використовує рідну мову, вона може найкраще висловити глибину своїх думок. Але водночас важливо залишатись на зв'язку зі світом, і я не хочу відмовлятись від багатомовного спілкування. Тому мені потрібен інструмент, який дозволить мені писати рідною мовою, але також зробить мій контент доступним для більшої аудиторії. Сучасні рішення i18n вимагають самостійного перекладу та підтримки оновлень, що займає багато часу. Я використовую LLM для перекладу, що економить мій час і дозволяє створювати багатомовні версії в один клік.
+
+## Швидкий старт
+
+Передумови:
+
+- Встановлений [Node.js](https://nodejs.org/) (рекомендована версія 18 або вище, потрібна команда npx)
+- Отриманий [OpenAI API Key](https://platform.openai.com/account/api-keys) або сумісний з OPENAI API Key
+- Встановлений Git (для отримання списку файлів Markdown з Git, ігноруючи файли, відфільтровані за правилами .gitignore)
+
+Спочатку працюйте в папці, яка вже керується Git:
+
+Налаштуйте змінні середовища:
+
+```bash
+export OPENAI_API_KEY="sk-xxxxxx"  # Обов'язково: замініть на ваш OpenAI API Key
+export OPENAI_BASE_URL="https://api.openai.com/v1"  # Опціонально, за замовчуванням використовується офіційний API OpenAI
+export OPENAI_MODEL="gpt-3.5-turbo"  # Опціонально, за замовчуванням використовується модель gpt-3.5-turbo
+```
+
+Побудуйте сайт з підтримкою багатомовного перекладу. Використовуйте поточний каталог як вихідний, результат буде збережено в каталозі `.zen/dist`.
+
+- Можна вказати мовні версії, використовуючи параметр `--lang` кілька разів (наприклад, `--lang uk-UA --lang en-US`).
+- Можна вказати базовий префікс URL-адреси сайту за допомогою параметра `--base-url` (наприклад, назва репозиторію на GitHub Pages).
+- Вихідну мову налаштовувати не потрібно, ZEN визначить її автоматично.
+
+```bash
+npx zengen@latest build --lang uk-UA --lang en-US
+```
+
+**Переглянути більше параметрів або отримати довідку**:
+
+```bash
+npx zengen@latest
+```