zengen 0.2.2 → 0.2.4

package/.github/workflows/pages.yml

@@ -33,6 +33,9 @@ jobs:
           node-version: '24.x'
           cache: 'npm'
 
+      - name: Install dependencies
+        run: npm install
+
       - name: Create documentation site
         run: |
           npm run build:doc

package/.zen/meta.json

@@ -2,23 +2,63 @@
   "version": "1.0.0",
   "options": {
     "verbose": true,
-    "langs": ["zh-Hans", "en-US", "es-ES", "pt-PT", "ja-JP", "de-DE", "fr-FR", "ru-RU", "ko-KR"]
+    "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": "48eb2ad3e174cd06ed16c959fa58e0381dbc4a4147fa3456b21eea2b3d67c329",
+      "hash": "74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805",
       "path": "README.md",
       "metadata": {
-        "title": "ZEN - Markdown 文档站点构建工具",
-        "summary": "ZEN 是一个简洁的 Markdown 静态站点生成工具，强调内容优先和极简主义，利用 AI 实现智能导航和多语言翻译，帮助用户专注于写作而无需复杂配置。",
-        "tags": ["Markdown", "静态站点生成", "AI 翻译", "多语言", "极简主义", "文档工具", "ZEN"],
+        "title": "ZEN - 极简主义 Markdown + AI 静态站点构建器",
+        "summary": "ZEN 是一个结合 AI 的静态站点生成器，支持智能分类导航和自动增量翻译，让用户专注于用母语写作，简化配置和构建过程。",
+        "tags": [
+          "静态站点生成器",
+          "Markdown",
+          "AI",
+          "多语言翻译",
+          "极简主义",
+          "文档工具",
+          "Node.js"
+        ],
         "inferred_lang": "zh-Hans",
         "tokens_used": {
-          "prompt": 1150,
-          "completion": 119,
-          "total": 1269
+          "prompt": 1038,
+          "completion": 120,
+          "total": 1158
         }
-      }
+      },
+      "links": [
+        "https://zccz14.github.io/ZEN/",
+        "https://nodejs.org/",
+        "https://platform.openai.com/account/api-keys"
+      ]
     }
   ]
 }

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/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
+```

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

@@ -0,0 +1,71 @@
+---
+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
+---
+
+# ZEN - 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.
+
+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.
+
+  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.
+
+  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.
+
+- **Return to Native Language: Write in Your Mother Tongue, Build Multilingual Versions Smoothly**
+
+  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.
+
+## 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)
+
+First, work within a folder already managed by Git:
+
+Set environment variables:
+
+```bash
+export OPENAI_API_KEY="sk-xxxxxx"  # Required: Replace with your OpenAI API Key
+export OPENAI_BASE_URL="https://api.openai.com/v1"  # Optional, defaults to the official OpenAI API
+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.
+
+- 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.
+
+```bash
+npx zengen@latest build --lang zh-Hans --lang en-US
+```
+
+**View more parameters or help**:
+
+```bash
+npx zengen@latest
+```

package/.zen/src/es-ES/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md

@@ -0,0 +1,71 @@
+---
+title: ZEN - Generador de Sitios Estáticos Minimalista con Markdown + IA
+summary: ZEN es un generador de sitios estáticos con IA, que admite navegación por categorías inteligente y traducción incremental automática, permitiendo a los usuarios centrarse en escribir en su lengua materna y simplificando el proceso de configuración y construcción.
+tags:
+  - Generador de Sitios Estáticos
+  - Markdown
+  - IA
+  - Traducción Multilingüe
+  - Minimalismo
+  - Herramientas de Documentación
+  - Node.js
+inferred_lang: es-ES
+---
+
+# ZEN - Generador de Sitios Estáticos Minimalista con Markdown + IA
+
+[> Demostración del Sitio Web](https://zccz14.github.io/ZEN/)
+
+## Funcionalidades Básicas
+
+1.  📃 **Generación de Sitios Estáticos**: Construye un sitio HTML estático a partir de cualquier carpeta git que contenga archivos Markdown.
+2.  🧭 **Navegación por Categorías Inteligente**: Utiliza IA para analizar el contenido, generando un mapa del sitio y navegación, independientemente de la ubicación de los archivos fuente.
+3.  🌍 **Traducción Incremental Automática**: Utiliza IA para realizar traducciones incrementales, permitiendo a los usuarios escribir Markdown en su lengua materna, pero siendo multilingües.
+
+¿Por qué crear otro generador de sitios estáticos con Markdown? He reflexionado sobre cómo las herramientas de documentación pueden servir mejor a los escritores en la era de la IA:
+
+- **Regreso al Contenido**: Minimizar las distracciones, centrarse en escribir.
+
+  Devolver la documentación a su esencia, devolver la escritura a la tranquilidad.
+
+  Primero, no quiero ser un bibliotecario. A veces quiero escribir algo, pero quizás aún no he pensado en su título o no lo he organizado de manera específica. Quiero que un LLM me ayude automáticamente generando títulos, resúmenes, categorías, navegación y otras tareas de organización.
+
+  Segundo, mi estudio debe estar ordenado. No quiero herramientas de construcción con configuraciones complejas, ni lidiar con configuraciones de documentos complicadas, ni estructuras complejas. Cada vez que veo los archivos de configuración y estructuras de proyectos de herramientas como Docusaurus, VuePress o Astro, me duele la cabeza. Ahora, ZEN opta por ocultar toda la configuración en el directorio `.zen`, barriéndola bajo la alfombra. El usuario solo necesita centrarse en escribir el contenido; ZEN se encarga del resto. Todos los demás directorios son su espacio de escritura, puede organizar sus archivos Markdown como desee.
+
+- **Regreso a la Lengua Materna**: Escribir en la lengua materna, construir versiones multilingües sin esfuerzo.
+
+  La vida es corta, no tengo ganas de traducir. Uno expresa mejor su profundidad de pensamiento cuando usa su lengua materna. Pero al mismo tiempo, es necesario mantenerse conectado con el mundo; no quiero renunciar a la comunicación multilingüe. Por eso, deseo una herramienta que me permita escribir en mi lengua materna y, a la vez, hacer que más personas vean mi contenido. Los sistemas i18n actuales no solo requieren que uno traduzca, sino que también mantenga las actualizaciones del contenido, lo cual es muy tedioso. Elijo usar LLM para ayudarme con la traducción, ahorrándome mucho tiempo y permitiéndome completar traducciones a múltiples idiomas con un solo clic.
+
+## Comenzar Rápidamente
+
+Requisitos previos:
+
+- Tener instalado [Node.js](https://nodejs.org/) (se recomienda versión 18 o superior, debe incluir el comando `npx`)
+- Haber obtenido una [Clave API de OpenAI](https://platform.openai.com/account/api-keys), o una clave API compatible con OpenAI.
+- Tener instalado Git (para listar archivos Markdown desde un repositorio Git, ignorando los archivos filtrados por las reglas de `.gitignore`).
+
+Primero, trabaje en una carpeta que ya esté gestionada por Git:
+
+Configure las variables de entorno:
+
+```bash
+export OPENAI_API_KEY="sk-xxxxxx"  # Obligatorio: Reemplazar con su Clave API de OpenAI
+export OPENAI_BASE_URL="https://api.openai.com/v1"  # Opcional, por defecto usa la API oficial de OpenAI
+export OPENAI_MODEL="gpt-3.5-turbo"  # Opcional, por defecto usa el modelo gpt-3.5-turbo
+```
+
+Construya el sitio, con soporte para traducción multilingüe. Usa el directorio actual como directorio fuente y la salida va al directorio `.zen/dist`.
+
+- Puede especificar las versiones de idioma a generar usando múltiples veces el parámetro `--lang` (por ejemplo, `--lang es-ES --lang en-US`).
+- Puede especificar el prefijo de URL base del sitio con el parámetro `--base-url` (por ejemplo, el nombre del repositorio en GitHub Pages).
+- No es necesario configurar el idioma fuente; ZEN lo detecta automáticamente.
+
+```bash
+npx zengen@latest build --lang es-ES --lang en-US
+```
+
+**Ver más parámetros o ayuda**:
+
+```bash
+npx zengen@latest
+```

package/.zen/src/es-MX/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md

@@ -0,0 +1,71 @@
+---
+title: ZEN - Generador de Sitios Estáticos Minimalista con Markdown + IA
+summary: ZEN es un generador de sitios estáticos potenciado por IA, que admite navegación por categorías inteligente y traducción incremental automática, permitiendo a los usuarios centrarse en escribir en su idioma nativo y simplificando el proceso de configuración y construcción.
+tags:
+  - Generador de Sitios Estáticos
+  - Markdown
+  - IA
+  - Traducción Multilingüe
+  - Minimalismo
+  - Herramientas de Documentación
+  - Node.js
+inferred_lang: es-MX
+---
+
+# ZEN - Generador de Sitios Estáticos Minimalista con Markdown + IA
+
+[> Demostración del Sitio Web](https://zccz14.github.io/ZEN/)
+
+## Funcionalidades Básicas
+
+1.  📃 **Generación de Sitios Estáticos**: Construye un sitio HTML estático a partir de cualquier carpeta git que contenga archivos Markdown.
+2.  🧭 **Navegación por Categorías Inteligente**: Utiliza IA para analizar el contenido, generando un mapa del sitio y navegación, sin depender de la ubicación de los archivos fuente.
+3.  🌍 **Traducción Incremental Automática**: Utiliza IA para realizar traducciones incrementales, permitiendo a los usuarios escribir Markdown en su idioma nativo, pero pudiendo ser multilingües.
+
+¿Por qué crear otro generador de sitios estáticos con Markdown? He reconsiderado cómo las herramientas de documentación pueden servir mejor a los escritores en la era de la IA:
+
+- **Regreso al contenido**: Minimizar las distracciones, enfocarse en escribir.
+
+  Devolver la documentación a su esencia, devolver la tranquilidad a la escritura.
+
+  Primero, no quiero ser un bibliotecario. A veces quiero escribir algo, pero quizás aún no he pensado en su título o no lo he organizado de manera específica. Espero que un LLM me ayude automáticamente a generar títulos, hacer resúmenes, clasificar, navegar y otras tareas de organización.
+
+  Segundo, mi estudio debe estar impecable. No quiero herramientas de construcción con configuraciones complejas, ni configuraciones de documentos complicadas, ni estructuras complejas. Cada vez que veo los archivos de configuración y la estructura de proyectos de herramientas como Docusaurus, VuePress o Astro, me duele la cabeza. Ahora, ZEN opta por ocultar toda la configuración en el directorio `.zen`, barriéndola bajo la alfombra. El usuario solo necesita centrarse en escribir el contenido; ZEN se encarga del resto. Todos los demás directorios son su espacio de escritura, puede organizar sus archivos Markdown como desee.
+
+- **Regreso al idioma nativo**: Escribir en la lengua materna, construir versiones multilingües sin esfuerzo.
+
+  La vida es corta, no tengo ganas de traducir. Las personas alcanzan su máxima profundidad de pensamiento cuando usan su idioma nativo. Pero al mismo tiempo, es necesario mantenerse conectado con el mundo; no quiero renunciar a la comunicación multilingüe. Por lo tanto, deseo una herramienta que me permita escribir en mi idioma nativo y, a la vez, permita que más personas vean mi contenido. Actualmente, la i18n no solo requiere que uno traduzca, sino que también mantenga las actualizaciones del contenido, lo cual es muy tedioso. He optado por usar LLM para ayudarme con la traducción, ahorrándome mucho tiempo y permitiéndome completar traducciones a múltiples idiomas con un solo clic.
+
+## Comenzar Rápidamente
+
+Requisitos previos:
+
+- Tener [Node.js](https://nodejs.org/) instalado (se recomienda versión 18 o superior, debe incluir el comando `npx`)
+- Haber obtenido una [Clave API de OpenAI](https://platform.openai.com/account/api-keys), o una clave API compatible con OpenAI.
+- Tener Git instalado (para listar archivos Markdown desde un repositorio Git, ignorando los archivos filtrados por las reglas de `.gitignore`).
+
+Primero, trabaje en una carpeta que ya esté gestionada por Git:
+
+Configure las variables de entorno:
+
+```bash
+export OPENAI_API_KEY="sk-xxxxxx"  # Obligatorio: reemplazar con su Clave API de OpenAI
+export OPENAI_BASE_URL="https://api.openai.com/v1"  # Opcional, por defecto usa la API oficial de OpenAI
+export OPENAI_MODEL="gpt-3.5-turbo"  # Opcional, por defecto usa el modelo gpt-3.5-turbo
+```
+
+Construya el sitio, con soporte para traducción multilingüe. Usa el directorio actual como fuente y genera la salida en el directorio `.zen/dist`.
+
+- Puede especificar las versiones de idioma a generar usando múltiples veces el parámetro `--lang` (por ejemplo, `--lang es-MX --lang en-US`).
+- Puede especificar el prefijo de URL base del sitio con el parámetro `--base-url` (por ejemplo, el nombre del repositorio en GitHub Pages).
+- No es necesario configurar el idioma fuente; ZEN lo detectará automáticamente.
+
+```bash
+npx zengen@latest build --lang es-MX --lang en-US
+```
+
+**Ver más parámetros o ayuda**:
+
+```bash
+npx zengen@latest
+```

package/.zen/src/fi-FI/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md

@@ -0,0 +1,71 @@
+---
+title: ZEN - Minimalistinen Markdown + AI -staattinen sivuston rakentaja
+summary: ZEN on AI:ta hyödyntävä staattinen sivuston generoija, joka tukee älykästä luokittelunavigointia ja automaattista inkrementaalista käännöstä. Se mahdollistaa käyttäjän keskittyä äidinkielellä kirjoittamiseen ja yksinkertaistaa konfigurointia ja rakennusprosessia.
+tags:
+  - staattinen sivuston generoija
+  - Markdown
+  - AI
+  - monikielinen käännös
+  - minimalismi
+  - dokumentointityökalu
+  - Node.js
+inferred_lang: fi-FI
+---
+
+# ZEN - Minimalistinen Markdown + AI -staattinen sivuston rakentaja
+
+[> Verkkosivuston demo](https://zccz14.github.io/ZEN/)
+
+## Perustoiminnot
+
+1. 📃 **Staattinen sivuston generointi**: Muunna mikä tahansa git-kansio, joka sisältää Markdown-tiedostoja, staattiseksi HTML-sivustoksi.
+2. 🧭 **Älykäs luokittelunavigointi**: Käytä AI:ta sisällön analysointiin, sivustokartan ja navigoinnin luomiseen. Lähdetiedostojen sijainti ei ole merkityksellinen.
+3. 🌍 **Automaattinen inkrementaalinen käännös**: Käytä AI:ta inkrementaaliseen käännökseen, jotta käyttäjä voi kirjoittaa Markdownia äidinkielellään, mutta käyttäjä voi olla monikielinen.
+
+Miksi olen luonut taas uuden Markdown-staattisen sivuston generoijan? Olen uudelleen miettinyt, kuinka dokumentointityökalut voisivat AI-aikakaudella palvella kirjoittajia paremmin:
+
+- Palaa sisältöön: Minimoi häiriöt, keskity kirjoittamiseen
+
+  Palauta dokumenttien olemus, palauta kirjoittamisen rauha.
+
+  Ensinnäkin, en halua olla kirjastonhoitaja. Joskus haluan kirjoittaa jotain sisältöä, mutta en ehkä ole vielä keksinyt sille otsikkoa tai muodostanut selkeää organisointia. Toivoisin, että LLM automaattisesti luo otsikoita, tekee yhteenvetoja, luokittelee ja navigoi sisällön järjestelytyöt.
+
+  Toiseksi, kirjastoni on puhdistettava siistiksi. En halua monimutkaisia konfigurointityökaluja, sotkea monimutkaisia dokumenttikokoonpanoja tai monimutkaisia rakenteita. Joka kerta kun näen Docusaurus-, VuePress- tai Astro-työkalujen konfiguraatiotiedostot ja projektirakenteet, särkee päätäni. Nyt ZEN valitsee piilottaa kaikki konfiguraatiot `.zen`-hakemistoon, nurkkaan, jotta käyttäjä voi keskittyä vain kirjoittamiseen. Kaikki muut hakemistot ovat sinun kirjoitustilasi, voit järjestellä Markdown-tiedostojasi vapaasti.
+
+- Palaa äidinkieleen: Kirjoita äidinkielellä, luo monikieliset versiot sulavasti
+
+  Elämä on lyhyt, en jaksa kääntää. Ihmiset pystyvät parhaiten hyödyntämään ajattelunsa syvyyttä äidinkielellään. Mutta yhteydenpito maailmaan on välttämätöntä, enkä halua luopua monikielisestä vuorovaikutuksesta. Siksi toivoisin työkalua, jonka avulla voisin kirjoittaa äidinkielelläni ja samalla saada sisältöni näkyville useammille. Nykyinen i18n vaatii käännösten tekemistä itse ja sisällön päivitysten ylläpidon, mikä on liian työlästä. Valitsen käyttää LLM:ää käännösten tekemiseen, säästän paljon aikaa ja voin suorittaa monikieliset käännökset yhdellä napsautuksella.
+
+## Nopea aloitus
+
+Edellytykset:
+
+- [Node.js](https://nodejs.org/) asennettuna (suositeltu versio 18 tai uudempi, tarvitaan npx-komento)
+- [OpenAI API -avain](https://platform.openai.com/account/api-keys) hankittu, tai OPENAI-yhteensopiva API-avain
+- Git asennettuna (käytetään Markdown-tiedostojen listaukseen git:stä, .gitignore-sääntöjen mukaisesti suodatetut tiedostot ohitetaan)
+
+Työskentele ensin git-hallinnassa olevassa kansiossa:
+
+Määritä ympäristömuuttujat
+
+```bash
+export OPENAI_API_KEY="sk-xxxxxx"  # Pakollinen: korvaa omalla OpenAI API -avaimellasi
+export OPENAI_BASE_URL="https://api.openai.com/v1"  # Valinnainen, käyttää oletuksena OpenAI:n virallista API:a
+export OPENAI_MODEL="gpt-3.5-turbo"  # Valinnainen, käyttää oletuksena gpt-3.5-turbo -mallia
+```
+
+Rakenna sivusto, tuki monikielisiä käännöksiä. Käytä nykyistä hakemistoa lähdehakemistona, tuloste `.zen/dist`-hakemistoon.
+
+- Voit määrittää tarvittavat kieliversiot käyttämällä `--lang`-parametria useita kertoja (esim. `--lang fi-FI --lang en-US`).
+- Voit määrittää sivuston perus-URL-etuliitteen `--base-url`-parametrilla (esim. GitHub Pages -varaston nimi).
+- Lähdekieltä ei tarvitse konfiguroida, ZEN tunnistaa sen automaattisesti.
+
+```bash
+npx zengen@latest build --lang fi-FI --lang en-US
+```
+
+**Näytä lisää parametreja tai ohjeita**:
+
+```bash
+npx zengen@latest
+```