zengen 0.2.4 → 0.2.5

package/.zen/src/th-TH/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md

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

package/.zen/src/th-TH/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md

@@ -0,0 +1,30 @@
+---
+'title': 'เคล็ดลับการใช้การประกาศวันที่ในเอกสาร ZEN'
+'summary': 'เอกสารนี้แนะนำเคล็ดลับการใช้การประกาศวันที่โดยตรงในเนื้อหาของเครื่องมือ ZEN โดยเปรียบเทียบกับวิธีดั้งเดิมของ Markdown ที่ประกาศวันที่ผ่าน YAML Frontmatter ช่วยเน้นย้ำความสามารถในการจดจำอัตโนมัติและการประมวลผลอัจฉริยะของ ZEN ซึ่งช่วยยกระดับประสบการณ์ผู้ใช้ และเหมาะสำหรับประเภทเนื้อหาที่ต้องการไทม์ไลน์ เช่น ไดอารี่ บล็อก'
+'tags':
+  - 'ZEN'
+  - 'การประกาศวันที่'
+  - 'Markdown'
+  - 'การประมวลผล AI'
+  - 'ไทม์ไลน์'
+  - 'ประสบการณ์ผู้ใช้'
+  - 'การจัดการเอกสาร'
+'inferred_date': '2026-01-08'
+'inferred_lang': 'th-TH'
+---
+
+# เคล็ดลับการใช้
+
+## การประกาศวันที่ในเนื้อหา
+
+ในเนื้อหาสามารถใช้การประกาศวันที่เช่น "วันนี้คือ 8 มกราคม 2026" (รูปแบบอิสระ) ZEN จะจดจำและประมวลผลโดยอัตโนมัติ
+
+เอกสาร Markdown แบบดั้งเดิมประกาศวันที่ผ่าน YAML Frontmatter ซึ่งต้องจำฟิลด์ที่เกี่ยวข้อง มิฉะนั้นอาจทำให้ไม่สามารถระบุวันที่ได้อย่างถูกต้อง
+
+ZEN รองรับการประกาศวันที่โดยตรงในเนื้อหา ซึ่งช่วยหลีกเลี่ยงปัญหาการลืมกรอกฟิลด์ Frontmatter
+
+AI จะดึงข้อมูลและอนุมานข้อมูลวันที่จากเนื้อหาโดยอัตโนมัติ และนำไปประมวลผลเป็นวันที่สร้างเอกสาร
+
+วิธีนี้มีความยืดหยุ่นและชาญฉลาดมากขึ้น ช่วยยกระดับประสบการณ์ผู้ใช้
+
+นอกจากนี้ เอกสารที่มีวันที่สามารถสร้างมุมมองไทม์ไลน์ได้ ช่วยให้การเรียกดูและการจัดการสะดวกยิ่งขึ้น เหมาะอย่างยิ่งสำหรับประเภทเนื้อหาที่ต้องการไทม์ไลน์ เช่น ไดอารี่ บล็อก

package/.zen/src/tr-TR/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md

@@ -1,15 +1,15 @@
 ---
-title: ZEN - Minimalist Markdown + AI Statik Site Oluşturucu
-summary: ZEN, akıllı sınıflandırma navigasyonu ve otomatik artımlı çeviri desteği sunan, AI ile entegre bir statik site oluşturucudur. Kullanıcıların ana dillerinde yazmaya odaklanmasını sağlar, yapılandırma ve derleme sürecini basitleştirir.
-tags:
-  - Statik Site Oluşturucu
-  - Markdown
-  - AI
-  - Çok Dilli Çeviri
-  - Minimalizm
-  - Dokümantasyon Aracı
-  - Node.js
-inferred_lang: tr-TR
+'title': 'ZEN - Minimalist Markdown + AI Statik Site Oluşturucu'
+'summary': "ZEN, AI özellikleriyle birleşen, belge yazımını ve site oluşturma sürecini basitleştirmeyi amaçlayan bir statik site oluşturucudur. Kullanıcıların ana dillerinde Markdown içeriği yazmaya odaklanmasına izin verir, başlık oluşturma, kategori navigasyonu ve artımlı çeviriyi otomatik olarak işler, çok dilli sürümleri destekler ve karmaşık yapılandırma gerektirmez. Node.js ve OpenAI API'si üzerine kurulu araç, komut satırı üzerinden hızlı site oluşturma sağlar ve verimlilik ve sadelik arayan yazarlar için uygundur."
+'tags':
+  - 'Statik Site Oluşturucu'
+  - 'Markdown'
+  - 'AI'
+  - 'Minimalizm'
+  - 'Çok Dilli Çeviri'
+  - 'Node.js'
+  - 'OpenAI'
+'inferred_lang': 'zh-Hans'
 ---
 
 # ZEN - Minimalist Markdown + AI Statik Site Oluşturucu
@@ -18,53 +18,53 @@ inferred_lang: tr-TR
 
 ## 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ı Sınıflandırma Navigasyonu**: 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 Markdown'ı ana dillerinde yazabilir, ancak site çok dilli olabilir.
+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ı Kategori Navigasyonu**: 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 izin verir, ancak kullanıcılar çok dilli olabilir.
 
-Neden bir Markdown statik site oluşturucusu daha? AI çağında, dokümantasyon araçlarının yazarlara nasıl daha iyi hizmet edebileceğini yeniden düşündüm:
+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üş: Müdahaleyi en aza indirin, yazmaya odaklanın
+- İçeriğe Dönüş: Rahatsızlığı en aza indirin, yazmaya odaklanın
 
-  Dokümanları özüne döndürün, yazmayı huzurlu bir deneyim haline getirin.
+  Belgeleri özüne döndürün, yazmayı sakinliğe döndürün.
 
-  Birincisi, kütüphaneci olmak istemiyorum. Bazen bir şeyler yazmak isterim ama henüz başlığını düşünmemiş, belirli bir organizasyon oluşturmamış olabilirim. LLM'nin başlık oluşturma, özet çıkarma, sınıflandırma, navigasyon gibi düzenleme işlerini otomatik yapmasını umuyorum.
+  Birincisi, kütüphaneci olmak istemiyorum. Bazen bir şeyler yazmak isterim, ancak henüz başlığını düşünmemiş olabilirim, özel bir organizasyon oluşturmamış olabilirim. LLM'nin başlık oluşturma, özet çıkarma, sınıflandırma, 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 doküman 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, köşeye süpürmeyi seçiyor. Kullanıcı sadece içerik yazmaya odaklanır, gerisini ZEN halleder. Diğer tüm dizinler sizin yazma alanınızdır, Markdown dosyalarınızı istediğiniz gibi düzenleyebilirsiniz.
+  İkincisi, çalışma odam temiz olmalı. Karmaşık yapılandırma araçlarıyla uğraşmak, karmaşık belge yapılandırmalarıyla boğuş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, köşeye süpürmeyi seçiyor, kullanıcı 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 dilinizde yazın, çok dilli sürümleri sorunsuz oluşturun
 
-  Hayat kısa, çeviri yapmakla uğraşmak istemiyorum. İnsanlar ana dillerini kullanırken düşüncelerinin derinliğini en iyi şekilde ortaya koyabilir. Ancak aynı zamanda dünyayla bağlantıda kalmak da gereklidir, çok dilli iletişimi bırakmak istemiyorum. Bu yüzden, ana dilimde yazmama izin veren, aynı zamanda içeriğimi daha fazla kişiye ulaştırabilen bir araç istiyorum. Mevcut i18n çözümleri sadece kendi çevirinizi yapmanızı gerektirmekle kalmaz, aynı zamanda içerik güncellemelerini de sizin yönetmenizi gerektirir, bu çok zahmetli. Çevirileri yapmak için LLM'yi kullanmayı seçiyorum, bu bana çok zaman kazandırıyor ve tek tıkla çoklu dil çevirisi yapılabiliyor.
+  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 kendiniz çeviri yapmanızı gerektiriyor, ayrıca içerik güncellemelerini kendiniz yönetmeniz gerekiyor, çok zahmetli. Çeviri yapmak için LLM kullanmayı seçiyorum, bu bana çok zaman kazandırıyor ve tek tıkla çok uluslu dil çevirisi yapılabiliyor.
 
 ## Hızlı Başlangıç
 
 Ön Koşullar:
 
-- [Node.js](https://nodejs.org/) kurulu olmalı (18 veya üzeri sürüm önerilir, npx komutu gereklidir)
-- [OpenAI API Anahtarı](https://platform.openai.com/account/api-keys) veya OPENAI uyumlu bir API Anahtarı edinilmiş olmalı
-- Git kurulu olmalı (Markdown dosyalarını Git'ten listelemek ve .gitignore kurallarıyla filtrelenen dosyaları yok saymak için)
+- [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) alınmış veya OPENAI uyumlu bir API Anahtarı
+- Git kurulu (Markdown dosyalarını Git'ten listelemek, .gitignore kurallarıyla filtrelenen dosyaları yok saymak için)
 
-İlk olarak, git ile yönetilen bir klasörde çalışın:
+İlk olarak, 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"  # Opsiyonel, varsayılan olarak OpenAI resmi API'si kullanılır
-export OPENAI_MODEL="gpt-3.5-turbo"  # Opsiyonel, varsayılan olarak gpt-3.5-turbo modeli kullanılır
+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. Mevcut dizini kaynak dizin olarak kullanır, çıktıyı `.zen/dist` dizinine yazar.
+Siteyi oluşturun, çok dilli çeviriyi destekler. Kaynak dizin olarak geçerli dizini kullanır, `.zen/dist` dizinine çıktı verir.
 
-- Oluşturulacak dil sürümlerini belirtmek için `--lang` parametresi birden fazla kez kullanılabilir (örneğin `--lang tr-TR --lang en-US`).
-- Sitenin temel URL önekini belirtmek için `--base-url` parametresi kullanılabilir (örneğin GitHub Pages'teki depo adı).
+- `--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 tr-TR --lang en-US
+npx zengen@latest build --lang zh-Hans --lang en-US
 ```
 
-**Daha fazla parametre veya yardım için**:
+**Daha fazla parametre veya yardım görüntüleyin**:
 
 ```bash
 npx zengen@latest

package/.zen/src/tr-TR/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md

@@ -0,0 +1,30 @@
+---
+'title': 'ZEN Belge Tarih Bildirimi Kullanım İpuçları'
+'summary': "Bu belge, ZEN aracında metin içinde doğrudan tarih bildirimi kullanma tekniklerini tanıtmaktadır. Geleneksel Markdown'ın YAML Frontmatter ile tarih bildirme yöntemiyle karşılaştırılarak, ZEN'in otomatik tanıma ve akıllı işleme özellikleri vurgulanmış, kullanıcı deneyimi iyileştirilmiş ve günlük, blog gibi zaman çizelgesi gerektiren içerik türleri için uygun olduğu belirtilmiştir."
+'tags':
+  - 'ZEN'
+  - 'Tarih Bildirimi'
+  - 'Markdown'
+  - 'AI İşleme'
+  - 'Zaman Çizelgesi'
+  - 'Kullanıcı Deneyimi'
+  - 'Belge Yönetimi'
+'inferred_date': '2026-01-08'
+'inferred_lang': 'tr-TR'
+---
+
+# Kullanım İpuçları
+
+## Metin İçinde Tarih Bildirimi
+
+Metin içinde "Bugün 8 Ocak 2026" gibi serbest formatta tarih bildirimleri kullanılabilir. ZEN bunları otomatik olarak tanır ve işler.
+
+Geleneksel Markdown belgeleri, tarihi YAML Frontmatter ile bildirir ve ilgili alanı hatırlamak gerekir, aksi takdirde tarih doğru şekilde tanınmayabilir.
+
+ZEN, metin içinde doğrudan tarih bildirimini destekleyerek, Frontmatter alanlarını doldurmayı unutma sorununu ortadan kaldırır.
+
+Yapay Zeka, metindeki tarih bilgilerini otomatik olarak çıkarır ve çıkarım yaparak, bunları belgenin oluşturulma tarihi olarak işler.
+
+Bu yöntem daha esnek ve akıllıdır, kullanıcı deneyimini artırır.
+
+Ayrıca, tarih içeren belgeler, zaman çizelgesi görünümü oluşturularak kolayca gözden geçirilebilir ve yönetilebilir. Özellikle günlük, blog gibi zaman çizelgesi gerektiren içerik türleri için idealdir.

package/.zen/src/uk-UA/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md

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

package/.zen/src/uk-UA/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md

@@ -0,0 +1,30 @@
+---
+'title': 'Прийоми використання оголошення дати в документах ZEN'
+'summary': 'Цей документ описує прийоми прямого оголошення дати в основному тексті за допомогою інструменту ZEN, порівнюючи з традиційним способом оголошення дати через YAML Frontmatter у Markdown. Підкреслюються функції автоматичного розпізнавання та інтелектуальної обробки ZEN, що покращують користувацький досвід. Підходить для типів контенту, які потребують часової шкали, таких як щоденники, блоги тощо.'
+'tags':
+  - 'ZEN'
+  - 'оголошення дати'
+  - 'Markdown'
+  - 'AI обробка'
+  - 'часова шкала'
+  - 'користувацький досвід'
+  - 'управління документами'
+'inferred_date': '2026-01-08'
+'inferred_lang': 'uk-UA'
+---
+
+# Прийоми використання
+
+## Оголошення дати в основному тексті
+
+У основному тексті можна використовувати оголошення дати на кшталт "Сьогодні 8 січня 2026 року" (формат і стиль вільні), і ZEN автоматично розпізнає та обробить його.
+
+Традиційні документи Markdown оголошують дату через YAML Frontmatter, що вимагає запам'ятовування відповідних полів, інакше дата може бути неправильно розпізнана.
+
+ZEN підтримує пряме оголошення дати в основному тексті, що дозволяє уникнути проблеми з забуванням заповнення полів Frontmatter.
+
+AI автоматично витягне та визначить інформацію про дату з основного тексту та обробить її як дату створення документа.
+
+Цей спосіб є більш гнучким та розумним, покращуючи користувацький досвід.
+
+До речі, документи з датами можуть генерувати перегляд у вигляді часової шкали, що спрощує перегляд та управління. Особливо підходить для типів контенту, які потребують часової шкали, таких як щоденники, блоги тощо.

package/.zen/src/vi-VN/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md

@@ -1,48 +1,48 @@
 ---
-title: ZEN - Trình tạo trang tĩnh Markdown + AI theo chủ nghĩa tối giản
-summary: ZEN là một trình tạo trang tĩnh tích hợp AI, hỗ trợ điều hướng phân loại thông minh và dịch thuật tự động tăng dần, cho phép người dùng tập trung viết bằng ngôn ngữ mẹ đẻ, đơn giản hóa quá trình cấu hình và xây dựng.
-tags:
-  - Trình tạo trang tĩnh
-  - Markdown
-  - AI
-  - Dịch thuật đa ngôn ngữ
-  - Chủ nghĩa tối giản
-  - Công cụ tài liệu
-  - Node.js
-inferred_lang: vi-VN
+'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, nhằm đơn giản hóa quá trình viết tài liệu và xây dựng trang web. Nó cho phép người dùng tập trung viết nội dung Markdown bằng ngôn ngữ mẹ đẻ, tự động xử lý việc tạo tiêu đề, điều hướng phân loại và dịch thuật tăng dần, hỗ trợ nhiều phiên bản ngôn ngữ mà không cần cấu hình phức tạp. Công cụ dựa trên Node.js và OpenAI API, xây dựng trang web nhanh chóng qua dòng lệnh, phù hợp cho những người viết theo đuổi hiệu quả và sự đơn giản.'
+'tags':
+  - 'Trình tạo trang tĩnh'
+  - 'Markdown'
+  - 'AI'
+  - 'Chủ nghĩa tối giản'
+  - 'Dịch đa ngôn ngữ'
+  - 'Node.js'
+  - 'OpenAI'
+'inferred_lang': 'zh-Hans'
 ---
 
 # ZEN - Trình tạo trang tĩnh Markdown + AI theo chủ nghĩa tối giản
 
-[> Website Demo](https://zccz14.github.io/ZEN/)
+[> Bản demo Trang web](https://zccz14.github.io/ZEN/)
 
-## Chức năng cơ bản
+## Tính 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í của tệp nguồn.
-3. 🌍 **Dịch thuật 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 có thể hỗ trợ đa ngôn ngữ.
+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 web 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í tệp nguồn.
+3. 🌍 **Dịch tăng dần tự động**: 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 vẫn có thể hỗ trợ đa ngôn ngữ.
 
-Tại sao lại tạo ra một trình tạo trang tĩnh Markdown nữa? Tôi đã suy nghĩ lại về cách các công cụ tài liệu trong thời đại AI có thể phục vụ người viết tốt hơn:
+Tại sao lại tạo ra một trình tạo trang tĩnh Markdown nữa? Tôi đã suy nghĩ lại về cách các 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: Giảm 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ở về 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ứ nhất, tôi không muốn làm thủ thư. Đôi khi tôi muốn viết ra 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, 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 các 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ệc viết nội dung, phần còn lại để ZEN xử lý. Các thư mục khác đều là không gian viết của bạn, bạn có thể tự do tổ chức các tệp Markdown của mình.
+  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 các 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. 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 việc 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 các tệp Markdown của mình một cách 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à
+- Trở về với ngôn ngữ mẹ đẻ: Viết bằng tiế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 chiều sâu tư duy 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 có thể để nhiều người hơn xem đượ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 thuật đa quốc gia chỉ với một cú nhấp chuột.
+  Cuộc đời ngắn ngủi, tôi lười dịch. Con người chỉ có thể phát huy tối đa chiều sâu tư duy khi sử dụng ngôn ngữ mẹ đẻ. 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 ngôn ngữ mẹ đẻ, đồng thời lại có thể để nhiều người hơn xem đượ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ỉ bằng 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 với OPENAI
-- Đã cài đặt Git (dùng để liệt kê các tệp Markdown từ Git, bỏ qua các tệp bị lọc bởi quy tắc .gitignore)
+- Đã có [OpenAI API Key](https://platform.openai.com/account/api-keys), hoặc API Key tương thích với OPENAI
+- Đã cài đặt Git (để liệt kê các tệp Markdown từ Git, bỏ qua các tệp 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:
 
@@ -54,7 +54,7 @@ export OPENAI_BASE_URL="https://api.openai.com/v1"  # Tùy chọn, mặc định
 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 thuật đa ngôn ngữ. Sử dụng thư mục hiện tại làm thư mục nguồn, đầu ra đến thư mục `.zen/dist`.
+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 các 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 web bằng tham số `--base-url` (ví dụ: tên kho lưu trữ trên GitHub Pages).

package/.zen/src/vi-VN/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md

@@ -0,0 +1,30 @@
+---
+'title': 'Kỹ thuật sử dụng khai báo ngày tháng trong tài liệu ZEN'
+'summary': 'Tài liệu này giới thiệu kỹ thuật sử dụng khai báo ngày tháng trực tiếp trong nội dung chính của công cụ ZEN, so sánh với cách khai báo ngày tháng truyền thống trong Markdown thông qua YAML Frontmatter, nhấn mạnh khả năng tự động nhận diện và xử lý thông minh của ZEN, nâng cao trải nghiệm người dùng, và phù hợp với các loại nội dung cần dòng thời gian như nhật ký, blog.'
+'tags':
+  - 'ZEN'
+  - 'Khai báo ngày tháng'
+  - 'Markdown'
+  - 'Xử lý AI'
+  - 'Dòng thời gian'
+  - 'Trải nghiệm người dùng'
+  - 'Quản lý tài liệu'
+'inferred_date': '2026-01-08'
+'inferred_lang': 'zh-Hans'
+---
+
+# Kỹ thuật sử dụng
+
+## Khai báo ngày tháng trong nội dung chính
+
+Trong nội dung chính, bạn có thể sử dụng khai báo ngày tháng như "Hôm nay là ngày 8 tháng 1 năm 2026" (định dạng tự do), ZEN sẽ tự động nhận diện và xử lý.
+
+Tài liệu Markdown truyền thống khai báo ngày tháng thông qua YAML Frontmatter, yêu cầu ghi nhớ các trường tương ứng, nếu không ngày tháng sẽ không được nhận diện chính xác.
+
+ZEN hỗ trợ khai báo ngày tháng trực tiếp trong nội dung chính, tránh được vấn đề quên điền các trường Frontmatter.
+
+AI sẽ tự động trích xuất và suy luận thông tin ngày tháng trong nội dung chính, sau đó xử lý chúng như ngày tạo tài liệu.
+
+Phương pháp này linh hoạt và thông minh hơn, nâng cao trải nghiệm người dùng.
+
+Nhân tiện, các tài liệu có ngày tháng có thể tạo ra chế độ xem dòng thời gian, thuận tiện cho việc duyệt và quản lý. Đặc biệt phù hợp với các loại nội dung cần dòng thời gian như nhật ký, blog.

package/.zen/src/zh-Hans/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md

@@ -1,15 +1,18 @@
 ---
-title: ZEN - 极简主义 Markdown + AI 静态站点构建器
-summary: ZEN 是一个结合 AI 的静态站点生成器，支持智能分类导航和自动增量翻译，让用户专注于用母语写作，简化配置和构建过程。
-tags:
-  - 静态站点生成器
-  - Markdown
-  - AI
-  - 多语言翻译
-  - 极简主义
-  - 文档工具
-  - Node.js
-inferred_lang: zh-Hans
+'title': 'ZEN - 极简主义 Markdown + AI 静态站点构建器'
+'summary':
+  'ZEN 是一个结合 AI 功能的静态站点生成器，旨在简化文档写作和站点构建过程。它允许用户专注于用母语编写 Markdown
+  内容，自动处理标题生成、分类导航和增量翻译，支持多语言版本，无需复杂配置。工具基于 Node.js 和 OpenAI
+  API，通过命令行快速构建站点，适合追求高效和简洁的写作者。'
+'tags':
+  - '静态站点生成器'
+  - 'Markdown'
+  - 'AI'
+  - '极简主义'
+  - '多语言翻译'
+  - 'Node.js'
+  - 'OpenAI'
+'inferred_lang': 'zh-Hans'
 ---
 
 # ZEN - 极简主义 Markdown + AI 静态站点构建器