zengen 0.3.0 → 0.3.1

package/.zen/src/th-TH/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md

@@ -0,0 +1,70 @@
+---
+'title': 'ZEN - เครื่องมือสร้างเว็บไซต์แบบสแตติกด้วย Markdown + AI แนวมินิมัลลิสต์'
+'summary': 'ZEN เป็นเครื่องมือสร้างเว็บไซต์แบบสแตติกที่ผสาน AI โดยมุ่งเน้นการลดความซับซ้อนของกระบวนการเขียนและสร้างเอกสาร ผู้ใช้สามารถสร้างเว็บไซต์ HTML แบบสแตติกจากโฟลเดอร์ที่จัดการด้วย git โดยใช้ Markdown ได้โดยไม่ต้องตั้งค่าซับซ้อน การตั้งค่าทั้งหมดถูกซ่อนไว้ในไดเรกทอรี .zen ฟีเจอร์หลักประกอบด้วยการนำทางอัจฉริยะแบบจัดหมวดหมู่ (สร้างแผนที่เว็บไซต์ผ่านการวิเคราะห์เนื้อหาด้วย AI) การแปลแบบเพิ่มอัตโนมัติ (รองรับหลายภาษา ผู้ใช้สามารถเขียนด้วยภาษาหลักได้ โดย AI จะจัดการการแปล) และประสบการณ์การเขียนที่รบกวนผู้ใช้น้อยที่สุด เครื่องมือนี้ต้องใช้ Node.js, คีย์ OpenAI API และ Git สามารถสร้างผ่าน command line ได้อย่างรวดเร็ว และรองรับพารามิเตอร์ภาษาที่ระบุ เช่น zh-Hans และ en-US'
+'tags':
+  - 'เครื่องมือสร้างเว็บไซต์แบบสแตติก'
+  - 'Markdown'
+  - 'AI'
+  - 'การแปลหลายภาษา'
+  - 'มินิมัลลิสต์'
+  - 'เครื่องมือเอกสาร'
+  - '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 กวาดเก็บเข้าหมู่มุม ผู้ใช้เพียงแค่ต้องมุ่งเน้นที่การเขียนเนื้อหา ส่วนที่เหลือให้ ZEN จัดการ ไดเรกทอรีอื่นๆ ทั้งหมดคือพื้นที่เขียนของคุณ คุณสามารถจัดระเบียบไฟล์ Markdown ของคุณได้ตามต้องการ
+
+- กลับสู่ภาษาหลัก: เขียนด้วยภาษาหลัก สร้างเวอร์ชันหลายภาษาได้อย่างลื่นไหล
+
+  ชีวิตสั้นนัก ผมขี้เกียจแปล เวลาที่คนเราใช้ภาษาหลัก นั่นคือเวลาที่สามารถดึงเอาความลึกของความคิดออกมาได้มากที่สุด แต่ในขณะเดียวกัน การเชื่อมต่อกับโลกก็เป็นสิ่งจำเป็น ผมไม่อยากเสียโอกาสในการสื่อสารหลายภาษา ดังนั้นผมจึงหวังว่าจะมีเครื่องมือที่ให้ผมเขียนด้วยภาษาหลักได้ และในขณะเดียวกันก็ทำให้คนอื่นๆ ได้เห็นเนื้อหาของผมมากขึ้น i18n ในปัจจุบันนอกจากต้องแปลเองแล้ว ยังต้องดูแลการอัปเดตเนื้อหาด้วยตัวเองอีก ซึ่งยุ่งยากเกินไป ผมเลือกใช้ LLM ช่วยแปล ประหยัดเวลาไปได้มาก และสามารถแปลเป็นหลายภาษาได้ด้วยคลิกเดียว
+
+## เริ่มต้นอย่างรวดเร็ว
+
+ข้อกำหนดเบื้องต้น:
+
+- ติดตั้ง [Node.js](https://nodejs.org/) แล้ว (แนะนำเวอร์ชัน 18 ขึ้นไป ต้องมีคำสั่ง npx)
+- ได้รับ [OpenAI API Key](https://platform.openai.com/account/api-keys) แล้ว หรือคีย์ API ที่เข้ากันได้กับ OPENAI
+- ติดตั้ง 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/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/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/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
+```

package/.zen/src/vi-VN/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md

@@ -0,0 +1,70 @@
+---
+'title': 'ZEN - Trình tạo trang tĩnh Markdown + AI theo phong cách tối giản'
+'summary': 'ZEN là trình tạo trang tĩnh kết hợp AI, tập trung vào việc đơn giản hóa quá trình viết và xây dựng tài liệu. Nó cho phép người dùng tạo trang HTML tĩnh từ thư mục được quản lý bằng git bằng Markdown, không cần cấu hình phức tạp, tất cả cài đặt được ẩn trong thư mục .zen. Tính năng chính bao gồm điều hướng phân loại thông minh (tạo sơ đồ trang web thông qua phân tích nội dung bằng AI), dịch tự động tăng dần (hỗ trợ phiên bản đa ngôn ngữ, người dùng có thể viết bằng ngôn ngữ mẹ đẻ, AI xử lý dịch thuật), và trải nghiệm viết tối thiểu sự phiền nhiễu. Công cụ phụ thuộc vào Node.js, OpenAI API Key và Git, được xây dựng nhanh qua dòng lệnh, hỗ trợ tham số ngôn ngữ chỉ định như zh-Hans và en-US.'
+'tags':
+  - 'Trình tạo trang tĩnh'
+  - 'Markdown'
+  - 'AI'
+  - 'Dịch đa ngôn ngữ'
+  - 'Chủ nghĩa tối giản'
+  - 'Công cụ tài liệu'
+  - 'ZEN'
+'inferred_lang': 'zh-Hans'
+---
+
+# ZEN - Trình tạo trang tĩnh Markdown + AI theo phong cách tối giản
+
+[> Bản demo Trang web](https://zen.zccz14.com/)
+
+## Chức năng cơ bản
+
+1. 📃 **Tạo trang tĩnh**: Biến bất kỳ thư mục git chứa Markdown nào thành một trang HTML tĩnh.
+2. 🧭 **Điều hướng phân loại thông minh**: Sử dụng AI để phân tích nội dung, tạo sơ đồ trang web và điều hướng, không nhạy cảm với vị trí tệp nguồn.
+3. 🌍 **Dịch tự động tăng dần**: Sử dụng AI để dịch tăng dần, cho phép người dùng viết Markdown bằng ngôn ngữ mẹ đẻ, nhưng người dùng có thể đa ngôn ngữ.
+
+Tại sao lại tạo thêm một trình tạo trang tĩnh Markdown? Tôi đã suy nghĩ lại về cách công cụ tài liệu có thể phục vụ người viết tốt hơn trong thời đại AI:
+
+- Trở về với nội dung: Tối thiểu sự phiền nhiễu, tập trung vào việc viết
+
+  Đưa tài liệu trở lại bản chất, đưa việc viết trở lại sự tĩnh lặng.
+
+  Thứ nhất, tôi không muốn làm thủ thư. Đôi khi tôi muốn viết một số nội dung, nhưng có thể tôi chưa nghĩ ra tiêu đề cho nó, chưa hình thành tổ chức cụ thể. Tôi hy vọng LLM sẽ tự động giúp tôi tạo tiêu đề, tóm tắt, phân loại, điều hướng và các công việc sắp xếp khác.
+
+  Thứ hai, thư phòng của tôi phải được dọn dẹp sạch sẽ. Tôi không muốn các công cụ xây dựng cấu hình phức tạp, vặn vẹo cấu hình tài liệu phức tạp, không thích cấu trúc phức tạp. Mỗi lần nhìn thấy tệp cấu hình và cấu trúc dự án của các công cụ như Docusaurus, VuePress, Astro, tôi lại đau đầu. Bây giờ, ZEN chọn cách ẩn tất cả cấu hình vào thư mục .zen, quét vào góc, người dùng chỉ cần tập trung vào viết nội dung, phần còn lại để ZEN xử lý. Các thư mục khác là không gian viết của bạn, bạn có thể tổ chức tệp Markdown của mình tùy ý.
+
+- Trở về với ngôn ngữ mẹ đẻ: Viết bằng ngôn ngữ mẹ đẻ, xây dựng phiên bản đa ngôn ngữ mượt mà
+
+  Cuộc đời ngắn ngủi, tôi lười dịch. Khi sử dụng ngôn ngữ mẹ đẻ, con người mới có thể phát huy tối đa độ sâu suy nghĩ của mình. Nhưng đồng thời việc giữ kết nối với thế giới là cần thiết, tôi không muốn từ bỏ giao tiếp đa ngôn ngữ. Vì vậy, tôi hy vọng có một công cụ cho phép tôi viết bằng ngôn ngữ mẹ đẻ, đồng thời lại để nhiều người hơn thấy được nội dung của tôi. Hiện tại, i18n không chỉ cần tự dịch mà còn phải tự duy trì cập nhật nội dung, quá phiền phức. Tôi chọn sử dụng LLM để giúp tôi dịch, tiết kiệm rất nhiều thời gian và có thể hoàn thành dịch đa ngôn ngữ chỉ với một cú nhấp chuột.
+
+## Bắt đầu nhanh
+
+Điều kiện tiên quyết:
+
+- Đã cài đặt [Node.js](https://nodejs.org/) (khuyến nghị phiên bản 18 trở lên, cần có lệnh npx)
+- Đã lấy [OpenAI API Key](https://platform.openai.com/account/api-keys), hoặc API Key tương thích OPENAI
+- Đã cài đặt Git (để liệt kê tệp Markdown từ Git, bỏ qua các tệp được lọc bởi quy tắc .gitignore)
+
+Đầu tiên, làm việc trong một thư mục đã được quản lý bởi git:
+
+Cấu hình biến môi trường
+
+```bash
+export OPENAI_API_KEY="sk-xxxxxx"  # Bắt buộc: Vui lòng thay thế bằng OpenAI API Key của bạn
+export OPENAI_BASE_URL="https://api.openai.com/v1"  # Tùy chọn, mặc định sử dụng API chính thức của OpenAI
+export OPENAI_MODEL="gpt-3.5-turbo"  # Tùy chọn, mặc định sử dụng mô hình gpt-3.5-turbo
+```
+
+Xây dựng trang web, hỗ trợ dịch đa ngôn ngữ. Sử dụng thư mục hiện tại làm thư mục nguồn, xuất ra thư mục `.zen/dist`.
+
+- Có thể chỉ định phiên bản ngôn ngữ cần tạo bằng cách sử dụng nhiều lần tham số `--lang` (ví dụ: `--lang zh-Hans --lang en-US`).
+- Không cần cấu hình ngôn ngữ nguồn, ZEN sẽ tự động phát hiện.
+
+```bash
+npx zengen@latest build --lang zh-Hans --lang en-US
+```
+
+**Xem thêm tham số hoặc trợ giúp**:
+
+```bash
+npx zengen@latest
+```

package/.zen/src/vi-VN/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md

@@ -0,0 +1,71 @@
+---
+'title': 'ZEN - Trình tạo trang tĩnh Markdown + AI theo chủ nghĩa tối giản'
+'summary': 'ZEN là trình tạo trang tĩnh tích hợp AI, được thiết kế dành riêng cho tài liệu Markdown. Nó cho phép người dùng chuyển đổi thư mục Git chứa file Markdown thành trang HTML tĩnh mà không cần cấu hình phức tạp, tất cả cài đặt được ẩn trong thư mục .zen. Chức năng chính bao gồm điều hướng phân loại thông minh (sử dụng AI phân tích nội dung để tạo sơ đồ trang), dịch tự động tăng dần (hỗ trợ phiên bản đa ngôn ngữ, người dùng có thể viết bằng ngôn ngữ mẹ đẻ, AI xử lý dịch thuật), và trải nghiệm viết tối thiểu gây gián đoạn. Hướng dẫn bắt đầu nhanh yêu cầu cài đặt Node.js, lấy OpenAI API Key và Git, xây dựng trang qua dòng lệnh, hỗ trợ chỉ định ngôn ngữ và URL cơ sở.'
+'tags':
+  - 'Trình tạo trang tĩnh'
+  - 'Markdown'
+  - 'AI'
+  - 'Dịch đa ngôn ngữ'
+  - 'Chủ nghĩa tối giản'
+  - 'Công cụ tài liệu'
+  - 'Git'
+'inferred_lang': 'zh-Hans'
+---
+
+# ZEN - Trình tạo trang tĩnh Markdown + AI theo chủ nghĩa tối giản
+
+[> Xem Demo Trang Web](https://zen.zccz14.com/)
+
+## Chức năng cơ bản
+
+1. 📃 **Tạo trang tĩnh**: Biến bất kỳ thư mục git chứa Markdown nào thành một trang HTML tĩnh.
+2. 🧭 **Điều hướng phân loại thông minh**: Sử dụng AI phân tích nội dung, tạo sơ đồ trang và điều hướng, không phụ thuộc vào vị trí file nguồn.
+3. 🌍 **Dịch tự động tăng dần**: Sử dụng AI để dịch tăng dần, cho phép người dùng viết Markdown bằng ngôn ngữ mẹ đẻ, nhưng người dùng có thể đa ngôn ngữ.
+
+Tại sao lại tạo thêm một trình tạo trang tĩnh Markdown nữa? Tôi đã suy nghĩ lại về cách công cụ tài liệu có thể phục vụ người viết tốt hơn trong thời đại AI:
+
+- Trở về với nội dung: Tối thiểu hóa sự gián đoạn, tập trung vào việc viết
+
+  Đưa tài liệu trở lại bản chất, đưa việc viết trở lại sự tĩnh lặng.
+
+  Thứ nhất, tôi không muốn làm thủ thư. Đôi khi tôi muốn viết một số nội dung, nhưng có thể tôi chưa nghĩ ra tiêu đề cho nó, chưa hình thành cấu trúc tổ chức cụ thể. Tôi hy vọng LLM sẽ tự động giúp tôi tạo tiêu đề, tóm tắt, phân loại, điều hướng và các công việc sắp xếp khác.
+
+  Thứ hai, thư phòng của tôi phải được dọn dẹp sạch sẽ. Tôi không muốn các công cụ xây dựng cấu hình phức tạp, mất công với cấu hình tài liệu phức tạp, không thích cấu trúc rườm rà. Mỗi lần nhìn thấy file cấu hình và cấu trúc dự án của các công cụ như Docusaurus, VuePress, Astro, tôi lại đau đầu. Giờ đây, ZEN chọn cách ẩn tất cả cấu hình vào thư mục .zen, quét vào góc, người dùng chỉ cần tập trung vào nội dung viết, phần còn lại để ZEN xử lý. Các thư mục khác là không gian viết của bạn, bạn có thể tổ chức file Markdown tùy ý.
+
+- Trở về với tiếng mẹ đẻ: Viết bằng tiếng mẹ đẻ, xây dựng phiên bản đa ngôn ngữ mượt mà
+
+  Đời người ngắn ngủi, tôi lười dịch. Khi sử dụng tiếng mẹ đẻ, con người mới có thể phát huy tối đa chiều sâu tư duy của mình. Nhưng đồng thời việc kết nối với thế giới là cần thiết, tôi không muốn từ bỏ giao tiếp đa ngôn ngữ. Vì vậy, tôi hy vọng có một công cụ cho phép tôi viết bằng tiếng mẹ đẻ, đồng thời lại để nhiều người hơn thấy được nội dung của tôi. Hiện tại, i18n không chỉ yêu cầu tự dịch mà còn phải tự duy trì cập nhật nội dung, quá phiền phức. Tôi chọn sử dụng LLM để giúp tôi dịch, tiết kiệm rất nhiều thời gian và có thể hoàn thành dịch đa ngôn ngữ chỉ với một cú nhấp chuột.
+
+## Bắt đầu nhanh
+
+Điều kiện tiên quyết:
+
+- Đã cài đặt [Node.js](https://nodejs.org/) (khuyến nghị phiên bản 18 trở lên, cần có lệnh npx)
+- Đã lấy [OpenAI API Key](https://platform.openai.com/account/api-keys), hoặc API Key tương thích OPENAI
+- Đã cài đặt Git (dùng để liệt kê file Markdown từ Git, bỏ qua các file bị lọc bởi quy tắc .gitignore)
+
+Đầu tiên, làm việc trong một thư mục đã được quản lý bởi git:
+
+Cấu hình biến môi trường
+
+```bash
+export OPENAI_API_KEY="sk-xxxxxx"  # Bắt buộc: Vui lòng thay thế bằng OpenAI API Key của bạn
+export OPENAI_BASE_URL="https://api.openai.com/v1"  # Tùy chọn, mặc định sử dụng API chính thức của OpenAI
+export OPENAI_MODEL="gpt-3.5-turbo"  # Tùy chọn, mặc định sử dụng mô hình gpt-3.5-turbo
+```
+
+Xây dựng trang, hỗ trợ dịch đa ngôn ngữ. Sử dụng thư mục hiện tại làm thư mục nguồn, xuất ra thư mục `.zen/dist`.
+
+- Có thể chỉ định phiên bản ngôn ngữ cần tạo bằng cách sử dụng nhiều lần tham số `--lang` (ví dụ: `--lang zh-Hans --lang en-US`).
+- Có thể chỉ định tiền tố URL cơ sở của trang bằng tham số `--base-url` (ví dụ: tên kho lưu trữ trên GitHub Pages).
+- Không cần cấu hình ngôn ngữ nguồn, ZEN sẽ tự động phát hiện.
+
+```bash
+npx zengen@latest build --lang zh-Hans --lang en-US
+```
+
+**Xem thêm tham số hoặc trợ giúp**:
+
+```bash
+npx zengen@latest
+```