zengen 0.2.1 → 0.2.3

package/.github/workflows/pages.yml

@@ -3,7 +3,7 @@ name: Deploy to GitHub Pages
 on:
   push:
     branches: [main]
-  workflow_dispatch:  # 允许手动触发
+  workflow_dispatch: # 允许手动触发
 
 # 设置 GITHUB_TOKEN 的权限以允许部署到 GitHub Pages
 permissions:
@@ -13,7 +13,7 @@ permissions:
 
 # 只允许一个并发部署，跳过正在运行的队列
 concurrency:
-  group: "pages"
+  group: 'pages'
   cancel-in-progress: false
 
 jobs:
@@ -33,9 +33,12 @@ jobs:
           node-version: '24.x'
           cache: 'npm'
 
+      - name: Install dependencies
+        run: npm install
+
       - name: Create documentation site
         run: |
-          npx zengen@latest build --base-url /ZEN --lang zh-Hans --lang en-US
+          npm run build:doc
 
       - name: Setup Pages
         uses: actions/configure-pages@v4
@@ -55,4 +58,4 @@ jobs:
     steps:
       - name: Deploy to GitHub Pages
         id: deployment
-        uses: actions/deploy-pages@v4
+        uses: actions/deploy-pages@v4

package/.zen/meta.json

@@ -2,134 +2,56 @@
   "version": "1.0.0",
   "options": {
     "verbose": true,
-    "langs": ["zh-Hans", "en-US"]
+    "langs": [
+      "zh-Hans",
+      "en-US",
+      "ja-JP",
+      "ko-KR",
+      "es-ES",
+      "fr-FR",
+      "de-DE",
+      "ru-RU",
+      "pt-PT",
+      "it-IT",
+      "nl-NL",
+      "pl-PL",
+      "sv-SE",
+      "fi-FI",
+      "da-DK",
+      "no-NO",
+      "zh-Hant",
+      "hi-IN",
+      "ar-SA",
+      "th-TH",
+      "vi-VN",
+      "id-ID",
+      "pt-BR",
+      "es-MX",
+      "tr-TR",
+      "uk-UA"
+    ]
   },
   "files": [
     {
-      "hash": "1b798c44a4f353e47296ca83d5905e37e6aba3e90bbd9bc3b3d34fc12059a2ca",
+      "hash": "74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805",
       "path": "README.md",
       "metadata": {
-        "title": "ZEN - Markdown 文档站点构建工具",
-        "summary": "ZEN 是一个极简的静态站点生成工具，专注于将 Markdown 文件夹构建为 HTML 站点，支持智能导航和 AI 驱动的增量翻译，强调内容优先和跨语言支持，无需复杂配置。",
-        "tags": ["Markdown", "静态站点生成", "AI 翻译", "极简主义", "多语言", "文档工具", "ZEN"],
-        "inferred_lang": "zh-Hans",
-        "tokens_used": {
-          "prompt": 650,
-          "completion": 124,
-          "total": 774
-        }
-      }
-    },
-    {
-      "hash": "5ec990146b35e00de2630559126ee07f7cdcddeb23b0e8cab3d85b4181353e26",
-      "path": "docs/advanced-usage.md",
-      "metadata": {
-        "title": "ZEN 高级用法指南",
-        "summary": "本文档介绍了 ZEN 的高级功能，包括自定义 HTML 模板、配置选项（如源目录、输出目录、模板、基础 URL 和多语言支持）以及插件系统，帮助用户扩展和定制 ZEN 工具。",
-        "tags": ["ZEN", "高级用法", "自定义模板", "配置选项", "插件系统", "文档生成", "多语言支持"],
-        "inferred_lang": "zh-Hans",
-        "tokens_used": {
-          "prompt": 464,
-          "completion": 120,
-          "total": 584
-        }
-      }
-    },
-    {
-      "hash": "01d04f7c17b4a541ead9d759d877b30b403e15b849182a49eb1f62bd29ecd18c",
-      "path": "docs/deployment/github-pages.md",
-      "metadata": {
-        "title": "GitHub Pages 部署配置",
-        "summary": "本文档介绍了 ZEN 项目文档站点的 GitHub Pages 部署配置，包括工作流程、触发条件、构建步骤、自定义配置、故障排除和手动触发方法。",
-        "tags": ["GitHub Pages", "部署配置", "工作流程", "文档构建", "故障排除", "ZEN 项目"],
-        "inferred_lang": "zh-Hans",
-        "tokens_used": {
-          "prompt": 1091,
-          "completion": 106,
-          "total": 1197
-        }
-      }
-    },
-    {
-      "hash": "f0c2799126931ccd113a0c45b1e623870b0d4f4f400becf6dd877da8f1011517",
-      "path": "docs/getting-started.md",
-      "metadata": {
-        "title": "快速开始指南",
-        "summary": "本文档介绍如何快速开始使用 ZEN 文档生成器，包括安装步骤、基本用法和主要特性。",
-        "tags": ["ZEN 文档生成器", "快速开始", "安装", "基本用法", "特性", "Markdown", "构建命令"],
-        "inferred_lang": "zh-Hans",
-        "tokens_used": {
-          "prompt": 373,
-          "completion": 94,
-          "total": 467
-        }
-      }
-    },
-    {
-      "hash": "1e96be58d76c60056b708eb5bd8b8b81d7b5845d9cfe0b879d85068a5f11df3a",
-      "path": "docs/guides/best-practices.md",
-      "metadata": {
-        "title": "ZEN 文档站点最佳实践",
-        "summary": "本文档介绍了使用 ZEN 构建文档站点的最佳实践，涵盖多语言管理、性能优化、部署策略、维护建议、常见问题解决方案和高级技巧，旨在帮助用户高效开发和维护文档。",
-        "tags": ["ZEN", "文档站点", "最佳实践", "性能优化", "部署策略", "多语言管理", "维护建议"],
-        "inferred_lang": "zh-Hans",
-        "tokens_used": {
-          "prompt": 1282,
-          "completion": 116,
-          "total": 1398
-        }
-      }
-    },
-    {
-      "hash": "80ae9bed74fc6348a7c1fe9f33e86b65f5d919169721f77bcf0e1bc29fbdb4f9",
-      "path": "docs/guides/config.md",
-      "metadata": {
-        "title": "ZEN 配置指南",
-        "summary": "本文档介绍了 ZEN 工具的配置和使用方法，包括基本命令如构建文档、实时预览和启动开发服务器，以及命令行选项如 --watch、--serve 和 --port 的详细说明。",
-        "tags": ["ZEN", "配置指南", "命令行", "文档构建", "开发服务器", "极简主义"],
-        "inferred_lang": "zh-Hans",
-        "tokens_used": {
-          "prompt": 669,
-          "completion": 109,
-          "total": 778
-        }
-      }
-    },
-    {
-      "hash": "fdfca9b960d0eaa8b2b96fe988ead7481d2c0b16f66ebc94fb477139b4178cdc",
-      "path": "docs/guides/index.md",
-      "metadata": {
-        "title": "ZEN 文档站点示例",
-        "summary": "介绍 ZEN 文档构建工具，一个极简主义的 Markdown 文档站点生成器，包括特性、快速开始指南、代码示例和下一步学习资源。",
+        "title": "ZEN - 极简主义 Markdown + AI 静态站点构建器",
+        "summary": "ZEN 是一个结合 AI 的静态站点生成器，支持智能分类导航和自动增量翻译，让用户专注于用母语写作，简化配置和构建过程。",
         "tags": [
-          "ZEN",
-          "文档构建工具",
+          "静态站点生成器",
           "Markdown",
-          "站点生成器",
-          "快速开始",
-          "代码示例",
-          "多语言支持"
+          "AI",
+          "多语言翻译",
+          "极简主义",
+          "文档工具",
+          "Node.js"
         ],
         "inferred_lang": "zh-Hans",
         "tokens_used": {
-          "prompt": 567,
-          "completion": 108,
-          "total": 675
-        }
-      }
-    },
-    {
-      "hash": "6124ea88edec5bde737b26b21f71ecfeffe4e73151784856edf813ee231a4baa",
-      "path": "docs/testing/test-document.md",
-      "metadata": {
-        "title": "Test Document",
-        "summary": "这是一个测试文档，内容为空，仅包含标题。",
-        "tags": ["测试", "文档", "示例"],
-        "inferred_lang": "en-US",
-        "tokens_used": {
-          "prompt": 265,
-          "completion": 58,
-          "total": 323
+          "prompt": 1038,
+          "completion": 120,
+          "total": 1158
         }
       }
     }

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

@@ -0,0 +1,71 @@
+---
+title: ZEN - منشئ مواقع ثابتة بالحد الأدنى من Markdown + الذكاء الاصطناعي
+summary: ZEN هو منشئ مواقع ثابتة مدمج مع الذكاء الاصطناعي، يدعم التنقل الذكي التلقائي والترجمة التزايدية الآلية، مما يمكن المستخدم من التركيز على الكتابة بلغته الأم، وتبسيط عمليات التكوين والبناء.
+tags:
+  - منشئ مواقع ثابتة
+  - Markdown
+  - الذكاء الاصطناعي
+  - ترجمة متعددة اللغات
+  - الحد الأدنى
+  - أدوات التوثيق
+  - Node.js
+inferred_lang: ar-SA
+---
+
+# ZEN - منشئ مواقع ثابتة بالحد الأدنى من Markdown + الذكاء الاصطناعي
+
+[> عرض موقع الويب التجريبي](https://zccz14.github.io/ZEN/)
+
+## الوظائف الأساسية
+
+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 Key](https://platform.openai.com/account/api-keys)، أو OPENAI API Key متوافق
+- تم تثبيت Git (لإدراج ملفات Markdown من Git، وتجاهل الملفات التي تمت تصفيتها بواسطة قواعد .gitignore)
+
+أولاً، اعمل داخل مجلد تمت إدارته بواسطة git بالفعل:
+
+تكوين متغيرات البيئة
+
+```bash
+export OPENAI_API_KEY="sk-xxxxxx"  # مطلوب: يرجى استبداله بـ OpenAI API Key الخاص بك
+export OPENAI_BASE_URL="https://api.openai.com/v1"  # اختياري، يستخدم OpenAI API الرسمي افتراضيًا
+export OPENAI_MODEL="gpt-3.5-turbo"  # اختياري، يستخدم نموذج gpt-3.5-turbo افتراضيًا
+```
+
+بناء الموقع، مع دعم الترجمة متعددة اللغات. استخدم المجلد الحالي كمجلد مصدر، والإخراج إلى مجلد `.zen/dist`.
+
+- يمكن تحديد إصدارات اللغة المطلوب إنشاؤها باستخدام معلمة `--lang` عدة مرات (على سبيل المثال `--lang ar-SA --lang en-US`).
+- يمكن تحديد بادئة عنوان URL الأساسي للموقع باستخدام معلمة `--base-url` (على سبيل المثال اسم المستودع على GitHub Pages).
+- لا حاجة لتكوين لغة المصدر، سيكتشف ZEN تلقائيًا.
+
+```bash
+npx zengen@latest build --lang ar-SA --lang en-US
+```
+
+**عرض المزيد من المعلمات أو المساعدة**:
+
+```bash
+npx zengen@latest
+```

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

@@ -0,0 +1,71 @@
+---
+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
+---
+
+# ZEN - Minimalistisk Markdown + AI statisk site-generator
+
+[> Website Demo](https://zccz14.github.io/ZEN/)
+
+## 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.
+
+Hvorfor endnu en Markdown statisk site-generator? Jeg har genovervejet, hvordan dokumentationsværktøjer i AI-tidsalderen bedre kan tjene forfattere:
+
+- Tilbage til indholdet: Minimér forstyrrelser, fokuser på skrivningen
+
+  Lad dokumentationen vende tilbage til essensen, lad skrivningen vende tilbage til roen.
+
+  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 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.
+
+- 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.
+
+## 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)
+
+Først, arbejd i en mappe, der allerede er styret 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_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.
+
+- 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).
+- 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**:
+
+```bash
+npx zengen@latest
+```

package/.zen/src/de-DE/04319611d7cde718d0e82da8e034e04b15fb3bb37c3784d8f7313577c5178b06.md

@@ -0,0 +1,73 @@
+---
+title: ZEN - Markdown-Dokumentationsseiten-Generator
+summary: ZEN ist ein minimalistisches Tool zur Generierung statischer Seiten aus Markdown, das sich auf das Schreiben von Inhalten konzentriert. Es nutzt KI für Übersetzungen und Navigation, unterstützt den Aufbau mehrsprachiger Seiten und kommt ohne komplexe Konfiguration aus.
+tags:
+  - Markdown
+  - Static Site Generator
+  - KI-Übersetzung
+  - Mehrsprachig
+  - Minimalismus
+  - Dokumentationstool
+  - ZEN
+inferred_lang: de-DE
+---
+
+# ZEN - Ein schlankes Tool zum Erstellen von Markdown-Dokumentationsseiten
+
+[简体中文](https://zccz14.github.io/ZEN/zh-Hans) | [English](https://zccz14.github.io/ZEN/en-US)
+
+Warum noch ein Markdown-Static-Site-Generator? Ich habe überlegt, wie Dokumentationstools im KI-Zeitalter Autoren besser dienen können:
+
+- **Zurück zum Inhalt**: Minimale Ablenkung, Fokus auf das Schreiben
+
+  Lasst die Dokumentation wieder das Wesentliche sein und das Schreiben wieder ruhig.
+
+  Erstens: Ich möchte kein Bibliothekar sein. Manchmal möchte ich etwas aufschreiben, habe aber vielleicht noch keinen Titel oder eine klare Struktur. Ich wünsche mir, dass eine LLM automatisch Titel generiert, Zusammenfassungen erstellt, kategorisiert und Navigation erstellt – also die organisatorische Arbeit übernimmt.
+
+  Zweitens: Mein Arbeitsbereich muss aufgeräumt sein. Ich möchte keine komplexen Build-Tools konfigurieren, mich nicht mit komplizierten Dokumenteneinstellungen herumschlagen und keine komplexen Strukturen. Jedes Mal, wenn ich die Konfigurationsdateien und Projektstrukturen von Tools wie Docusaurus, VuePress oder Astro sehe, bekomme ich Kopfschmerzen. ZEN versteckt daher alle Konfigurationen im `.zen`-Verzeichnis – weg in die Ecke. Der Nutzer konzentriert sich nur 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, mehrsprachige Versionen mühelos erstellen
+
+  Das Leben ist zu kurz für Übersetzungen. Man denkt am tiefsten in der Muttersprache. Gleichzeitig ist die Verbindung zur Welt wichtig, ich möchte den mehrsprachigen Austausch nicht aufgeben. Daher wünsche ich mir ein Tool, mit dem ich in meiner Muttersprache schreiben kann, aber dennoch viele Menschen meine Inhalte sehen können. Aktuelle i18n-Lösungen erfordern nicht nur eigene Übersetzungen, sondern auch die Pflege von Aktualisierungen – zu aufwändig. Ich nutze eine LLM für Übersetzungen, das spart viel Zeit und ermöglicht Übersetzungen in viele Sprachen mit einem Klick.
+
+## Grundlegende Funktionen
+
+1.  **Generierung statischer Seiten**
+    - Erstellt aus einem beliebigen Ordner mit Markdown-Dateien eine statische HTML-Website.
+
+2.  **Intelligente Navigation**
+    - Erzeugt eine Sitemap und Navigation. Die ursprüngliche Verzeichnisstruktur der Markdown-Quelldateien muss nicht beibehalten werden; Dateien können frei verschoben werden.
+
+3.  **Inkrementelle i18n-Übersetzung**
+    - Nutzt LLM für inkrementelle i18n-Übersetzungen. Der Nutzer schreibt Markdown in seiner Muttersprache, kann aber mehrsprachige Inhalte bereitstellen.
+
+## Designphilosophie
+
+- **Minimalismus**: Minimale Konfiguration, maximale Flexibilität.
+- **Inhaltsfokus**: Konzentration auf das Schreiben, nicht auf die Tool-Konfiguration.
+- **KI-gestützt**: Nutzt KI für Übersetzungen und Inhaltsorganisation.
+- **Mehrsprachig**: Unterstützt die Erstellung und Darstellung mehrsprachiger Inhalte.
+
+## Schnellstart
+
+### Empfohlene Verwendung
+
+**Es wird empfohlen, in das Verzeichnis mit den Markdown-Dateien zu wechseln und direkt mit dem folgenden Befehl zu beginnen:**
+
+```bash
+# Umgebungsvariablen setzen (entsprechend Ihrer Umgebung anpassen)
+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_MODEL="gpt-3.5-turbo"  # Optional, standardmäßig wird das gpt-3.5-turbo Modell verwendet
+
+# Website bauen, mit Unterstützung für mehrsprachige Übersetzungen
+npx zengen@latest build --lang zh-Hans --lang en-US --verbose
+```
+
+**Weitere Parameter oder Hilfe anzeigen**:
+
+```bash
+npx zengen
+```
+
+**Hinweis**: ZEN erzwingt die Verwendung des aktuellen Verzeichnisses als Quellverzeichnis. Die Ausgabe erfolgt ins Verzeichnis `.zen/dist`. Das Angeben von Quell- und Ausgabeverzeichnissen als Parameter wird nicht unterstützt.

package/.zen/src/de-DE/48eb2ad3e174cd06ed16c959fa58e0381dbc4a4147fa3456b21eea2b3d67c329.md

@@ -0,0 +1,81 @@
+---
+title: ZEN - Markdown-Dokumentationsseiten-Generator
+summary: ZEN ist ein minimalistisches, statisches Site-Generierungstool für Markdown, das Inhalte priorisiert und Minimalismus betont. Es nutzt KI für intelligente Navigation und mehrsprachige Übersetzung, um Nutzern zu helfen, sich auf das Schreiben zu konzentrieren, ohne komplexe Konfigurationen.
+tags:
+  - Markdown
+  - Statische Site-Generierung
+  - KI-Übersetzung
+  - Mehrsprachig
+  - Minimalismus
+  - Dokumentationstool
+  - ZEN
+inferred_lang: de-DE
+---
+
+# ZEN - Minimalistisches Markdown-Dokumentationsseiten-Tool
+
+[简体中文](https://zccz14.github.io/ZEN/zh-Hans) |
+[English](https://zccz14.github.io/ZEN/en-US) |
+[Español](https://zccz14.github.io/ZEN/es-ES) |
+[Português](https://zccz14.github.io/ZEN/pt-PT) |
+[Русский](https://zccz14.github.io/ZEN/ru-RU) |
+[Français](https://zccz14.github.io/ZEN/fr-FR) |
+[日本語](https://zccz14.github.io/ZEN/ja-JP) |
+[한국어](https://zccz14.github.io/ZEN/ko-KR) |
+[Deutsch](https://zccz14.github.io/ZEN/de-DE) |
+
+Warum noch ein statischer Markdown-Site-Generator? Ich habe überlegt, wie Dokumentationstools im KI-Zeitalter Autoren besser dienen können:
+
+- **Zurück zu den Inhalten**: 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, aber vielleicht habe ich noch keinen Titel dafür oder es ist noch nicht besonders organisiert. Ich wünsche mir, dass eine LLM automatisch Titel generiert, Zusammenfassungen erstellt, kategorisiert, Navigation erstellt und andere organisatorische Aufgaben übernimmt.
+
+  Zweitens: Mein Arbeitszimmer muss aufgeräumt sein. Ich möchte keine komplexen Build-Tools konfigurieren, mich nicht mit komplizierten Dokumenteneinstellungen herumschlagen und keine komplexen Strukturen. Jedes Mal, wenn ich die Konfigurationsdateien und Projektstrukturen von Tools wie Docusaurus, VuePress oder Astro sehe, bekomme ich Kopfschmerzen. Jetzt versteckt ZEN alle Konfigurationen im `.zen`-Verzeichnis, schiebt sie in die Ecke. Der Nutzer muss sich nur auf den Inhalt konzentrieren, den Rest erledigt ZEN. Alle anderen Verzeichnisse sind Ihr Schreibbereich, Sie können Ihre Markdown-Dateien beliebig organisieren.
+
+- **Zurück zur Muttersprache**: In der Muttersprache schreiben, nahtlos mehrsprachige Versionen erstellen
+
+  Das Leben ist kurz, ich bin zu faul zum Übersetzen. Man denkt am tiefsten in seiner Muttersprache. Gleichzeitig ist es notwendig, mit der Welt verbunden zu bleiben, ich möchte den mehrsprachigen Austausch nicht aufgeben. Daher wünsche ich mir ein Tool, mit dem ich in meiner Muttersprache schreiben kann, aber gleichzeitig mehr Menschen meine Inhalte zugänglich machen kann. Aktuelle i18n-Lösungen erfordern nicht nur eigene Übersetzungen, sondern auch die Pflege von Inhaltsaktualisierungen – das ist zu umständlich. Ich nutze LLMs für Übersetzungen, das spart mir viel Zeit und mehrsprachige Übersetzungen sind mit einem Klick erledigt.
+
+## Grundlegende Funktionen
+
+1. **Statische Site-Generierung**
+   - Erstellt aus einem beliebigen Ordner mit Markdown-Dateien eine statische HTML-Website.
+
+2. **Intelligente Navigation**
+   - Generiert eine Sitemap und Navigation. Die ursprüngliche Verzeichnisstruktur der Markdown-Quelldateien muss nicht beibehalten werden, Quelldateien können beliebig verschoben werden.
+
+3. **Inkrementelle i18n-Übersetzung**
+   - Nutzt LLMs für inkrementelle i18n-Übersetzungen. Nutzer schreiben Markdown in ihrer Muttersprache, können aber mehrsprachige Inhalte bereitstellen.
+
+## Designphilosophie
+
+- **Minimalismus**: Minimale Konfiguration, maximale Flexibilität.
+- **Inhalte zuerst**: Fokus auf das Schreiben, nicht auf Tool-Konfiguration.
+- **KI-gestützt**: Nutzt KI für Übersetzung und Inhaltsorganisation.
+- **Mehrsprachig**: Unterstützt mehrsprachige Inhaltserstellung und -darstellung.
+
+## Schnellstart
+
+### Empfohlene Verwendung
+
+**Es wird empfohlen, in das Verzeichnis mit den Markdown-Dateien zu wechseln und direkt mit dem folgenden Befehl mit dem Build zu beginnen:**
+
+```bash
+# Umgebungsvariablen setzen (an Ihre Situation anpassen)
+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_MODEL="gpt-3.5-turbo"  # Optional, standardmäßig wird das gpt-3.5-turbo-Modell verwendet
+
+# Site bauen, mit mehrsprachiger Übersetzungsunterstützung
+npx zengen@latest build --lang zh-Hans --lang en-US --verbose
+```
+
+**Weitere Parameter oder Hilfe anzeigen**:
+
+```bash
+npx zengen
+```
+
+**Hinweis**: ZEN erzwingt die Verwendung des aktuellen Verzeichnisses als Quellverzeichnis und gibt die Dateien im Verzeichnis `.zen/dist` aus. Das Angeben von Quell- und Ausgabeverzeichnissen als Parameter wird nicht unterstützt.

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

@@ -0,0 +1,71 @@
+---
+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
+---
+
+# ZEN - Minimalistischer Markdown + AI Static Site Builder
+
+[> Website Demo](https://zccz14.github.io/ZEN/)
+
+## Grundlegende Funktionen
+
+1.  📃 **Statische Site-Generierung**: Erstellt aus einem beliebigen Git-Ordner mit Markdown-Dateien eine statische HTML-Website.
+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.
+
+Warum noch ein weiterer Markdown Static Site Generator? Ich habe überlegt, wie Dokumentationstools im KI-Zeitalter Autoren 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.
+
+  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.
+
+- 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.
+
+## 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)
+
+Arbeiten Sie zunächst in einem von Git verwalteten Ordner:
+
+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_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.
+
+- 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 Quellsprache muss nicht konfiguriert werden, ZEN erkennt sie automatisch.
+
+```bash
+npx zengen@latest build --lang de-DE --lang en-US
+```
+
+**Weitere Parameter oder Hilfe anzeigen**:
+
+```bash
+npx zengen@latest
+```