zengen 0.2.1 → 0.2.2

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:
@@ -35,7 +35,7 @@ jobs:
 
       - 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 +55,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,21 @@
   "version": "1.0.0",
   "options": {
     "verbose": true,
-    "langs": ["zh-Hans", "en-US"]
+    "langs": ["zh-Hans", "en-US", "es-ES", "pt-PT", "ja-JP", "de-DE", "fr-FR", "ru-RU", "ko-KR"]
   },
   "files": [
     {
-      "hash": "1b798c44a4f353e47296ca83d5905e37e6aba3e90bbd9bc3b3d34fc12059a2ca",
+      "hash": "48eb2ad3e174cd06ed16c959fa58e0381dbc4a4147fa3456b21eea2b3d67c329",
       "path": "README.md",
       "metadata": {
         "title": "ZEN - Markdown 文档站点构建工具",
-        "summary": "ZEN 是一个极简的静态站点生成工具，专注于将 Markdown 文件夹构建为 HTML 站点，支持智能导航和 AI 驱动的增量翻译，强调内容优先和跨语言支持，无需复杂配置。",
-        "tags": ["Markdown", "静态站点生成", "AI 翻译", "极简主义", "多语言", "文档工具", "ZEN"],
+        "summary": "ZEN 是一个简洁的 Markdown 静态站点生成工具，强调内容优先和极简主义，利用 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 文档站点生成器，包括特性、快速开始指南、代码示例和下一步学习资源。",
-        "tags": [
-          "ZEN",
-          "文档构建工具",
-          "Markdown",
-          "站点生成器",
-          "快速开始",
-          "代码示例",
-          "多语言支持"
-        ],
-        "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": 1150,
+          "completion": 119,
+          "total": 1269
         }
       }
     }

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/en-US/04319611d7cde718d0e82da8e034e04b15fb3bb37c3784d8f7313577c5178b06.md

@@ -0,0 +1,73 @@
+---
+title: ZEN - Markdown Documentation Site Builder
+summary: ZEN is a minimalist Markdown static site generator focused on content writing. It leverages AI for translation and navigation, supports multilingual builds, and requires no complex configuration.
+tags:
+  - Markdown
+  - Static Site Generator
+  - AI Translation
+  - Multilingual
+  - Minimalism
+  - Documentation Tool
+  - ZEN
+inferred_lang: en-US
+---
+
+# ZEN - A Minimalist Markdown Documentation Site Builder
+
+[简体中文](https://zccz14.github.io/ZEN/zh-Hans) | [English](https://zccz14.github.io/ZEN/en-US)
+
+Why create another Markdown static site generator? I've been rethinking 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 let writing return to tranquility.
+
+  First, I don't want to be a librarian. Sometimes I want to jot down some content, but I might not have thought of a title yet, or haven't formed a specific structure. I hope LLMs will automatically help me generate titles, summaries, categorize, and organize navigation.
+
+  Second, my study must be kept tidy. I don't want complex build tools, fiddling with intricate documentation configurations, or complicated structures. Every time I see the configuration files and project structures of tools like Docusaurus, VuePress, or Astro, my head hurts. Now, ZEN chooses to hide all configurations in the `.zen` directory, swept into a corner. Users only need to focus on writing content; everything else is handled by ZEN. All other directories are your writing space; you can organize your Markdown files however you like.
+
+- **Return to Native Language**: Write in your native language, build multilingual versions seamlessly.
+
+  Life is short; I'm too lazy to translate. People can best express the depth of their thinking when using their native language. Yet, staying connected to the world is necessary; I don't want to give up multilingual communication. So, I wanted a tool that allows me to write in my native language while enabling more people to see my content. Current i18n solutions not only require manual translation but also self-maintenance of content updates, which is too troublesome. I choose to use LLMs to handle translation for me, saving a lot of time and enabling one-click translation into multiple languages.
+
+## Core Features
+
+1. **Static Site Generation**
+   - Build any folder containing Markdown files into a static HTML site.
+
+2. **Intelligent Navigation**
+   - Generate site maps and navigation. You don't need to maintain the original directory structure of the Markdown source files; you can move source files around freely.
+
+3. **Incremental i18n Translation**
+   - Use LLMs for incremental i18n translation, allowing users to write Markdown in their native language while the site can be multilingual.
+
+## Design Philosophy
+
+- **Minimalism**: Minimal configuration, maximum flexibility.
+- **Content First**: Focus on writing, not tool configuration.
+- **AI-Powered**: Leverage AI for translation and content organization.
+- **Cross-Language**: Support multilingual content creation and display.
+
+## Quick Start
+
+### Recommended Usage
+
+**It is recommended to switch to the directory containing your Markdown files and directly use the following command to start building:**
+
+```bash
+# Set environment variables (modify according to your actual situation)
+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
+npx zengen@latest build --lang zh-Hans --lang en-US --verbose
+```
+
+**To view more parameters or help**:
+
+```bash
+npx zengen
+```
+
+**Note**: ZEN enforces using the current directory as the source directory and outputs to the `.zen/dist` directory. It does not support specifying source and output directory parameters.

package/.zen/src/en-US/48eb2ad3e174cd06ed16c959fa58e0381dbc4a4147fa3456b21eea2b3d67c329.md

@@ -0,0 +1,81 @@
+---
+title: ZEN - Markdown Documentation Site Builder
+summary: ZEN is a clean Markdown static site generator that emphasizes content-first and minimalism. It leverages AI for intelligent navigation and multilingual translation, helping users focus on writing without complex configurations.
+tags:
+  - Markdown
+  - Static Site Generator
+  - AI Translation
+  - Multilingual
+  - Minimalism
+  - Documentation Tool
+  - ZEN
+inferred_lang: en-US
+---
+
+# ZEN - A Clean Markdown Documentation Site Builder
+
+[简体中文](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) |
+
+Why create another Markdown static site generator? I've rethought 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, let writing return to tranquility.
+
+  First, I don't want to be a librarian. Sometimes I want to jot down some content, but I might not have thought of its title yet, or haven't formed a specific organization. I hope LLMs will automatically help me generate titles, create summaries, categorize, navigate, and handle other organizational tasks.
+
+  Second, my study must be kept clean. I don't want complex build tools, fiddling with intricate documentation configurations, or complicated structures. Every time I see the configuration files and project structures of tools like Docusaurus, VuePress, or Astro, I get a headache. Now, ZEN chooses to hide all configurations in the `.zen` directory, sweeping them into a corner. Users only need to focus on writing content; everything else is handled by ZEN. All other directories are your writing space; you can organize your Markdown files however you like.
+
+- **Return to Native Language**: Write in your native language, smoothly build multilingual versions
+
+  Life is short; I'm too lazy to translate. People can best express the depth of their thinking when using their native language. But staying connected with the world is also necessary; I don't want to give up multilingual communication. So, I want a tool that lets me write in my native language while allowing more people to see my content. Current i18n solutions not only require you to translate yourself but also maintain content updates, which is too troublesome. I choose to use LLMs to help with translation, saving me a lot of time and enabling one-click multilingual translation.
+
+## Core Features
+
+1. **Static Site Generation**
+   - Build any folder containing Markdown files into a static HTML site.
+
+2. **Intelligent Navigation**
+   - Generate site maps and navigation. You don't need to maintain the original directory structure of the Markdown source files; you can move source files around freely.
+
+3. **Incremental i18n Translation**
+   - Use LLMs for incremental i18n translation, allowing users to write Markdown in their native language while the site can be multilingual.
+
+## Design Philosophy
+
+- **Minimalism**: Minimal configuration, maximum flexibility.
+- **Content-First**: Focus on writing, not tool configuration.
+- **AI-Powered**: Leverage AI for translation and content organization.
+- **Cross-Language**: Support multilingual content creation and display.
+
+## Quick Start
+
+### Recommended Usage
+
+**It is recommended that users switch to the directory containing Markdown files and directly use the following command to start building:**
+
+```bash
+# Set environment variables (modify according to your actual situation)
+export OPENAI_API_KEY="sk-xxxxxx"  # Required: Please 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, supporting multilingual translation
+npx zengen@latest build --lang zh-Hans --lang en-US --verbose
+```
+
+**View more parameters or help**:
+
+```bash
+npx zengen
+```
+
+**Note**: ZEN enforces using the current directory as the source directory and outputs to the `.zen/dist` directory. It does not support specifying source and output directory parameters.

package/.zen/src/en-US/afbf4998656c97181d0edc711e388ad11e0f08f5c6f329861327202462a3a34a.md

@@ -0,0 +1,63 @@
+---
+title: ZEN - Markdown Documentation Site Builder
+summary: ZEN is a minimalist Markdown static site generator that emphasizes content-first, hides configuration, and leverages AI to empower users to focus on writing in their native language, while supporting multilingual translation and intelligent navigation.
+tags:
+  - Markdown
+  - Static Site Generation
+  - AI Translation
+  - Multilingual
+  - Minimalism
+  - Content-First
+  - Documentation Tool
+inferred_lang: en-US
+---
+
+# ZEN - A Minimalist Markdown Documentation Site Builder
+
+[简体中文](https://zccz14.github.io/ZEN/zh-Hans) | [English](https://zccz14.github.io/ZEN/en-US)
+
+Why create another Markdown static site generator?
+
+- **Return to Content**: Minimize distractions, let you focus on writing
+
+  Let documentation return to its essence, let writing return to tranquility. I don't want complex build tools with complicated configurations, I dislike fiddling with intricate documentation setups and convoluted structures. Every time I see the configuration files and project structures of tools like Docusaurus, VuePress, or Astro, my head hurts. Now, ZEN chooses to hide all configuration in the `.zen` directory, sweeping it into a corner. Users only need to focus on writing content; ZEN handles the rest. All other directories are your writing space; you can organize your Markdown files however you like. LLMs will automatically help you generate titles, create summaries, categorize, and generate navigation. You really only need to focus on writing.
+
+- **Return to Native Language**: Write only in your native language, smoothly build multilingual versions
+
+  Life is short, I'm too lazy to translate. People can best express the depth of their thinking when using their native language. But staying connected to the world is also necessary; I don't want to give up multilingual communication. So I wanted a tool that allows me to write in my native language while also letting more people see my content. Current i18n solutions not only require you to translate yourself but also to maintain content updates, which is too troublesome. I choose to use LLMs to handle translation for me, saving me a lot of time and enabling one-click translation into multiple languages.
+
+## Core Features
+
+1. **Static Site Generation**
+   - Build any folder containing Markdown files into a static HTML site.
+
+2. **Intelligent Navigation**
+   - Generate site maps and navigation without needing to maintain the original directory structure of the Markdown source files.
+
+3. **Incremental i18n Translation**
+   - Use LLMs for incremental i18n translation, allowing users to write Markdown in their native language while the audience can be multilingual.
+
+## Design Philosophy
+
+- **Minimalism**: Minimal configuration, maximum flexibility.
+- **Content-First**: Focus on writing, not tool configuration.
+- **AI-Powered**: Leverage AI for translation and content organization.
+- **Cross-Language**: Support multilingual content creation and display.
+
+## Quick Start
+
+### Recommended Usage
+
+**It is recommended that users switch to the directory containing their Markdown files and directly use the following command to start building:**
+
+```bash
+npx zengen build
+```
+
+**To view more parameters or help:**
+
+```bash
+npx zengen
+```
+
+**Note**: ZEN enforces using the current directory as the source directory and outputs to the `.zen/dist` directory. It does not support specifying source and output directory parameters.

package/.zen/src/es-ES/04319611d7cde718d0e82da8e034e04b15fb3bb37c3784d8f7313577c5178b06.md

@@ -0,0 +1,73 @@
+---
+title: ZEN - Herramienta para construir sitios de documentación en Markdown
+summary: ZEN es una herramienta minimalista para generar sitios estáticos a partir de Markdown, centrada en la escritura de contenido. Utiliza IA para gestionar traducciones y navegación, soporta construcción multilingüe y no requiere configuración compleja.
+tags:
+  - Markdown
+  - Generador de sitios estáticos
+  - Traducción por IA
+  - Multilingüe
+  - Minimalismo
+  - Herramienta de documentación
+  - ZEN
+inferred_lang: es-ES
+---
+
+# ZEN - Herramienta sencilla para construir sitios de documentación en Markdown
+
+[简体中文](https://zccz14.github.io/ZEN/zh-Hans) | [English](https://zccz14.github.io/ZEN/en-US) | [Español](https://zccz14.github.io/ZEN/es-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, concentrarse en escribir
+
+  Devolver la esencia a la documentación y 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 he organizado bien las ideas. Me gustaría que una LLM generara automáticamente 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 estructuras complicadas. 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`, apartándola a un rincón, para que el usuario solo se centre en escribir el contenido y deje el resto a ZEN. Todos los demás directorios son su espacio de escritura, donde 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 alcanza su máxima 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, llegar a más personas con mi contenido. Actualmente, la internacionalización (i18n) requiere que uno mismo traduzca y mantenga las actualizaciones del contenido, lo cual es muy tedioso. He optado por usar una LLM para que me ayude con las traducciones, ahorrándome mucho tiempo y permitiéndome completar traducciones a múltiples idiomas con un solo clic.
+
+## Funcionalidades básicas
+
+1. **Generación de sitios estáticos**
+   - Convierte cualquier carpeta que contenga archivos Markdown en un sitio web estático HTML.
+
+2. **Navegación inteligente**
+   - Genera un mapa del sitio y navegación. No es necesario mantener la estructura de directorios original de los archivos fuente Markdown; puedes mover los archivos fuente libremente.
+
+3. **Traducción incremental i18n**
+   - Utiliza LLM para realizar traducciones i18n incrementales, permitiendo a los usuarios escribir Markdown en su lengua materna, pero siendo el resultado multilingüe.
+
+## Filosofía de diseño
+
+- **Minimalismo**: Mínima configuración, máxima flexibilidad.
+- **Contenido primero**: Enfocarse en escribir, no en configurar herramientas.
+- **Potenciado por IA**: Utiliza la IA para gestionar traducciones y organización del contenido.
+- **Multilingüe**: Soporta la creación y visualización de contenido en múltiples idiomas.
+
+## Comenzar rápidamente
+
+### Forma recomendada de uso
+
+**Se recomienda que el usuario cambie al directorio que contiene los archivos Markdown y utilice directamente el siguiente comando para comenzar la construcción:**
+
+```bash
+# Establecer variables de entorno (modificar según su situación real)
+export OPENAI_API_KEY="sk-xxxxxx"  # Obligatorio: reemplazar con su propia clave de 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
+
+# Construir el sitio, soporta traducción multilingüe
+npx zengen@latest build --lang zh-Hans --lang en-US --verbose
+```
+
+**Ver más parámetros o ayuda**:
+
+```bash
+npx zengen
+```
+
+**Nota**: ZEN obliga a usar el directorio actual como directorio fuente y la salida se genera en el directorio `.zen/dist`. No admite parámetros para especificar directorios de origen o de salida.