zengen 0.2.6 → 0.3.1

package/.zen/meta.json

@@ -33,22 +33,39 @@
   },
   "files": [
     {
-      "hash": "74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805",
+      "hash": "6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed",
       "path": "README.md",
       "links": [
-        "https://zccz14.github.io/ZEN/",
+        "https://zen.zccz14.com/",
         "https://nodejs.org/",
         "https://platform.openai.com/account/api-keys"
       ],
       "metadata": {
         "title": "ZEN - 极简主义 Markdown + AI 静态站点构建器",
-        "summary": "ZEN 是一个结合 AI 功能的静态站点生成器，旨在简化文档写作和站点构建过程。它允许用户专注于用母语编写 Markdown 内容，自动处理标题生成、分类导航和增量翻译，支持多语言版本，无需复杂配置。工具基于 Node.js 和 OpenAI API，通过命令行快速构建站点，适合追求高效和简洁的写作者。",
-        "tags": ["静态站点生成器", "Markdown", "AI", "极简主义", "多语言翻译", "Node.js", "OpenAI"],
+        "summary": "ZEN 是一个结合 AI 的静态站点生成器，专注于简化文档写作和构建过程。它允许用户使用 Markdown 在 git 管理的文件夹中创建静态 HTML 站点，无需复杂配置，所有设置隐藏在 .zen 目录下。核心功能包括智能分类导航（通过 AI 分析内容生成站点地图）、自动增量翻译（支持多语言版本，用户可用母语写作，AI 处理翻译），以及最小化打扰的写作体验。工具依赖 Node.js、OpenAI API Key 和 Git，通过命令行快速构建，支持指定语言参数如 zh-Hans 和 en-US。",
+        "tags": ["静态站点生成器", "Markdown", "AI", "多语言翻译", "极简主义", "文档工具", "ZEN"],
         "inferred_lang": "zh-Hans",
         "tokens_used": {
-          "prompt": 1038,
-          "completion": 163,
-          "total": 1201
+          "prompt": 1011,
+          "completion": 212,
+          "total": 1223
+        }
+      }
+    },
+    {
+      "hash": "50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c",
+      "path": "docs/test-mermaid.md",
+      "links": [],
+      "metadata": {
+        "title": "Mermaid 图表测试文档",
+        "summary": "该文档是一个测试文件，用于验证 ZEN 中的 Mermaid 图表渲染功能。它包含了多种 Mermaid 图表类型的示例，如流程图、序列图、甘特图、类图、状态图和饼图，并包括一个错误语法测试以检查错误信息显示。文档旨在展示 Mermaid 集成在 ZEN 中的正常工作状态。",
+        "tags": ["Mermaid", "图表测试", "ZEN", "流程图", "序列图", "甘特图", "类图", "状态图"],
+        "inferred_date": "2024-01-01",
+        "inferred_lang": "zh-Hans",
+        "tokens_used": {
+          "prompt": 899,
+          "completion": 156,
+          "total": 1055
         }
       }
     },

package/.zen/src/ar-SA/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md

@@ -0,0 +1,121 @@
+---
+'title': 'وثيقة اختبار مخططات Mermaid'
+'summary': 'هذه الوثيقة هي ملف اختبار للتحقق من وظيفة عرض مخططات Mermaid في ZEN. تحتوي على أمثلة لأنواع متعددة من مخططات Mermaid، مثل المخططات الانسيابية، ومخططات التسلسل، ومخططات جانت، ومخططات الفئات، ومخططات الحالة، والمخططات الدائرية، وتتضمن اختبارًا لبناء جملة خاطئ للتحقق من عرض رسائل الخطأ. تهدف الوثيقة إلى عرض حالة عمل تكامل Mermaid في ZEN بشكل صحيح.'
+'tags':
+  - 'Mermaid'
+  - 'اختبار المخططات'
+  - 'ZEN'
+  - 'المخطط الانسيابي'
+  - 'مخطط التسلسل'
+  - 'مخطط جانت'
+  - 'مخطط الفئات'
+  - 'مخطط الحالة'
+'inferred_date': '2024-01-01'
+'inferred_lang': 'ar-SA'
+---
+
+# اختبار مخططات Mermaid
+
+هذا ملف اختبار للتحقق من وظيفة عرض مخططات Mermaid في ZEN.
+
+## مثال على المخطط الانسيابي
+
+```mermaid
+graph TD
+    A[بداية] --> B{هل تستمر؟}
+    B -->|نعم| C[تنفيذ العملية]
+    B -->|لا| D[نهاية]
+    C --> E[فحص النتيجة]
+    E --> F{هل نجحت؟}
+    F -->|نعم| G[اكتمال]
+    F -->|لا| H[إعادة المحاولة]
+    H --> C
+    G --> D
+```
+
+## مثال على مخطط التسلسل
+
+```mermaid
+sequenceDiagram
+    participant المستخدم
+    participant النظام
+    participant قاعدة_البيانات
+
+    المستخدم->>النظام: تقديم الطلب
+    النظام->>قاعدة_البيانات: استعلام البيانات
+    قاعدة_البيانات-->>النظام: إرجاع النتيجة
+    النظام-->>المستخدم: عرض النتيجة
+```
+
+## مثال على مخطط جانت
+
+```mermaid
+gantt
+    title الجدول الزمني للمشروع
+    dateFormat  YYYY-MM-DD
+    section التصميم
+    تحليل المتطلبات     :مكتمل,    des1, 2024-01-01, 7d
+    تصميم النموذج الأولي     :نشط,  des2, 2024-01-08, 5d
+    التصميم التفصيلي     :         des3, after des2, 5d
+    section التطوير
+    تطوير الواجهة الأمامية     :         dev1, after des3, 10d
+    تطوير الواجهة الخلفية     :         dev2, after des3, 15d
+    section الاختبار
+    الاختبار الوحدوي     :         test1, after dev1, 5d
+    اختبار التكامل     :         test2, after dev2, 5d
+```
+
+## مثال على مخطط الفئات
+
+```mermaid
+classDiagram
+    class الحيوان {
+        +String الاسم
+        +int العمر
+        +void أكل()
+        +void نوم()
+    }
+    class الكلب {
+        +void نباح()
+    }
+    class القط {
+        +void مواء()
+    }
+
+    الحيوان <|-- الكلب
+    الحيوان <|-- القط
+```
+
+## مثال على مخطط الحالة
+
+```mermaid
+stateDiagram-v2
+    [*] --> خامل
+    خامل --> معالجة : بدء المعالجة
+    معالجة --> نجاح : نجاح المعالجة
+    معالجة --> خطأ : فشل المعالجة
+    نجاح --> [*]
+    خطأ --> [*]
+```
+
+## مثال على المخطط الدائري
+
+```mermaid
+pie title معدل استخدام المتصفحات
+    "Chrome" : 65.2
+    "Firefox" : 15.3
+    "Safari" : 12.5
+    "Edge" : 5.2
+    "أخرى" : 1.8
+```
+
+## اختبار بناء جملة خاطئ (يجب أن يعرض رسالة خطأ)
+
+```mermaid
+graph TD
+    A --> B
+    // هنا تعريف السهم مفقود
+    C --> D
+```
+
+يحتوي ملف الاختبار هذا على أنواع متعددة من مخططات Mermaid، للتحقق من عمل تكامل Mermaid في ZEN بشكل صحيح.

package/.zen/src/ar-SA/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md

@@ -0,0 +1,70 @@
+---
+'title': 'ZEN - منشئ مواقع ثابتة بالماركداون والذكاء الاصطناعي بتصميم بسيط'
+'summary': 'ZEN هو منشئ مواقع ثابتة مدعوم بالذكاء الاصطناعي، يركز على تبسيط كتابة المستندات وعملية البناء. يسمح للمستخدمين بإنشاء مواقع HTML ثابتة باستخدام Markdown في مجلدات مُدارة بـ Git، دون حاجة لإعدادات معقدة، حيث يتم إخفاء جميع الإعدادات في دليل .zen. تشمل الميزات الأساسية: التنقل الذكي المُصنف (يولد خريطة الموقع عبر تحليل المحتوى بالذكاء الاصطناعي)، والترجمة التلقائية التدريجية (تدعم إصدارات متعددة اللغات، يمكن للمستخدمين الكتابة بلغتهم الأم، ويتولى الذكاء الاصطناعي الترجمة)، وتجربة كتابة بأقل قدر من الإزعاج. يعتمد الأداة على Node.js ومفتاح OpenAI API وGit، ويتم البناء عبر سطر الأوامر بسرعة، ويدعم معلمات لغوية محددة مثل zh-Hans وen-US.'
+'tags':
+  - 'منشئ مواقع ثابتة'
+  - 'ماركداون'
+  - 'ذكاء اصطناعي'
+  - 'ترجمة متعددة اللغات'
+  - 'تصميم بسيط'
+  - 'أدوات المستندات'
+  - 'ZEN'
+'inferred_lang': 'zh-Hans'
+---
+
+# ZEN - منشئ مواقع ثابتة بالماركداون والذكاء الاصطناعي بتصميم بسيط
+
+[> عرض تجريبي للموقع](https://zen.zccz14.com/)
+
+## الوظائف الأساسية
+
+1. 📃 **إنشاء موقع ثابت**: تحويل أي مجلد يحتوي على Markdown ويُدار بـ Git إلى موقع HTML ثابت.
+2. 🧭 **تنقل وتصنيف ذكي**: استخدام الذكاء الاصطناعي لتحليل المحتوى، وإنشاء خريطة موقع وتنقل، دون حساسية لموقع الملفات المصدر.
+3. 🌍 **ترجمة تلقائية تدريجية**: استخدام الذكاء الاصطناعي للترجمة التدريجية، مما يسمح للمستخدمين بكتابة Markdown بلغتهم الأم، مع إمكانية توفير المحتوى بلغات متعددة.
+
+لماذا تم إنشاء منشئ موقع ثابت آخر بـ Markdown؟ لقد فكرت مرة أخرى في كيفية خدمة أدوات المستندات للكتّاب بشكل أفضل في عصر الذكاء الاصطناعي:
+
+- العودة إلى المحتوى: تقليل الإزعاج إلى الحد الأدنى، والتركيز على الكتابة
+
+  إعادة المستندات إلى جوهرها، وإعادة الهدوء إلى الكتابة.
+
+  أولاً، لا أريد أن أكون أمين مكتبة. أحيانًا أريد كتابة بعض المحتوى، لكن قد لا أكون قد فكرت في عنوانه بعد، أو لم أقم بتنظيمه بشكل خاص. أتمنى أن يساعدني الذكاء الاصطناعي تلقائيًا في إنشاء العناوين، والملخصات، والتصنيف، والتنقل، وغيرها من أعمال التنظيم.
+
+  ثانيًا، يجب أن يكون مكتبي نظيفًا. لا أريد أدوات بناء معقدة الإعداد، ولا التعامل مع إعدادات مستندات معقدة، ولا أحب الهياكل المعقدة. كلما رأيت ملفات إعداد وهياكل مشاريع أدوات مثل Docusaurus وVuePress وAstro، أشعر بالصداع. الآن، اختار ZEN إخفاء جميع الإعدادات في دليل .zen، ودفعها إلى الزاوية، بحيث يحتاج المستخدم فقط إلى التركيز على كتابة المحتوى، ويتولى ZEN الباقي. جميع الأدلة الأخرى هي مساحة الكتابة الخاصة بك، يمكنك تنظيم ملفات Markdown الخاصة بك كما تشاء.
+
+- العودة إلى اللغة الأم: الكتابة باللغة الأم، وبناء إصدارات متعددة اللغات بسلاسة
+
+  الحياة قصيرة، وأنا كسول للترجمة. عندما يستخدم الشخص لغته الأم، يكون قادرًا على استغلال عمق تفكيره إلى أقصى حد. ولكن في نفس الوقت، من الضروري الحفاظ على الاتصال بالعالم، ولا أريد التخلي عن التواصل متعدد اللغات. لذلك، أتمنى أن تكون هناك أداة تسمح لي بالكتابة بلغتي الأم، وفي نفس الوقت تسمح للمزيد من الأشخاص برؤية محتواي. حاليًا، يتطلب i18n الترجمة الذاتية بالإضافة إلى الحفاظ على تحديث المحتوى، وهذا أمر مزعج للغاية. اخترت استخدام الذكاء الاصطناعي لمساعدتي في الترجمة، مما وفر علي الكثير من الوقت، ويمكن إكمال ترجمة لغات متعددة بنقرة واحدة.
+
+## البدء السريع
+
+المتطلبات المسبقة:
+
+- تثبيت [Node.js](https://nodejs.org/) (يُفضل الإصدار 18 أو أعلى، مع وجود أمر npx)
+- الحصول على [مفتاح OpenAI API](https://platform.openai.com/account/api-keys)، أو مفتاح API متوافق مع OPENAI
+- تثبيت Git (لإدراج ملفات Markdown من Git، وتجاهل الملفات التي تستبعدها قواعد .gitignore)
+
+أولاً، اعمل داخل مجلد مُدار بـ Git بالفعل:
+
+تكوين متغيرات البيئة
+
+```bash
+export OPENAI_API_KEY="sk-xxxxxx"  # إلزامي: استبدل بمفتاح OpenAI API الخاص بك
+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/ar-SA/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md

@@ -0,0 +1,71 @@
+---
+'title': 'ZEN - مُنشئ المواقع الثابتة البسيط باستخدام Markdown + الذكاء الاصطناعي'
+'summary': 'ZEN هو مُنشئ مواقع ثابتة مُدمج مع وظائف الذكاء الاصطناعي، مُصمم خصيصًا لمستندات Markdown. يسمح للمستخدمين بتحويل مجلد Git يحتوي على ملفات Markdown إلى موقع HTML ثابت، دون حاجة لإعدادات معقدة، حيث يتم إخفاء جميع الإعدادات في دليل .zen. تشمل الميزات الأساسية: التنقل الذكي المُصنف (باستخدام الذكاء الاصطناعي لتحليل المحتوى وإنشاء خريطة الموقع)، والترجمة التلقائية التدريجية (تدعم إصدارات متعددة اللغات، حيث يمكن للمستخدمين الكتابة بلغتهم الأم، ويتولى الذكاء الاصطناعي عملية الترجمة)، وتجربة كتابة بأقل قدر من الإزعاج. يتطلب دليل البدء السريع تثبيت Node.js، والحصول على مفتاح OpenAI API و Git، وبناء الموقع عبر سطر الأوامر، مع دعم تحديد اللغة وعنوان URL الأساسي.'
+'tags':
+  - 'مُنشئ المواقع الثابتة'
+  - 'Markdown'
+  - 'الذكاء الاصطناعي'
+  - 'ترجمة متعددة اللغات'
+  - 'البساطة'
+  - 'أداة توثيق'
+  - 'Git'
+'inferred_lang': 'zh-Hans'
+---
+
+# ZEN - مُنشئ المواقع الثابتة البسيط باستخدام Markdown + الذكاء الاصطناعي
+
+[> عرض تجريبي للموقع](https://zen.zccz14.com/)
+
+## الوظائف الأساسية
+
+1. 📃 **إنشاء موقع ثابت**: تحويل أي مجلد git يحتوي على Markdown إلى موقع HTML ثابت.
+2. 🧭 **تنقل ذكي مُصنف**: استخدام الذكاء الاصطناعي لتحليل المحتوى، وإنشاء خريطة موقع وتنقل، دون حساسية لموقع الملفات المصدر.
+3. 🌍 **ترجمة تلقائية تدريجية**: استخدام الذكاء الاصطناعي للترجمة التدريجية، مما يسمح للمستخدمين بكتابة Markdown بلغتهم الأم، مع إمكانية توفير المحتوى بلغات متعددة.
+
+لماذا قمت بإنشاء مُنشئ مواقع ثابت آخر باستخدام Markdown؟ لقد فكرت مرة أخرى في كيفية خدمة أدوات التوثيق للكتّاب بشكل أفضل في عصر الذكاء الاصطناعي:
+
+- العودة إلى المحتوى: تقليل الإزعاج إلى الحد الأدنى، والتركيز على الكتابة
+
+  إعادة التوثيق إلى جوهره، وإعادة الهدوء إلى الكتابة.
+
+  أولاً، لا أريد أن أكون أمين مكتبة. أحيانًا أريد كتابة بعض المحتوى، لكن قد لا أكون قد فكرت في عنوانه بعد، أو لم أقم بتنظيمه بشكل خاص. أتمنى أن يساعدني LLM تلقائيًا في إنشاء العناوين، والملخصات، والتصنيف، والتنقل، وأعمال التنظيم الأخرى.
+
+  ثانيًا، يجب أن يكون مكتبي نظيفًا. لا أريد أدوات بناء معقدة الإعداد، أو العبث بتكوينات توثيق معقدة، ولا أحب الهياكل المعقدة. كلما رأيت ملفات الإعداد وهياكل المشاريع لأدوات مثل Docusaurus و VuePress و Astro، أشعر بالصداع. الآن، اختار ZEN إخفاء جميع الإعدادات في دليل .zen، ودفعها إلى الزاوية، بحيث يحتاج المستخدم فقط إلى التركيز على محتوى الكتابة، ويتولى ZEN الباقي. جميع الدلائل الأخرى هي مساحة الكتابة الخاصة بك، يمكنك تنظيم ملفات Markdown الخاصة بك كما تشاء.
+
+- العودة إلى اللغة الأم: الكتابة باللغة الأم، وبناء إصدارات متعددة اللغات بسلاسة
+
+  الحياة قصيرة، وأنا كسول للترجمة. عندما يستخدم الإنسان لغته الأم، يكون قادرًا على استغلال عمق تفكيره إلى أقصى حد. ولكن في نفس الوقت، يعد التواصل مع العالم ضروريًا، ولا أريد التخلي عن التواصل متعدد اللغات. لذلك أتمنى أن تكون هناك أداة تسمح لي بالكتابة بلغتي الأم، وفي نفس الوقت تسمح للمزيد من الأشخاص برؤية محتواي. حاليًا، يتطلب i18n الترجمة الذاتية بالإضافة إلى الحفاظ على تحديث المحتوى، وهذا مزعج جدًا. اخترت استخدام LLM لمساعدتي في الترجمة، مما وفر علي الكثير من الوقت، ويمكن إكمال ترجمة لغات متعددة بنقرة واحدة.
+
+## البدء السريع
+
+المتطلبات المسبقة:
+
+- تثبيت [Node.js](https://nodejs.org/) (يُوصى بالإصدار 18 أو أعلى، مع ضرورة وجود أمر npx)
+- الحصول على [مفتاح OpenAI API](https://platform.openai.com/account/api-keys)، أو مفتاح API متوافق مع OPENAI
+- تثبيت Git (لاستخدامه في سرد ملفات Markdown من Git، وتجاهل الملفات التي تستبعدها قواعد .gitignore)
+
+أولاً، اعمل داخل مجلد تمت إدارته بواسطة git بالفعل:
+
+تكوين متغيرات البيئة
+
+```bash
+export OPENAI_API_KEY="sk-xxxxxx"  # إلزامي: يُرجى استبداله بمفتاح OpenAI API الخاص بك
+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`).
+- يمكن تحديد بادئة عنوان URL الأساسي للموقع من خلال معلمة `--base-url` (مثل اسم المستودع على GitHub Pages).
+- لا حاجة لتكوين اللغة المصدر، سيكتشف ZEN ذلك تلقائيًا.
+
+```bash
+npx zengen@latest build --lang zh-Hans --lang en-US
+```
+
+**عرض المزيد من المعلمات أو المساعدة**:
+
+```bash
+npx zengen@latest
+```

package/.zen/src/da-DK/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md

@@ -0,0 +1,121 @@
+---
+'title': 'Mermaid Diagram Testdokument'
+'summary': 'Dette dokument er en testfil, der bruges til at verificere Mermaid-diagramgengivelsesfunktionen i ZEN. Det indeholder eksempler på flere Mermaid-diagramtyper, såsom flowdiagrammer, sekvensdiagrammer, Gantt-diagrammer, klassediagrammer, tilstandsdiagrammer og lagkagediagrammer, og inkluderer en testsyntaks med fejl for at kontrollere visning af fejlmeddelelser. Dokumentet har til formål at demonstrere Mermaid-integrationens korrekte funktion i ZEN.'
+'tags':
+  - 'Mermaid'
+  - 'Diagramtest'
+  - 'ZEN'
+  - 'Flowdiagram'
+  - 'Sekvensdiagram'
+  - 'Gantt-diagram'
+  - 'Klassediagram'
+  - 'Tilstandsdiagram'
+'inferred_date': '2024-01-01'
+'inferred_lang': 'da-DK'
+---
+
+# Mermaid Diagram Test
+
+Dette er en testfil, der bruges til at verificere Mermaid-diagramgengivelsesfunktionen i ZEN.
+
+## Flowdiagram Eksempel
+
+```mermaid
+graph TD
+    A[Start] --> B{Skal det fortsættes?}
+    B -->|Ja| C[Udfør handling]
+    B -->|Nej| D[Afslut]
+    C --> E[Tjek resultat]
+    E --> F{Var det en succes?}
+    F -->|Ja| G[Fuldført]
+    F -->|Nej| H[Prøv igen]
+    H --> C
+    G --> D
+```
+
+## Sekvensdiagram Eksempel
+
+```mermaid
+sequenceDiagram
+    participant Bruger
+    participant System
+    participant Database
+
+    Bruger->>System: Indsend anmodning
+    System->>Database: Forespørg data
+    Database-->>System: Returner resultat
+    System-->>Bruger: Vis resultat
+```
+
+## Gantt-diagram Eksempel
+
+```mermaid
+gantt
+    title Projekt Tidsplan
+    dateFormat  YYYY-MM-DD
+    section Design
+    Kravanalyse     :done,    des1, 2024-01-01, 7d
+    Prototypedesign :active,  des2, 2024-01-08, 5d
+    Detaljeret design :         des3, after des2, 5d
+    section Udvikling
+    Frontend-udvikling     :         dev1, after des3, 10d
+    Backend-udvikling     :         dev2, after des3, 15d
+    section Test
+    Enhedstest     :         test1, after dev1, 5d
+    Integrationstest     :         test2, after dev2, 5d
+```
+
+## Klassediagram Eksempel
+
+```mermaid
+classDiagram
+    class Dyr {
+        +String navn
+        +int alder
+        +void spis()
+        +void sov()
+    }
+    class Hund {
+        +void gø()
+    }
+    class Kat {
+        +void mjav()
+    }
+
+    Dyr <|-- Hund
+    Dyr <|-- Kat
+```
+
+## Tilstandsdiagram Eksempel
+
+```mermaid
+stateDiagram-v2
+    [*] --> Inaktiv
+    Inaktiv --> Behandler : Start behandling
+    Behandler --> Succes : Behandling lykkedes
+    Behandler --> Fejl : Behandling mislykkedes
+    Succes --> [*]
+    Fejl --> [*]
+```
+
+## Lagkagediagram Eksempel
+
+```mermaid
+pie title Browserbrug
+    "Chrome" : 65.2
+    "Firefox" : 15.3
+    "Safari" : 12.5
+    "Edge" : 5.2
+    "Andre" : 1.8
+```
+
+## Fejl i Syntaks Test (skal vise fejlmeddelelse)
+
+```mermaid
+graph TD
+    A --> B
+    // Her mangler en pildedefinition
+    C --> D
+```
+
+Denne testfil indeholder flere Mermaid-diagramtyper, der bruges til at verificere, at ZENs Mermaid-integration fungerer korrekt.

package/.zen/src/da-DK/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md

@@ -0,0 +1,70 @@
+---
+'title': 'ZEN - Minimalistisk Markdown + AI statisk site-bygger'
+'summary': 'ZEN er en statisk site-generator kombineret med AI, der fokuserer på at forenkle dokumentationsskrivning og byggeprocessen. Den tillader brugere at oprette statiske HTML-sider i git-styrede mapper ved hjælp af Markdown, uden kompleks konfiguration – alle indstillinger er skjult i .zen-mappen. Kernefunktioner omfatter intelligent kategorinavigation (generering af sitemap via AI-analyse af indhold), automatisk inkrementel oversættelse (understøtter flersprogede versioner, hvor brugeren kan skrive på modersmål, og AI håndterer oversættelsen) samt en minimalt forstyrrende skriveoplevelse. Værktøjet kræver Node.js, OpenAI API-nøgle og Git, bygger hurtigt via kommandolinjen og understøtter angivelse af sprogparametre som zh-Hans og en-US.'
+'tags':
+  - 'Statisk site-generator'
+  - 'Markdown'
+  - 'AI'
+  - 'Flersproget oversættelse'
+  - 'Minimalisme'
+  - 'Dokumentationsværktøj'
+  - 'ZEN'
+'inferred_lang': 'zh-Hans'
+---
+
+# ZEN - Minimalistisk Markdown + AI statisk site-bygger
+
+[> Website Demo](https://zen.zccz14.com/)
+
+## Grundlæggende funktioner
+
+1. 📃 **Statisk site-generering**: Byg en hvilken som helst git-mappe indeholdende Markdown om til et statisk HTML-site.
+2. 🧭 **Intelligent kategorinavigation**: Brug AI til indholdsanalyse, generer sitemap og navigation – placeringen af kildefiler er ikke afgørende.
+3. 🌍 **Automatisk inkrementel oversættelse**: Brug AI til inkrementel oversættelse, så brugeren kan skrive Markdown på modersmål, mens sitet kan være flersproget.
+
+Hvorfor endnu en Markdown-statisk-site-generator? Jeg har genovervejet, hvordan dokumentationsværktøjer i AI-tiden bedre kan tjene forfattere:
+
+- Tilbage til indholdet: Minimal forstyrrelse, fokus på skrivning
+
+  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. Jeg ønsker, at LLM automatisk hjælper med at generere titler, lave resuméer, kategorisere, navigere og andre organisatoriske opgaver.
+
+  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, så brugeren kun skal fokusere på at skrive indhold – alt andet 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 problemfrit flersprogede versioner
+
+  Livet er for kort til at jeg gider oversætte. Man udnytter sin tankedybde 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å modersmål, samtidig med at flere mennesker 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, hvilket sparer mig for meget tid og gør det muligt at fuldføre flersproget oversættelse med et enkelt klik.
+
+## Hurtig start
+
+Forudsætninger:
+
+- [Node.js](https://nodejs.org/) installeret (anbefalet version 18 eller nyere, kræver npx-kommandoen)
+- [OpenAI API-nøgle](https://platform.openai.com/account/api-keys) erhvervet, eller en OPENAI-kompatibel API-nøgle
+- Git installeret (bruges til at liste Markdown-filer fra Git og ignorere filer filtreret af .gitignore-regler)
+
+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 som standard OpenAI's officielle API
+export OPENAI_MODEL="gpt-3.5-turbo"  # Valgfri, bruger som standard gpt-3.5-turbo-modellen
+```
+
+Byg sitet, understøtter flersproget oversættelse. Brug den aktuelle mappe som kildemappe, output til `.zen/dist`-mappen.
+
+- Du kan angive de ønskede sprogversioner ved gentagne gange at bruge `--lang`-parameteren (f.eks. `--lang zh-Hans --lang en-US`).
+- Kilde sprog behøver ikke konfigureres, ZEN detekterer det automatisk.
+
+```bash
+npx zengen@latest build --lang zh-Hans --lang en-US
+```
+
+**Se flere parametre eller hjælp**:
+
+```bash
+npx zengen@latest
+```

package/.zen/src/da-DK/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md

@@ -0,0 +1,71 @@
+---
+'title': 'ZEN - Minimalistisk Markdown + AI statisk site-generator'
+'summary': 'ZEN er en statisk site-generator med AI-funktioner, designet til Markdown-dokumenter. Den gør det muligt for brugere at konvertere en Git-mappe med Markdown-filer til et statisk HTML-site uden kompleks konfiguration – alle indstillinger er skjult i .zen-mappen. Kernesystemet inkluderer intelligent kategorinavigation (bruger AI til at analysere indhold og generere et sitemap), automatisk inkrementel oversættelse (understøtter flersprogede versioner, så brugere kan skrive på deres modersmål, mens AI håndterer oversættelsen) og en minimalt forstyrrende skriveoplevelse. Hurtig start-guiden kræver installation af Node.js, anskaffelse af en OpenAI API-nøgle og Git, og opbygning af sitet via kommandolinjen med mulighed for at angive sprog og basis-URL.'
+'tags':
+  - 'Statisk site-generator'
+  - 'Markdown'
+  - 'AI'
+  - 'Flersproget oversættelse'
+  - 'Minimalisme'
+  - 'Dokumentationsværktøj'
+  - 'Git'
+'inferred_lang': 'da-DK'
+---
+
+# ZEN - Minimalistisk Markdown + AI statisk site-generator
+
+[> Website Demo](https://zen.zccz14.com/)
+
+## Grundlæggende funktioner
+
+1. 📃 **Statisk site-generering**: Byg en hvilken som helst git-mappe med Markdown-filer om til et statisk HTML-site.
+2. 🧭 **Intelligent kategorinavigation**: Brug AI til at analysere indhold, generere sitemap og navigation – uafhængigt af kildefilernes placering.
+3. 🌍 **Automatisk inkrementel oversættelse**: Brug AI til inkrementel oversættelse, så brugerne kan skrive Markdown på deres modersmål, mens sitet kan være flersproget.
+
+Hvorfor endnu en Markdown statisk site-generator? Jeg har genovervejet, hvordan dokumentationsværktøjer i AI-tiden bedre kan tjene forfattere:
+
+- Tilbage til indholdet: Minimal forstyrrelse, fokus på skrivning
+
+  Lad dokumentationen vende tilbage til essensen, og lad skriveprocessen være fredfyldt.
+
+  For det første ønsker jeg ikke at 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 godt. Jeg håber, at LLM automatisk vil hjælpe med at generere titler, lave resuméer, kategorisere og oprette navigation.
+
+  For det andet skal mit skriveværelse være rent og ryddeligt. Jeg vil ikke konfigurere komplekse byggeværktøjer, rode med indviklede dokumentationsopsætninger eller have komplekse 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 – gemt væk i et hjørne. Brugeren skal kun fokusere på at skrive indhold; alt andet håndteres af ZEN. Alle andre mapper er din skriveplads, hvor du frit kan organisere dine Markdown-filer.
+
+- Tilbage til modersmålet: Skriv på modersmål, opbyg 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 flere mennesker kan se mit indhold. Nuværende i18n-løsninger 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, hvilket sparer mig for meget tid og gør det muligt at få flersprogede versioner med et enkelt klik.
+
+## Hurtig start
+
+Forudsætninger:
+
+- [Node.js](https://nodejs.org/) installeret (anbefales version 18 eller nyere, skal have npx-kommandoen)
+- [OpenAI API-nøgle](https://platform.openai.com/account/api-keys) anskaffet, eller en OPENAI-kompatibel API-nøgle
+- Git installeret (bruges til at liste Markdown-filer fra Git og ignorere filer filtreret af .gitignore-regler)
+
+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 standard OpenAI API som standard
+export OPENAI_MODEL="gpt-3.5-turbo"  # Valgfri, bruger gpt-3.5-turbo-modellen som standard
+```
+
+Byg sitet med understøttelse af flersproget oversættelse. Brug den aktuelle mappe som kildemappe og output til `.zen/dist`-mappen.
+
+- Du kan angive de ønskede sprogversioner ved gentagne gange at bruge `--lang`-parameteren (f.eks. `--lang da-DK --lang en-US`).
+- Du kan angive sitets basis-URL-præfiks med `--base-url`-parameteren (f.eks. dit repositorienavn på GitHub Pages).
+- Kilde sprog behøver ikke konfigureres; ZEN registrerer det automatisk.
+
+```bash
+npx zengen@latest build --lang da-DK --lang en-US
+```
+
+**Se flere parametre eller få hjælp**:
+
+```bash
+npx zengen@latest
+```