zengen 0.2.4 → 0.2.6

package/.zen/meta.json

@@ -35,30 +35,39 @@
     {
       "hash": "74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805",
       "path": "README.md",
+      "links": [
+        "https://zccz14.github.io/ZEN/",
+        "https://nodejs.org/",
+        "https://platform.openai.com/account/api-keys"
+      ],
       "metadata": {
         "title": "ZEN - 极简主义 Markdown + AI 静态站点构建器",
-        "summary": "ZEN 是一个结合 AI 的静态站点生成器，支持智能分类导航和自动增量翻译，让用户专注于用母语写作，简化配置和构建过程。",
-        "tags": [
-          "静态站点生成器",
-          "Markdown",
-          "AI",
-          "多语言翻译",
-          "极简主义",
-          "文档工具",
-          "Node.js"
-        ],
+        "summary": "ZEN 是一个结合 AI 功能的静态站点生成器，旨在简化文档写作和站点构建过程。它允许用户专注于用母语编写 Markdown 内容，自动处理标题生成、分类导航和增量翻译，支持多语言版本，无需复杂配置。工具基于 Node.js 和 OpenAI API，通过命令行快速构建站点，适合追求高效和简洁的写作者。",
+        "tags": ["静态站点生成器", "Markdown", "AI", "极简主义", "多语言翻译", "Node.js", "OpenAI"],
         "inferred_lang": "zh-Hans",
         "tokens_used": {
           "prompt": 1038,
-          "completion": 120,
-          "total": 1158
+          "completion": 163,
+          "total": 1201
         }
-      },
-      "links": [
-        "https://zccz14.github.io/ZEN/",
-        "https://nodejs.org/",
-        "https://platform.openai.com/account/api-keys"
-      ]
+      }
+    },
+    {
+      "hash": "9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc",
+      "path": "docs/tricks.md",
+      "links": [],
+      "metadata": {
+        "title": "ZEN文档日期声明使用技巧",
+        "summary": "本文档介绍了ZEN工具中在正文中直接声明日期的使用技巧，与传统Markdown通过YAML Frontmatter声明日期的方式对比，强调了ZEN的自动识别和智能处理功能，提升了用户体验，并适用于日记、博客等需要时间线的内容类型。",
+        "tags": ["ZEN", "日期声明", "Markdown", "AI处理", "时间线", "用户体验", "文档管理"],
+        "inferred_date": "2026-01-08",
+        "inferred_lang": "zh-Hans",
+        "tokens_used": {
+          "prompt": 417,
+          "completion": 135,
+          "total": 552
+        }
+      }
     }
   ]
 }

package/.zen/src/ar-SA/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md

@@ -1,67 +1,67 @@
 ---
-title: ZEN - منشئ مواقع ثابتة بالحد الأدنى من Markdown + الذكاء الاصطناعي
-summary: ZEN هو منشئ مواقع ثابتة مدمج مع الذكاء الاصطناعي، يدعم التنقل الذكي التلقائي والترجمة التزايدية الآلية، مما يمكن المستخدم من التركيز على الكتابة بلغته الأم، وتبسيط عمليات التكوين والبناء.
-tags:
-  - منشئ مواقع ثابتة
-  - Markdown
-  - الذكاء الاصطناعي
-  - ترجمة متعددة اللغات
-  - الحد الأدنى
-  - أدوات التوثيق
-  - Node.js
-inferred_lang: ar-SA
+'title': 'ZEN - منشئ المواقع الثابتة البسيط باستخدام Markdown + الذكاء الاصطناعي'
+'summary': 'ZEN هو منشئ مواقع ثابتة مزود بوظائف الذكاء الاصطناعي، يهدف إلى تبسيط عملية كتابة المستندات وإنشاء المواقع. يسمح للمستخدمين بالتركيز على كتابة محتوى Markdown بلغتهم الأم، ويتعامل تلقائياً مع إنشاء العناوين، والتنقل عبر التصنيفات، والترجمة التدريجية، ويدعم إصدارات متعددة اللغات دون الحاجة إلى إعدادات معقدة. يعتمد الأداة على Node.js وواجهة برمجة تطبيقات OpenAI، ويبني المواقع بسرعة عبر سطر الأوامر، مما يجعله مناسباً للكتاب الذين يبحثون عن الكفاءة والبساطة.'
+'tags':
+  - 'منشئ المواقع الثابتة'
+  - 'Markdown'
+  - 'الذكاء الاصطناعي'
+  - 'البساطة'
+  - 'الترجمة متعددة اللغات'
+  - 'Node.js'
+  - 'OpenAI'
+'inferred_lang': 'zh-Hans'
 ---
 
-# ZEN - منشئ مواقع ثابتة بالحد الأدنى من Markdown + الذكاء الاصطناعي
+# ZEN - منشئ المواقع الثابتة البسيط باستخدام Markdown + الذكاء الاصطناعي
 
-[> عرض موقع الويب التجريبي](https://zccz14.github.io/ZEN/)
+[> عرض تجريبي للموقع](https://zccz14.github.io/ZEN/)
 
 ## الوظائف الأساسية
 
-1.  📃 **إنشاء موقع ثابت**: يحول أي مجلد git يحتوي على Markdown إلى موقع HTML ثابت.
-2.  🧭 **التنقل الذكي التلقائي**: يستخدم الذكاء الاصطناعي لتحليل المحتوى، وإنشاء خريطة موقع وتنقل، دون الحساسية لموقع الملفات المصدر.
-3.  🌍 **الترجمة التزايدية الآلية**: يستخدم الذكاء الاصطناعي للترجمة التزايدية، مما يمكن المستخدم من كتابة Markdown بلغته الأم، مع إمكانية تعدد اللغات للمستخدم.
+1. 📃 **إنشاء موقع ثابت**: تحويل أي مجلد git يحتوي على Markdown إلى موقع HTML ثابت.
+2. 🧭 **التنقل الذكي عبر التصنيفات**: استخدام الذكاء الاصطناعي لتحليل المحتوى، وإنشاء خريطة الموقع والتنقل، دون الحساسية لموقع الملفات المصدر.
+3. 🌍 **الترجمة التلقائية التدريجية**: استخدام الذكاء الاصطناعي للترجمة التدريجية، مما يسمح للمستخدمين بكتابة Markdown بلغتهم الأم، مع دعمهم بلغات متعددة.
 
-لماذا تم إنشاء منشئ موقع ثابت آخر من Markdown؟ لقد فكرت مرة أخرى في كيفية خدمة أدوات التوثيق للكتاب بشكل أفضل في عصر الذكاء الاصطناعي:
+لماذا قمت بإنشاء منشئ مواقع ثابت آخر باستخدام Markdown؟ لقد فكرت مرة أخرى في كيفية خدمة أدوات المستندات للكتاب بشكل أفضل في عصر الذكاء الاصطناعي:
 
-- العودة إلى المحتوى: تقليل الإزعاج إلى الحد الأدنى، والتركيز على الكتابة
+- العودة إلى المحتوى: تقليل الإزعاج، والتركيز على الكتابة
 
-  إعادة التوثيق إلى جوهره، وإعادة الهدوء إلى الكتابة.
+  إعادة المستندات إلى جوهرها، وإعادة الهدوء إلى الكتابة.
 
-  أولاً، لا أريد أن أكون أمين مكتبة. أحيانًا أريد كتابة بعض المحتوى، لكن قد لا أكون قد فكرت في عنوانه بعد، أو لم أقم بتنظيمه بشكل خاص. أتمنى أن يقوم 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](https://platform.openai.com/account/api-keys)، أو مفتاح واجهة برمجة تطبيقات متوافق مع OPENAI
+- تثبيت 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_API_KEY="sk-xxxxxx"  # إلزامي: يرجى استبداله بمفتاح واجهة برمجة تطبيقات OpenAI الخاص بك
+export OPENAI_BASE_URL="https://api.openai.com/v1"  # اختياري، يستخدم واجهة برمجة تطبيقات OpenAI الرسمية افتراضياً
+export OPENAI_MODEL="gpt-3.5-turbo"  # اختياري، يستخدم نموذج gpt-3.5-turbo افتراضياً
 ```
 
-بناء الموقع، مع دعم الترجمة متعددة اللغات. استخدم المجلد الحالي كمجلد مصدر، والإخراج إلى مجلد `.zen/dist`.
+بناء الموقع، مع دعم الترجمة متعددة اللغات. استخدم المجلد الحالي كمجلد مصدر، وأخرج إلى مجلد `.zen/dist`.
 
-- يمكن تحديد إصدارات اللغة المطلوب إنشاؤها باستخدام معلمة `--lang` عدة مرات (على سبيل المثال `--lang ar-SA --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 ar-SA --lang en-US
+npx zengen@latest build --lang zh-Hans --lang en-US
 ```
 
 **عرض المزيد من المعلمات أو المساعدة**:

package/.zen/src/ar-SA/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md

@@ -0,0 +1,30 @@
+---
+'title': 'تقنيات استخدام إعلان التواريخ في وثائق ZEN'
+'summary': 'يقدم هذا المستند تقنيات استخدام إعلان التواريخ مباشرة في نص الوثيقة باستخدام أداة ZEN، مقارنةً بالطريقة التقليدية في Markdown عبر YAML Frontmatter. يُبرز المستند قدرات ZEN على التعرف التلقائي والمعالجة الذكية، مما يعزز تجربة المستخدم، ويناسب أنواع المحتوى التي تتطلب خط زمني مثل اليوميات والمدونات.'
+'tags':
+  - 'ZEN'
+  - 'إعلان التاريخ'
+  - 'Markdown'
+  - 'المعالجة بالذكاء الاصطناعي'
+  - 'الخط الزمني'
+  - 'تجربة المستخدم'
+  - 'إدارة الوثائق'
+'inferred_date': '2026-01-08'
+'inferred_lang': 'ar-SA'
+---
+
+# نصائح الاستخدام
+
+## إعلان التاريخ في نص الوثيقة
+
+يمكنك استخدام عبارة مثل **"اليوم هو 8 يناير 2026"** في نص الوثيقة (بأي تنسيق حر)، وسيتعرف ZEN عليها ويعالجها تلقائيًا.
+
+في وثائق Markdown التقليدية، يتم إعلان التاريخ عبر YAML Frontmatter، مما يتطلب تذكر الحقول المناسبة، وإلا قد لا يتم التعرف على التاريخ بشكل صحيح.
+
+يدعم ZEN إعلان التاريخ مباشرة في نص الوثيقة، مما يتجنب مشكلة نسيان ملء حقول Frontmatter.
+
+سيقوم الذكاء الاصطناعي باستخراج واستنتاج معلومات التاريخ من نص الوثيقة تلقائيًا، ومعالجتها كتاريخ إنشاء الوثيقة.
+
+هذه الطريقة أكثر مرونة وذكاءً، مما يعزز تجربة المستخدم.
+
+بالمناسبة، يمكن للوثائق التي تحتوي على تواريخ إنشاء عرضًا زمنيًا، مما يسهل التصفح والإدارة. وهي مناسبة بشكل خاص لأنواع المحتوى التي تتطلب خطًا زمنيًا مثل اليوميات والمدونات.

package/.zen/src/da-DK/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md

@@ -1,15 +1,15 @@
 ---
-title: ZEN - Minimalistisk Markdown + AI statisk site-generator
-summary: ZEN er en statisk site-generator kombineret med AI, der understøtter intelligent kategorisering og navigation samt automatisk inkrementel oversættelse. Det lader brugeren fokusere på at skrive på deres modersmål og forenkler konfigurations- og byggeprocessen.
-tags:
-  - Statisk site-generator
-  - Markdown
-  - AI
-  - Flersproget oversættelse
-  - Minimalisme
-  - Dokumentationsværktøj
-  - Node.js
-inferred_lang: da-DK
+'title': 'ZEN - Minimalistisk Markdown + AI statisk site-generator'
+'summary': 'ZEN er en statisk site-generator med AI-funktioner, designet til at forenkle dokumentationsskrivning og site-opbygning. Den lader brugeren fokusere på at skrive Markdown-indhold på deres modersmål, håndterer automatisk titelgenerering, kategorinavigation og inkrementel oversættelse, understøtter flersprogede versioner uden kompleks konfiguration. Værktøjet er baseret på Node.js og OpenAI API, bygger sites hurtigt via kommandolinjen og er velegnet til forfattere, der søger effektivitet og enkelhed.'
+'tags':
+  - 'Statisk site-generator'
+  - 'Markdown'
+  - 'AI'
+  - 'Minimalisme'
+  - 'Flersproget oversættelse'
+  - 'Node.js'
+  - 'OpenAI'
+'inferred_lang': 'da-DK'
 ---
 
 # ZEN - Minimalistisk Markdown + AI statisk site-generator
@@ -18,53 +18,53 @@ inferred_lang: da-DK
 
 ## Grundlæggende funktioner
 
-1. 📃 **Statisk site-generering**: Bygger en mappe med Markdown-filer (styret af git) om til et statisk HTML-site.
-2. 🧭 **Intelligent kategorisering og navigation**: Bruger AI til at analysere indhold og generere et site-map og navigation. Placeringen af kildefiler er ikke afgørende.
-3. 🌍 **Automatisk inkrementel oversættelse**: Bruger AI til inkrementel oversættelse, så brugeren kan skrive Markdown på deres modersmål, mens sitet kan være flersproget.
+1. 📃 **Statisk site-generering**: Byg en hvilken som helst git-mappe, der indeholder Markdown, om til et statisk HTML-site.
+2. 🧭 **Intelligent kategorinavigation**: Brug AI til indholdsanalyse, generer et site-map og navigation, uafhængigt af kildefilernes placering.
+3. 🌍 **Automatisk inkrementel oversættelse**: Brug AI til inkrementel oversættelse, så brugeren kan skrive Markdown på deres modersmål, men stadig have flersproget indhold.
 
-Hvorfor endnu en Markdown statisk site-generator? Jeg har genovervejet, hvordan dokumentationsværktøjer i AI-tidsalderen bedre kan tjene forfattere:
+Hvorfor endnu en Markdown statisk site-generator? Jeg har genovervejet, hvordan dokumentationsværktøjer i AI-tiden bedre kan tjene forfattere:
 
-- Tilbage til indholdet: Minimér forstyrrelser, fokuser på skrivningen
+- Tilbage til indholdet: Minimal forstyrrelse, fokus på skrivning
 
-  Lad dokumentationen vende tilbage til essensen, lad skrivningen vende tilbage til roen.
+  Lad dokumentationen vende tilbage til essensen, lad skrivningen vende tilbage til ro.
 
-  For det første vil jeg ikke være bibliotekar. Nogle gange vil jeg skrive noget ned, men jeg har måske ikke tænkt på en titel endnu, eller organiseret det særligt godt. Jeg ønsker, at LLM automatisk vil hjælpe mig med at generere titler, lave resuméer, kategorisere, navigere og andre organisatoriske opgaver.
+  For det første vil jeg ikke være bibliotekar. Nogle gange vil jeg skrive noget indhold, men jeg har måske ikke tænkt på en titel endnu, eller organiseret det særligt. Jeg ønsker, at LLM automatisk vil generere titler, lave resuméer, kategorisere, navigere og udføre andet organisatorisk arbejde.
 
-  For det andet skal mit skrivebord være rent og ryddeligt. Jeg vil ikke have komplekse konfigurationsværktøjer, rode med indviklede dokumentationsopsætninger eller komplicerede strukturer. Hver gang jeg ser konfigurationsfiler og projektstrukturer fra værktøjer som Docusaurus, VuePress eller Astro, får jeg hovedpine. Nu vælger ZEN at skjule al konfiguration i `.zen`-mappen, feje den ind i et hjørne. Brugeren skal kun fokusere på at skrive indhold, resten håndterer ZEN. Alle andre mapper er dit skriveområde, hvor du frit kan organisere dine Markdown-filer.
+  For det andet skal mit skriveværelse være rent og ryddeligt. Jeg vil ikke have komplekse konfigurationsværktøjer, rode med indviklede dokumentationsopsætninger eller komplicerede strukturer. Hver gang jeg ser konfigurationsfiler og projektstrukturer fra værktøjer som Docusaurus, VuePress eller Astro, får jeg hovedpine. Nu vælger ZEN at skjule al konfiguration i .zen-mappen, feje det væk i et hjørne. Brugeren skal kun fokusere på at skrive indhold, resten håndteres af ZEN. Alle andre mapper er dit skriveområde, hvor du frit kan organisere dine Markdown-filer.
 
 - Tilbage til modersmålet: Skriv på modersmål, byg flersprogede versioner problemfrit
 
-  Livet er for kort til at jeg gider oversætte. Man udtrykker sine tanker bedst, når man bruger sit modersmål. Men samtidig er det nødvendigt at forbinde sig med verden, og jeg vil ikke opgive flersproget kommunikation. Derfor ønsker jeg et værktøj, der lader mig skrive på mit modersmål, samtidig med at det gør mit indhold tilgængeligt for flere. Nuværende i18n-løsninger kræver, at man selv oversætter og vedligeholder opdateringer, hvilket er for besværligt. Jeg vælger at bruge LLM til at hjælpe mig med oversættelsen, hvilket sparer mig for meget tid og gør det muligt at fuldføre oversættelser til flere sprog med et enkelt klik.
+  Livet er for kort til at jeg gider oversætte. Man udtrykker sine tanker bedst, når man bruger sit modersmål. Men samtidig er det nødvendigt at forbinde sig med verden, og jeg vil ikke opgive flersproget kommunikation. Derfor ønsker jeg et værktøj, der lader mig skrive på mit modersmål, samtidig med at flere kan se mit indhold. Nuværende i18n kræver, at man selv oversætter og vedligeholder opdateringer, det er for besværligt. Jeg vælger at bruge LLM til at hjælpe med oversættelsen, det sparer mig for meget tid og kan udføres med et enkelt klik for flere sprog.
 
 ## Hurtig start
 
 Forudsætninger:
 
-- [Node.js](https://nodejs.org/) er installeret (anbefalet version 18 eller nyere, skal have `npx`-kommandoen)
-- Du har en [OpenAI API-nøgle](https://platform.openai.com/account/api-keys), eller en OPENAI-kompatibel API-nøgle
-- Git er installeret (bruges til at liste Markdown-filer fra et Git-repository og ignorere filer filtreret af `.gitignore`-regler)
+- [Node.js](https://nodejs.org/) installeret (anbefalet version 18 eller nyere, skal have npx-kommandoen)
+- Har fået en [OpenAI API-nøgle](https://platform.openai.com/account/api-keys), eller en OPENAI-kompatibel API-nøgle
+- Git installeret (bruges til at liste Markdown-filer fra Git, ignorerer filer filtreret af .gitignore-regler)
 
-Først, arbejd i en mappe, der allerede er styret af Git:
+Først, arbejd i en mappe, der allerede administreres af git:
 
 Konfigurer miljøvariabler
 
 ```bash
 export OPENAI_API_KEY="sk-xxxxxx"  # Påkrævet: Erstat med din OpenAI API-nøgle
-export OPENAI_BASE_URL="https://api.openai.com/v1"  # Valgfri, bruger OpenAIs officielle API som standard
+export OPENAI_BASE_URL="https://api.openai.com/v1"  # Valgfri, bruger standard OpenAI officielle API som standard
 export OPENAI_MODEL="gpt-3.5-turbo"  # Valgfri, bruger gpt-3.5-turbo-modellen som standard
 ```
 
-Byg sitet, understøtter flersproget oversættelse. Bruger den aktuelle mappe som kildemappe og output til `.zen/dist`-mappen.
+Byg sitet, understøtter flersproget oversættelse. Brug den aktuelle mappe som kildemappe, output til `.zen/dist`-mappen.
 
-- Du kan angive de sprogversioner, der skal genereres, ved gentagne gange at bruge `--lang`-parameteren (f.eks. `--lang zh-Hans --lang en-US`).
-- Du kan angive det grundlæggende URL-præfiks for sitet med `--base-url`-parameteren (f.eks. dit repositorienavn på GitHub Pages).
+- Du kan angive de ønskede sprogversioner ved gentagne gange at bruge `--lang`-parameteren (f.eks. `--lang zh-Hans --lang en-US`).
+- Du kan angive siteets basis-URL-præfiks med `--base-url`-parameteren (f.eks. repository-navnet på GitHub Pages).
 - Kilde-sproget behøver ikke konfigureres, ZEN detekterer det automatisk.
 
 ```bash
 npx zengen@latest build --lang zh-Hans --lang en-US
 ```
 
-**Se flere parametre eller få hjælp**:
+**Se flere parametre eller hjælp**:
 
 ```bash
 npx zengen@latest

package/.zen/src/da-DK/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md

@@ -0,0 +1,30 @@
+---
+'title': 'ZEN Dokumentdatoerklæring Brugstips'
+'summary': 'Dette dokument introducerer teknikker til direkte datoerklæring i brødteksten i ZEN-værktøjet, sammenlignet med den traditionelle Markdown-metode via YAML Frontmatter. Det understreger ZENs automatiske genkendelse og intelligente behandlingsfunktioner, som forbedrer brugeroplevelsen og er velegnet til indholdstyper som dagbøger og blogs, der kræver tidslinjer.'
+'tags':
+  - 'ZEN'
+  - 'Datoerklæring'
+  - 'Markdown'
+  - 'AI-behandling'
+  - 'Tidslinje'
+  - 'Brugeroplevelse'
+  - 'Dokumenthåndtering'
+'inferred_date': '2026-01-08'
+'inferred_lang': 'da-DK'
+---
+
+# Brugstips
+
+## Erklær dato i brødteksten
+
+I brødteksten kan du bruge en datoerklæring som "I dag er den 8. januar 2026" (formatstil er frit), og ZEN vil automatisk genkende og behandle den.
+
+Traditionelle Markdown-dokumenter erklærer datoer via YAML Frontmatter, hvilket kræver, at man husker de relevante felter; ellers kan datoen ikke korrekt genkendes.
+
+ZEN understøtter direkte datoerklæring i brødteksten, hvilket undgår problemet med at glemme at udfylde Frontmatter-felter.
+
+AI vil automatisk udtrække og udlede datooplysninger fra brødteksten og behandle dem som dokumentets oprettelsesdato.
+
+Denne metode er mere fleksibel og intelligent og forbedrer brugeroplevelsen.
+
+I øvrigt kan dokumenter med datoer generere en tidslinjevisning, hvilket gør det nemt at gennemse og administrere. Dette er særligt velegnet til indholdstyper som dagbøger og blogs, der kræver tidslinjer.

package/.zen/src/de-DE/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md

@@ -1,15 +1,15 @@
 ---
-title: ZEN - Minimalistischer Markdown + AI Static Site Builder
-summary: ZEN ist ein statischer Site-Generator mit KI-Unterstützung, der intelligente Kategorienavigation und automatische inkrementelle Übersetzung bietet. Er ermöglicht es Nutzern, sich auf das Schreiben in ihrer Muttersprache zu konzentrieren und vereinfacht Konfiguration und Build-Prozess.
-tags:
-  - Static Site Generator
-  - Markdown
-  - AI
-  - Mehrsprachige Übersetzung
-  - Minimalismus
-  - Dokumentationstool
-  - Node.js
-inferred_lang: de-DE
+'title': 'ZEN - Minimalistischer Markdown + AI Static Site Builder'
+'summary': 'ZEN ist ein statischer Site-Generator mit KI-Funktionen, der darauf abzielt, das Schreiben von Dokumentation und den Site-Erstellungsprozess zu vereinfachen. Er ermöglicht es Nutzern, sich auf das Verfassen von Markdown-Inhalten in ihrer Muttersprache zu konzentrieren, während er automatisch Titelgenerierung, Kategorienavigation und inkrementelle Übersetzung übernimmt. Er unterstützt mehrsprachige Versionen ohne komplexe Konfiguration. Das Tool basiert auf Node.js und der OpenAI API und erstellt Sites schnell über die Kommandozeile. Es eignet sich für Autor:innen, die Effizienz und Einfachheit schätzen.'
+'tags':
+  - 'Statischer Site-Generator'
+  - 'Markdown'
+  - 'KI'
+  - 'Minimalismus'
+  - 'Mehrsprachige Übersetzung'
+  - 'Node.js'
+  - 'OpenAI'
+'inferred_lang': 'de-DE'
 ---
 
 # ZEN - Minimalistischer Markdown + AI Static Site Builder
@@ -18,46 +18,46 @@ inferred_lang: de-DE
 
 ## Grundlegende Funktionen
 
-1.  📃 **Statische Site-Generierung**: Erstellt aus einem beliebigen Git-Ordner mit Markdown-Dateien eine statische HTML-Website.
+1.  📃 **Statische Site-Generierung**: Erstellt aus einem beliebigen Git-Ordner mit Markdown-Dateien eine statische HTML-Site.
 2.  🧭 **Intelligente Kategorienavigation**: Nutzt KI zur Inhaltsanalyse, um eine Sitemap und Navigation zu generieren. Die Position der Quelldateien ist irrelevant.
-3.  🌍 **Automatische inkrementelle Übersetzung**: Nutzt KI für inkrementelle Übersetzungen. Nutzer können in ihrer Muttersprache schreiben, aber die Zielgruppe kann mehrsprachig sein.
+3.  🌍 **Automatische inkrementelle Übersetzung**: Nutzt KI für inkrementelle Übersetzungen. Nutzer:innen können Markdown in ihrer Muttersprache schreiben, während die Site mehrsprachig wird.
 
-Warum noch ein weiterer Markdown Static Site Generator? Ich habe überlegt, wie Dokumentationstools im KI-Zeitalter Autoren besser dienen können:
+Warum noch ein weiterer Markdown Static Site Generator? Ich habe überdacht, wie Dokumentationstools im KI-Zeitalter Autor:innen besser dienen können:
 
 - Zurück zum Inhalt: Minimale Ablenkung, Fokus auf das Schreiben
 
   Lasst die Dokumentation zu ihrem Wesen zurückkehren und das Schreiben zur Ruhe.
 
-  Erstens: Ich möchte kein Bibliothekar sein. Manchmal möchte ich etwas aufschreiben, habe aber vielleicht noch keinen Titel oder eine klare Struktur. Ich möchte, dass eine LLM automatisch Titel generiert, Zusammenfassungen erstellt, kategorisiert, navigiert und andere organisatorische Aufgaben übernimmt.
+  Erstens: Ich möchte kein Bibliothekar sein. Manchmal möchte ich etwas aufschreiben, ohne mir bereits einen Titel oder eine klare Struktur überlegt zu haben. Ich möchte, dass eine LLM automatisch Titel generiert, Zusammenfassungen erstellt, kategorisiert und Navigationsstrukturen erarbeitet.
 
-  Zweitens: Mein Arbeitsbereich muss aufgeräumt sein. Ich möchte keine komplexen Build-Tools konfigurieren, mich nicht mit komplizierten Dokumenteneinstellungen herumschlagen oder komplexe Strukturen haben. Jedes Mal, wenn ich die Konfigurationsdateien und Projektstrukturen von Tools wie Docusaurus, VuePress oder Astro sehe, bekomme ich Kopfschmerzen. ZEN versteckt nun alle Konfigurationen im `.zen`-Verzeichnis, schiebt sie in die Ecke. Der Nutzer kann sich ganz auf den Inhalt konzentrieren, den Rest erledigt ZEN. Alle anderen Verzeichnisse sind Ihr Schreibbereich, Sie können Ihre Markdown-Dateien frei organisieren.
+  Zweitens: Mein Arbeitsbereich muss aufgeräumt sein. Ich möchte keine komplexen Build-Tools konfigurieren, keine komplizierten Dokumentenstrukturen erstellen und keine überladenen Projekte verwalten. Die Konfigurationsdateien und Projektstrukturen von Tools wie Docusaurus, VuePress oder Astro bereiten mir Kopfschmerzen. ZEN versteckt daher alle Konfigurationen im `.zen`-Verzeichnis – aus dem Weg geräumt. Nutzer:innen konzentrieren sich auf den Inhalt, den Rest erledigt ZEN. Alle anderen Verzeichnisse sind Ihr Schreibbereich, Sie können Ihre Markdown-Dateien frei organisieren.
 
 - Zurück zur Muttersprache: In der Muttersprache schreiben, nahtlos mehrsprachige Versionen erstellen
 
-  Das Leben ist zu kurz für Übersetzungen. Man denkt am tiefsten in seiner Muttersprache. Gleichzeitig ist die Verbindung zur Welt notwendig, ich möchte den mehrsprachigen Austausch nicht aufgeben. Daher wünsche ich mir ein Tool, mit dem ich in meiner Muttersprache schreiben kann, während mehr Menschen meinen Inhalt sehen können. Aktuelle i18n-Lösungen erfordern nicht nur eigene Übersetzungen, sondern auch die Pflege von Aktualisierungen – zu umständlich. Ich nutze LLMs für Übersetzungen, das spart viel Zeit und mehrsprachige Übersetzungen sind mit einem Klick erledigt.
+  Das Leben ist zu kurz für manuelle Übersetzungen. Man denkt am tiefsten in der Muttersprache. Dennoch ist der Austausch mit der Welt wichtig, ich möchte nicht auf mehrsprachige Kommunikation verzichten. Daher wünsche ich mir ein Tool, mit dem ich in meiner Muttersprache schreiben kann, während meine Inhalte für ein globales Publikum zugänglich sind. Herkömmliche i18n-Lösungen erfordern eigene Übersetzungen und mühsame Pflege bei Updates. Ich nutze eine LLM für Übersetzungen, was viel Zeit spart und mehrsprachige Versionen auf Knopfdruck ermöglicht.
 
 ## Schnellstart
 
 Voraussetzungen:
 
-- [Node.js](https://nodejs.org/) installiert (empfohlen Version 18 oder höher, `npx`-Befehl benötigt)
-- [OpenAI API Key](https://platform.openai.com/account/api-keys) oder kompatibler API-Key beschafft
-- Git installiert (um Markdown-Dateien aus Git aufzulisten und durch `.gitignore` gefilterte Dateien zu ignorieren)
+- [Node.js](https://nodejs.org/) installiert (empfohlen: Version 18 oder höher, inkl. `npx`-Befehl)
+- Einen [OpenAI API Key](https://platform.openai.com/account/api-keys) oder einen kompatiblen API-Key für OpenAI-kompatible Dienste
+- Git installiert (wird benötigt, um Markdown-Dateien aus einem Git-Repository zu lesen und Dateien gemäß `.gitignore` zu ignorieren)
 
-Arbeiten Sie zunächst in einem von Git verwalteten Ordner:
+Arbeiten Sie zunächst in einem Ordner, der bereits von Git verwaltet wird:
 
 Umgebungsvariablen konfigurieren
 
 ```bash
 export OPENAI_API_KEY="sk-xxxxxx"  # Erforderlich: Bitte durch Ihren OpenAI API Key ersetzen
-export OPENAI_BASE_URL="https://api.openai.com/v1"  # Optional, standardmäßig wird die offizielle OpenAI API verwendet
+export OPENAI_BASE_URL="https://api.openai.com/v1"  # Optional, standardmäßig wird die offizielle OpenAI-API verwendet
 export OPENAI_MODEL="gpt-3.5-turbo"  # Optional, standardmäßig wird das gpt-3.5-turbo Modell verwendet
 ```
 
-Site erstellen, mit Unterstützung für mehrsprachige Übersetzung. Nutzt das aktuelle Verzeichnis als Quellverzeichnis und gibt in `.zen/dist` aus.
+Site erstellen, mit Unterstützung für mehrsprachige Übersetzung. Nutzt das aktuelle Verzeichnis als Quellverzeichnis und schreibt die Ausgabe in das Verzeichnis `.zen/dist`.
 
 - Mehrere Sprachversionen können durch wiederholte Verwendung des `--lang`-Parameters angegeben werden (z.B. `--lang de-DE --lang en-US`).
-- Die Basis-URL-Präfix der Site kann mit dem `--base-url`-Parameter angegeben werden (z.B. der Repository-Name auf GitHub Pages).
+- Die Basis-URL-Präfix der Site kann mit dem Parameter `--base-url` festgelegt werden (z.B. für den Repository-Namen auf GitHub Pages).
 - Die Quellsprache muss nicht konfiguriert werden, ZEN erkennt sie automatisch.
 
 ```bash

package/.zen/src/de-DE/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md

@@ -0,0 +1,30 @@
+---
+'title': 'ZEN-Dokument Datumsdeklaration Verwendungstipps'
+'summary': 'Dieses Dokument stellt die Verwendungstipps für die direkte Datumsdeklaration im Haupttext des ZEN-Tools vor. Im Vergleich zur traditionellen Methode der Datumsdeklaration über YAML Frontmatter in Markdown hebt es die automatische Erkennung und intelligente Verarbeitungsfunktion von ZEN hervor, verbessert die Benutzererfahrung und eignet sich für Inhaltstypen wie Tagebücher, Blogs usw., die eine Zeitleiste erfordern.'
+'tags':
+  - 'ZEN'
+  - 'Datumsdeklaration'
+  - 'Markdown'
+  - 'KI-Verarbeitung'
+  - 'Zeitleiste'
+  - 'Benutzererfahrung'
+  - 'Dokumentenverwaltung'
+'inferred_date': '2026-01-08'
+'inferred_lang': 'de-DE'
+---
+
+# Verwendungstipps
+
+## Datum im Haupttext deklarieren
+
+Im Haupttext können Datumsdeklarationen wie "Heute ist der 8. Januar 2026" verwendet werden (das Format ist frei wählbar). ZEN erkennt und verarbeitet diese automatisch.
+
+Traditionelle Markdown-Dokumente deklarieren das Datum über YAML Frontmatter, wobei das entsprechende Feld bekannt sein muss, da sonst das Datum nicht korrekt erkannt werden kann.
+
+ZEN unterstützt die direkte Datumsdeklaration im Haupttext und vermeidet so das Problem, das Frontmatter-Feld zu vergessen.
+
+Die KI extrahiert und leitet automatisch die Datumsinformationen aus dem Haupttext ab und verarbeitet sie als Erstellungsdatum des Dokuments.
+
+Diese Methode ist flexibler und intelligenter und verbessert die Benutzererfahrung.
+
+Nebenbei bemerkt: Dokumente mit Datum können eine Zeitleistenansicht generieren, was das Durchsuchen und Verwalten erleichtert. Besonders geeignet für Inhaltstypen wie Tagebücher, Blogs usw., die eine Zeitleiste erfordern.

package/.zen/src/en-US/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md

@@ -1,48 +1,48 @@
 ---
-title: ZEN - Minimalist Markdown + AI Static Site Builder
-summary: ZEN is a static site generator integrated with AI, supporting intelligent categorization, navigation, and automatic incremental translation. It allows users to focus on writing in their native language while simplifying configuration and build processes.
-tags:
-  - Static Site Generator
-  - Markdown
-  - AI
-  - Multilingual Translation
-  - Minimalism
-  - Documentation Tool
-  - Node.js
-inferred_lang: zh-Hans
+'title': 'ZEN - A Minimalist Markdown + AI Static Site Builder'
+'summary': 'ZEN is a static site generator with AI capabilities, designed to simplify the process of writing documentation and building websites. It allows users to focus on writing Markdown content in their native language, automatically handling title generation, categorized navigation, and incremental translation. It supports multilingual versions without complex configuration. Built on Node.js and the OpenAI API, it enables rapid site construction via the command line, making it ideal for writers who value efficiency and simplicity.'
+'tags':
+  - 'Static Site Generator'
+  - 'Markdown'
+  - 'AI'
+  - 'Minimalism'
+  - 'Multilingual Translation'
+  - 'Node.js'
+  - 'OpenAI'
+'inferred_lang': 'zh-Hans'
 ---
 
-# ZEN - Minimalist Markdown + AI Static Site Builder
+# ZEN - A Minimalist Markdown + AI Static Site Builder
 
 [> Website Demo](https://zccz14.github.io/ZEN/)
 
 ## Core Features
 
-1. 📃 **Static Site Generation**: Builds a static HTML site from any git-managed folder containing Markdown files.
-2. 🧭 **Intelligent Categorization & Navigation**: Uses AI for content analysis to generate a sitemap and navigation, independent of source file locations.
-3. 🌍 **Automatic Incremental Translation**: Employs AI for incremental translation, allowing users to write Markdown in their native language while supporting multilingual audiences.
+1. 📃 **Static Site Generation**: Build a static HTML site from any git-managed folder containing Markdown files.
+2. 🧭 **Intelligent Categorized Navigation**: Use AI to analyze content, generating a site map and navigation that is independent of the original file structure.
+3. 🌍 **Automatic Incremental Translation**: Use AI for incremental translation, allowing users to write Markdown in their native language while supporting multilingual audiences.
 
 Why create another Markdown static site generator? I've reconsidered how documentation tools can better serve writers in the AI era:
 
 - **Return to Content: Minimize Distractions, Focus on Writing**
 
-  Let documentation return to its essence and writing to its tranquility.
+  Bring documentation back to its essence and restore tranquility to the writing process.
 
-  First, I don't want to be a librarian. Sometimes I want to jot down ideas before finalizing titles or organizing them perfectly. I wish LLMs could automatically generate titles, summaries, categories, and navigation for me.
+  First, I don't want to be a librarian. Sometimes I want to jot down ideas before I've settled on a title or organized them fully. I want an LLM to automatically generate titles, create summaries, categorize content, and handle navigation.
 
-  Second, my workspace must be clean. I dislike complex build tool configurations, intricate documentation setups, and convoluted structures. Tools like Docusaurus, VuePress, and Astro often give me headaches with their config files and project layouts. ZEN hides all configuration in a `.zen` directory, tucked away in a corner. Users only need to focus on writing content; ZEN handles the rest. All other directories are your writing space, where you can organize Markdown files freely.
+  Second, my workspace must stay clean. I don't want complex build tools, intricate documentation configurations, or convoluted structures. Tools like Docusaurus, VuePress, and Astro often overwhelm me with their configuration files and project layouts. ZEN hides all configuration in a `.zen` directory, tucked out of sight. Users can focus solely on writing, leaving the rest to ZEN. All other directories are your writing space—organize your Markdown files however you like.
 
-- **Return to Native Language: Write in Your Mother Tongue, Build Multilingual Versions Smoothly**
+- **Return to Native Language: Write in Your Mother Tongue, Seamlessly Build Multilingual Versions**
 
-  Life is short; I'm too lazy to translate. People think most deeply in their native language. Yet, connecting with the world is essential, and I don't want to give up multilingual communication. I desire a tool that lets me write in my native language while making my content accessible to a broader audience. Traditional i18n requires manual translation and content update maintenance, which is too cumbersome. I choose to use LLMs for translation, saving significant time and enabling one-click multilingual builds.
+  Life is short; I don't want to translate. People think most deeply in their native language. Yet, staying connected to the world is essential—I don't want to give up multilingual communication. I needed a tool that lets me write in my native language while making my content accessible to a broader audience. Traditional i18n requires manual translation and ongoing content maintenance, which is too cumbersome. I chose to use LLMs for translation, saving significant time and enabling one-click multilingual support.
 
 ## Quick Start
 
 Prerequisites:
 
-- [Node.js](https://nodejs.org/) installed (version 18 or above recommended, `npx` command required)
-- [OpenAI API Key](https://platform.openai.com/account/api-keys) obtained, or an OPENAI-compatible API Key
-- Git installed (used to list Markdown files from Git, ignoring files filtered by `.gitignore` rules)
+- [Node.js](https://nodejs.org/) installed (version 18 or higher recommended, with `npx` command available)
+- An [OpenAI API Key](https://platform.openai.com/account/api-keys) or a compatible OpenAI API key
+- Git installed (used to list Markdown files from a Git repository, ignoring files filtered by `.gitignore` rules)
 
 First, work within a folder already managed by Git:
 
@@ -54,11 +54,11 @@ export OPENAI_BASE_URL="https://api.openai.com/v1"  # Optional, defaults to the
 export OPENAI_MODEL="gpt-3.5-turbo"  # Optional, defaults to the gpt-3.5-turbo model
 ```
 
-Build the site with support for multilingual translation. Uses the current directory as the source and outputs to the `.zen/dist` directory.
+Build the site with support for multilingual translation. Use the current directory as the source and output to the `.zen/dist` directory.
 
-- Specify language versions to generate using the `--lang` parameter multiple times (e.g., `--lang zh-Hans --lang en-US`).
-- Specify the site's base URL prefix using the `--base-url` parameter (e.g., the repository name on GitHub Pages).
-- No need to configure the source language; ZEN will auto-detect it.
+- Specify language versions using the `--lang` parameter multiple times (e.g., `--lang zh-Hans --lang en-US`).
+- Set the site's base URL prefix with the `--base-url` parameter (e.g., for a GitHub Pages repository name).
+- No need to configure the source language—ZEN detects it automatically.
 
 ```bash
 npx zengen@latest build --lang zh-Hans --lang en-US

package/.zen/src/en-US/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md

@@ -0,0 +1,30 @@
+---
+'title': 'ZEN Documentation Date Declaration Usage Tips'
+'summary': "This document introduces the technique of declaring dates directly within the body text using the ZEN tool. It contrasts this with the traditional Markdown method of declaring dates via YAML Frontmatter, highlighting ZEN's automatic recognition and intelligent processing capabilities. This approach enhances the user experience and is suitable for content types like diaries and blogs that require a timeline."
+'tags':
+  - 'ZEN'
+  - 'Date Declaration'
+  - 'Markdown'
+  - 'AI Processing'
+  - 'Timeline'
+  - 'User Experience'
+  - 'Document Management'
+'inferred_date': '2026-01-08'
+'inferred_lang': 'zh-Hans'
+---
+
+# Usage Tips
+
+## Declaring Dates in the Body Text
+
+Within the body text, you can use date declarations like "Today is January 8, 2026" (the format style is flexible), and ZEN will automatically recognize and process it.
+
+Traditional Markdown documents declare dates through YAML Frontmatter, which requires remembering the corresponding field; otherwise, the date may not be correctly identified.
+
+ZEN supports declaring dates directly within the body text, avoiding the issue of forgetting to fill in the Frontmatter field.
+
+The AI will automatically extract and infer date information from the body text and process it as the document's creation date.
+
+This method is more flexible and intelligent, enhancing the user experience.
+
+As a side note, documents with dates can generate a timeline view, making browsing and management easier. This is particularly suitable for content types like diaries and blogs that require a timeline.