zengen 0.2.1 → 0.2.3

package/.zen/src/tr-TR/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md

@@ -0,0 +1,71 @@
+---
+title: ZEN - Minimalist Markdown + AI Statik Site Oluşturucu
+summary: ZEN, akıllı sınıflandırma navigasyonu ve otomatik artımlı çeviri desteği sunan, AI ile entegre bir statik site oluşturucudur. Kullanıcıların ana dillerinde yazmaya odaklanmasını sağlar, yapılandırma ve derleme sürecini basitleştirir.
+tags:
+  - Statik Site Oluşturucu
+  - Markdown
+  - AI
+  - Çok Dilli Çeviri
+  - Minimalizm
+  - Dokümantasyon Aracı
+  - Node.js
+inferred_lang: tr-TR
+---
+
+# ZEN - Minimalist Markdown + AI Statik Site Oluşturucu
+
+[> Website Demo](https://zccz14.github.io/ZEN/)
+
+## Temel Özellikler
+
+1.  📃 **Statik Site Oluşturma**: Markdown içeren herhangi bir git klasörünü statik bir HTML sitesine dönüştürür.
+2.  🧭 **Akıllı Sınıflandırma Navigasyonu**: AI kullanarak içerik analizi yapar, site haritası ve navigasyon oluşturur. Kaynak dosyaların konumu önemli değildir.
+3.  🌍 **Otomatik Artımlı Çeviri**: AI kullanarak artımlı çeviri yapar. Kullanıcılar Markdown'ı ana dillerinde yazabilir, ancak site çok dilli olabilir.
+
+Neden bir Markdown statik site oluşturucusu daha? AI çağında, dokümantasyon araçlarının yazarlara nasıl daha iyi hizmet edebileceğini yeniden düşündüm:
+
+- İçeriğe Dönüş: Müdahaleyi en aza indirin, yazmaya odaklanın
+
+  Dokümanları özüne döndürün, yazmayı huzurlu bir deneyim haline getirin.
+
+  Birincisi, kütüphaneci olmak istemiyorum. Bazen bir şeyler yazmak isterim ama henüz başlığını düşünmemiş, belirli bir organizasyon oluşturmamış olabilirim. LLM'nin başlık oluşturma, özet çıkarma, sınıflandırma, navigasyon gibi düzenleme işlerini otomatik yapmasını umuyorum.
+
+  İkincisi, çalışma odam temiz olmalı. Karmaşık yapılandırmalı derleme araçları, karmaşık doküman ayarlarıyla uğraşmak, karmaşık yapıları sevmiyorum. Docusaurus, VuePress, Astro gibi araçların yapılandırma dosyalarını ve proje yapılarını her gördüğümde başım ağrıyor. Şimdi, ZEN tüm yapılandırmaları `.zen` dizinine gizlemeyi, köşeye süpürmeyi seçiyor. Kullanıcı sadece içerik yazmaya odaklanır, gerisini ZEN halleder. Diğer tüm dizinler sizin yazma alanınızdır, Markdown dosyalarınızı istediğiniz gibi düzenleyebilirsiniz.
+
+- Ana Dile Dönüş: Ana dilinizde yazın, çok dilli sürümleri sorunsuz oluşturun
+
+  Hayat kısa, çeviri yapmakla uğraşmak istemiyorum. İnsanlar ana dillerini kullanırken düşüncelerinin derinliğini en iyi şekilde ortaya koyabilir. Ancak aynı zamanda dünyayla bağlantıda kalmak da gereklidir, çok dilli iletişimi bırakmak istemiyorum. Bu yüzden, ana dilimde yazmama izin veren, aynı zamanda içeriğimi daha fazla kişiye ulaştırabilen bir araç istiyorum. Mevcut i18n çözümleri sadece kendi çevirinizi yapmanızı gerektirmekle kalmaz, aynı zamanda içerik güncellemelerini de sizin yönetmenizi gerektirir, bu çok zahmetli. Çevirileri yapmak için LLM'yi kullanmayı seçiyorum, bu bana çok zaman kazandırıyor ve tek tıkla çoklu dil çevirisi yapılabiliyor.
+
+## Hızlı Başlangıç
+
+Ön Koşullar:
+
+- [Node.js](https://nodejs.org/) kurulu olmalı (18 veya üzeri sürüm önerilir, npx komutu gereklidir)
+- [OpenAI API Anahtarı](https://platform.openai.com/account/api-keys) veya OPENAI uyumlu bir API Anahtarı edinilmiş olmalı
+- Git kurulu olmalı (Markdown dosyalarını Git'ten listelemek ve .gitignore kurallarıyla filtrelenen dosyaları yok saymak için)
+
+İlk olarak, git ile yönetilen bir klasörde çalışın:
+
+Ortam değişkenlerini yapılandırın
+
+```bash
+export OPENAI_API_KEY="sk-xxxxxx"  # Zorunlu: Lütfen kendi OpenAI API Anahtarınızla değiştirin
+export OPENAI_BASE_URL="https://api.openai.com/v1"  # Opsiyonel, varsayılan olarak OpenAI resmi API'si kullanılır
+export OPENAI_MODEL="gpt-3.5-turbo"  # Opsiyonel, varsayılan olarak gpt-3.5-turbo modeli kullanılır
+```
+
+Siteyi oluşturun, çok dilli çeviriyi destekler. Mevcut dizini kaynak dizin olarak kullanır, çıktıyı `.zen/dist` dizinine yazar.
+
+- Oluşturulacak dil sürümlerini belirtmek için `--lang` parametresi birden fazla kez kullanılabilir (örneğin `--lang tr-TR --lang en-US`).
+- Sitenin temel URL önekini belirtmek için `--base-url` parametresi kullanılabilir (örneğin GitHub Pages'teki depo adı).
+- Kaynak dili yapılandırmaya gerek yoktur, ZEN otomatik olarak algılar.
+
+```bash
+npx zengen@latest build --lang tr-TR --lang en-US
+```
+
+**Daha fazla parametre veya yardım için**:
+
+```bash
+npx zengen@latest
+```

package/.zen/src/uk-UA/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md

@@ -0,0 +1,71 @@
+---
+title: ZEN - Мінімалістичний Markdown + AI генератор статичних сайтів
+summary: ZEN — це генератор статичних сайтів з інтеграцією AI, що підтримує розумну категорізацію, навігацію та автоматичний інкрементальний переклад, дозволяючи користувачам зосередитись на написанні рідною мовою та спрощуючи процес налаштування та збірки.
+tags:
+  - Генератор статичних сайтів
+  - Markdown
+  - AI
+  - Багатомовний переклад
+  - Мінімалізм
+  - Інструмент для документації
+  - Node.js
+inferred_lang: uk-UA
+---
+
+# ZEN - Мінімалістичний Markdown + AI генератор статичних сайтів
+
+[> Демо сайту](https://zccz14.github.io/ZEN/)
+
+## Основні функції
+
+1.  📃 **Генерація статичного сайту**: Перетворює будь-яку папку з файлами Markdown, яка керується git, на статичний HTML-сайт.
+2.  🧭 **Розумна категорізація та навігація**: Використовує AI для аналізу вмісту, генерації карти сайту та навігації. Розташування вихідних файлів не має значення.
+3.  🌍 **Автоматичний інкрементальний переклад**: Використовує AI для інкрементального перекладу, дозволяючи користувачам писати Markdown рідною мовою, але отримувати багатомовний вміст.
+
+Чому ще один генератор статичних сайтів для Markdown? Я переосмислив, як інструменти для документації в епоху AI можуть краще служити письменникам:
+
+- Повернення до змісту: мінімізація відволікань, фокус на написанні
+
+  Повернути документацію до її сутності, а написанню — спокій.
+
+  По-перше, я не хочу бути бібліотекарем. Іноді я хочу щось записати, але ще не визначився з заголовком або структурою. Я хочу, щоб 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 uk-UA --lang en-US`).
+- Базовий URL-префікс сайту можна вказати за допомогою параметра `--base-url` (наприклад, ім'я репозиторію на GitHub Pages).
+- Вихідну мову налаштовувати не потрібно, ZEN визначить її автоматично.
+
+```bash
+npx zengen@latest build --lang uk-UA --lang en-US
+```
+
+**Переглянути більше параметрів або отримати довідку**:
+
+```bash
+npx zengen@latest
+```

package/.zen/src/vi-VN/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md

@@ -0,0 +1,71 @@
+---
+title: ZEN - Trình tạo trang tĩnh Markdown + AI theo chủ nghĩa tối giản
+summary: ZEN là một trình tạo trang tĩnh tích hợp AI, hỗ trợ điều hướng phân loại thông minh và dịch thuật tự động tăng dần, cho phép người dùng tập trung viết bằng ngôn ngữ mẹ đẻ, đơn giản hóa quá trình cấu hình và xây dựng.
+tags:
+  - Trình tạo trang tĩnh
+  - Markdown
+  - AI
+  - Dịch thuật đa ngôn ngữ
+  - Chủ nghĩa tối giản
+  - Công cụ tài liệu
+  - Node.js
+inferred_lang: vi-VN
+---
+
+# ZEN - Trình tạo trang tĩnh Markdown + AI theo chủ nghĩa tối giản
+
+[> Website Demo](https://zccz14.github.io/ZEN/)
+
+## Chức năng cơ bản
+
+1. 📃 **Tạo trang tĩnh**: Biến bất kỳ thư mục git chứa Markdown nào thành một trang HTML tĩnh.
+2. 🧭 **Điều hướng phân loại thông minh**: Sử dụng AI để phân tích nội dung, tạo sơ đồ trang và điều hướng, không phụ thuộc vào vị trí của tệp nguồn.
+3. 🌍 **Dịch thuật tự động tăng dần**: Sử dụng AI để dịch tăng dần, cho phép người dùng viết Markdown bằng ngôn ngữ mẹ đẻ, nhưng có thể hỗ trợ đa ngôn ngữ.
+
+Tại sao lại tạo ra một trình tạo trang tĩnh Markdown nữa? Tôi đã suy nghĩ lại về cách các công cụ tài liệu trong thời đại AI có thể phục vụ người viết tốt hơn:
+
+- Trở về với nội dung: Giảm thiểu sự phiền nhiễu, tập trung vào việc viết
+
+  Đưa tài liệu trở lại bản chất, đưa việc viết trở về sự tĩnh lặng.
+
+  Thứ nhất, tôi không muốn làm thủ thư. Đôi khi tôi muốn viết một số nội dung, nhưng có thể tôi chưa nghĩ ra tiêu đề cho nó, chưa hình thành cấu trúc tổ chức cụ thể. Tôi hy vọng LLM sẽ tự động giúp tôi tạo tiêu đề, tóm tắt, phân loại, điều hướng và các công việc sắp xếp khác.
+
+  Thứ hai, thư phòng của tôi phải được dọn dẹp sạch sẽ. Tôi không muốn các công cụ xây dựng cấu hình phức tạp, vặn vẹo cấu hình tài liệu phức tạp, không thích cấu trúc phức tạp. Mỗi lần nhìn thấy các tệp cấu hình và cấu trúc dự án của các công cụ như Docusaurus, VuePress, Astro, tôi lại đau đầu. Bây giờ, ZEN chọn cách ẩn tất cả cấu hình vào thư mục .zen, quét vào góc, người dùng chỉ cần tập trung vào việc viết nội dung, phần còn lại để ZEN xử lý. Các thư mục khác đều là không gian viết của bạn, bạn có thể tự do tổ chức các tệp Markdown của mình.
+
+- Trở về với tiếng mẹ đẻ: Viết bằng tiếng mẹ đẻ, xây dựng phiên bản đa ngôn ngữ mượt mà
+
+  Cuộc đời ngắn ngủi, tôi lười dịch. Khi sử dụng ngôn ngữ mẹ đẻ, con người mới có thể phát huy tối đa chiều sâu tư duy của mình. Nhưng đồng thời việc giữ kết nối với thế giới là cần thiết, tôi không muốn từ bỏ giao tiếp đa ngôn ngữ. Vì vậy, tôi hy vọng có một công cụ cho phép tôi viết bằng ngôn ngữ mẹ đẻ, đồng thời lại có thể để nhiều người hơn xem được nội dung của tôi. Hiện tại, i18n không chỉ yêu cầu tự dịch mà còn phải tự duy trì cập nhật nội dung, quá phiền phức. Tôi chọn sử dụng LLM để giúp tôi dịch, tiết kiệm rất nhiều thời gian và có thể hoàn thành dịch thuật đa quốc gia chỉ với một cú nhấp chuột.
+
+## Bắt đầu nhanh
+
+Điều kiện tiên quyết:
+
+- Đã cài đặt [Node.js](https://nodejs.org/) (khuyến nghị phiên bản 18 trở lên, cần có lệnh npx)
+- Đã lấy [OpenAI API Key](https://platform.openai.com/account/api-keys), hoặc API Key tương thích với OPENAI
+- Đã cài đặt Git (dùng để liệt kê các tệp Markdown từ Git, bỏ qua các tệp bị lọc bởi quy tắc .gitignore)
+
+Đầu tiên, làm việc trong một thư mục đã được quản lý bởi git:
+
+Cấu hình biến môi trường
+
+```bash
+export OPENAI_API_KEY="sk-xxxxxx"  # Bắt buộc: Vui lòng thay thế bằng OpenAI API Key của bạn
+export OPENAI_BASE_URL="https://api.openai.com/v1"  # Tùy chọn, mặc định sử dụng API chính thức của OpenAI
+export OPENAI_MODEL="gpt-3.5-turbo"  # Tùy chọn, mặc định sử dụng mô hình gpt-3.5-turbo
+```
+
+Xây dựng trang web, hỗ trợ dịch thuật đa ngôn ngữ. Sử dụng thư mục hiện tại làm thư mục nguồn, đầu ra đến thư mục `.zen/dist`.
+
+- Có thể chỉ định các phiên bản ngôn ngữ cần tạo bằng cách sử dụng nhiều lần tham số `--lang` (ví dụ: `--lang zh-Hans --lang en-US`).
+- Có thể chỉ định tiền tố URL cơ sở của trang web bằng tham số `--base-url` (ví dụ: tên kho lưu trữ trên GitHub Pages).
+- Không cần cấu hình ngôn ngữ nguồn, ZEN sẽ tự động phát hiện.
+
+```bash
+npx zengen@latest build --lang zh-Hans --lang en-US
+```
+
+**Xem thêm tham số hoặc trợ giúp**:
+
+```bash
+npx zengen@latest
+```

package/.zen/src/zh-Hans/04319611d7cde718d0e82da8e034e04b15fb3bb37c3784d8f7313577c5178b06.md

@@ -0,0 +1,73 @@
+---
+title: ZEN - Markdown 文档站点构建工具
+summary: ZEN 是一个极简的 Markdown 静态站点生成工具，专注于内容写作，利用 AI 处理翻译和导航，支持多语言构建，无需复杂配置。
+tags:
+  - Markdown
+  - 静态站点生成器
+  - AI 翻译
+  - 多语言
+  - 极简主义
+  - 文档工具
+  - ZEN
+inferred_lang: zh-Hans
+---
+
+# ZEN - 简洁的 Markdown 文档站点构建工具
+
+[简体中文](https://zccz14.github.io/ZEN/zh-Hans) | [English](https://zccz14.github.io/ZEN/en-US)
+
+为什么又搞了个 Markdown 静态站点生成器？我重新思考了 AI 时代下，文档工具可以如何更好地服务于写作者：
+
+- 回归内容：最小化打扰，专注写作
+
+  让文档回归本质，让写作回归宁静。
+
+  其一，我不想做图书管理员。我有时想写下一些内容，但我可能还没有想好它的标题，还没有形成特别的组织。我希望 LLM 会自动帮我生成标题、做摘要、分类、导航等整理工作。
+
+  其二，我的书房必须打扫干净。我不想要配置复杂的构建工具，折腾复杂的文档配置，不喜欢复杂的结构。每次我看到 Docusaurus、VuePress、Astro 这些工具的配置文件和项目结构，我就头疼。现在，ZEN 选择将所有的配置都隐藏到 .zen 目录下，扫到角落里，用户只需要专注于写作内容，其他的交给 ZEN 来处理。其他的目录都是您的写作空间，您可以随意组织您的 Markdown 文件。
+
+- 回归母语：用母语写作，丝滑构建多语言版本
+
+  人生苦短，我懒得翻译。人在使用母语时，才是最能发挥自身思考深度的。但同时与世界保持连接又是必要的，我不想放弃多语言的交流。于是我希望有一个工具，能让我用母语写作，同时又能让更多人看到我的内容。现在的 i18n 需要自己翻译不说，还得自己维护内容更新，太麻烦了。我选择使用 LLM 来帮我做翻译，省下了我很多时间，并且可以一键完成多国语言翻译。
+
+## 基本功能
+
+1. **静态站点生成**
+   - 将任意一个包含 Markdown 的文件夹构建成一个静态 HTML 站点
+
+2. **智能导航**
+   - 生成站点地图和导航，不需要保持原始的 Markdown 源文件的目录结构，可以随意移动源文件。
+
+3. **增量 i18n 翻译**
+   - 使用 LLM 进行增量 i18n 翻译，让用户使用母语编写 Markdown，但是用户可以是多语言的
+
+## 设计理念
+
+- **极简主义**: 最少的配置，最大的灵活性
+- **内容优先**: 专注于写作，而不是工具配置
+- **AI 赋能**: 利用 AI 处理翻译和内容组织
+- **跨语言**: 支持多语言内容创作和展示
+
+## 快速开始
+
+### 推荐使用方式
+
+**推荐用户切换到包含 Markdown 文件的目录下，直接使用以下命令开始构建：**
+
+```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 模型
+
+# 构建站点，支持多语言翻译
+npx zengen@latest build --lang zh-Hans --lang en-US --verbose
+```
+
+**查看更多参数或帮助**：
+
+```bash
+npx zengen
+```
+
+**注意**：ZEN 强制使用当前目录作为源目录，输出到 `.zen/dist` 目录。不支持指定源目录和输出目录参数。

package/.zen/src/zh-Hans/084ef1f6a0167df8621c673c79211309d4af6c588e7bbe3e043f7c244edd0ac6.md

@@ -0,0 +1,80 @@
+---
+title: ZEN - Markdown 文档站点构建工具
+summary: ZEN 是一个简洁的 Markdown 静态站点生成工具，专注于内容写作，利用 AI 实现智能导航和多语言翻译，无需复杂配置。
+tags:
+  - Markdown
+  - 静态站点生成
+  - AI 翻译
+  - 多语言
+  - 极简主义
+  - 文档工具
+  - ZEN
+inferred_lang: zh-Hans
+---
+
+# ZEN - 简洁的 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) |
+[Ruсть](https://zccz14.github.io/ZEN/ru-RU) |
+[Français](https://zccz14.github.io/ZEN/fr-FR) |
+[Deutsch](https://zccz14.github.io/ZEN/de-DE) |
+[日本語](https://zccz14.github.io/ZEN/ja-JP) |
+[한국어](https://zccz14.github.io/ZEN/ko-KR)
+
+为什么又搞了个 Markdown 静态站点生成器？我重新思考了 AI 时代下，文档工具可以如何更好地服务于写作者：
+
+- 回归内容：最小化打扰，专注写作
+
+  让文档回归本质，让写作回归宁静。
+
+  其一，我不想做图书管理员。我有时想写下一些内容，但我可能还没有想好它的标题，还没有形成特别的组织。我希望 LLM 会自动帮我生成标题、做摘要、分类、导航等整理工作。
+
+  其二，我的书房必须打扫干净。我不想要配置复杂的构建工具，折腾复杂的文档配置，不喜欢复杂的结构。每次我看到 Docusaurus、VuePress、Astro 这些工具的配置文件和项目结构，我就头疼。现在，ZEN 选择将所有的配置都隐藏到 .zen 目录下，扫到角落里，用户只需要专注于写作内容，其他的交给 ZEN 来处理。其他的目录都是您的写作空间，您可以随意组织您的 Markdown 文件。
+
+- 回归母语：用母语写作，丝滑构建多语言版本
+
+  人生苦短，我懒得翻译。人在使用母语时，才是最能发挥自身思考深度的。但同时与世界保持连接又是必要的，我不想放弃多语言的交流。于是我希望有一个工具，能让我用母语写作，同时又能让更多人看到我的内容。现在的 i18n 需要自己翻译不说，还得自己维护内容更新，太麻烦了。我选择使用 LLM 来帮我做翻译，省下了我很多时间，并且可以一键完成多国语言翻译。
+
+## 基本功能
+
+1. **静态站点生成**
+   - 将任意一个包含 Markdown 的文件夹构建成一个静态 HTML 站点
+
+2. **智能导航**
+   - 生成站点地图和导航，不需要保持原始的 Markdown 源文件的目录结构，可以随意移动源文件。
+
+3. **增量 i18n 翻译**
+   - 使用 LLM 进行增量 i18n 翻译，让用户使用母语编写 Markdown，但是用户可以是多语言的
+
+## 设计理念
+
+- **极简主义**: 最少的配置，最大的灵活性
+- **内容优先**: 专注于写作，而不是工具配置
+- **AI 赋能**: 利用 AI 处理翻译和内容组织
+- **跨语言**: 支持多语言内容创作和展示
+
+## 快速开始
+
+### 推荐使用方式
+
+**推荐用户切换到包含 Markdown 文件的目录下，直接使用以下命令开始构建：**
+
+```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 模型
+
+# 构建站点，支持多语言翻译
+npx zengen@latest build --lang zh-Hans --lang en-US --verbose
+```
+
+**查看更多参数或帮助**：
+
+```bash
+npx zengen
+```
+
+**注意**：ZEN 强制使用当前目录作为源目录，输出到 `.zen/dist` 目录。不支持指定源目录和输出目录参数。

package/.zen/src/zh-Hans/48eb2ad3e174cd06ed16c959fa58e0381dbc4a4147fa3456b21eea2b3d67c329.md

@@ -0,0 +1,81 @@
+---
+title: ZEN - Markdown 文档站点构建工具
+summary: ZEN 是一个简洁的 Markdown 静态站点生成工具，强调内容优先和极简主义，利用 AI 实现智能导航和多语言翻译，帮助用户专注于写作而无需复杂配置。
+tags:
+  - Markdown
+  - 静态站点生成
+  - AI 翻译
+  - 多语言
+  - 极简主义
+  - 文档工具
+  - ZEN
+inferred_lang: zh-Hans
+---
+
+# ZEN - 简洁的 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) |
+[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) |
+
+为什么又搞了个 Markdown 静态站点生成器？我重新思考了 AI 时代下，文档工具可以如何更好地服务于写作者：
+
+- 回归内容：最小化打扰，专注写作
+
+  让文档回归本质，让写作回归宁静。
+
+  其一，我不想做图书管理员。我有时想写下一些内容，但我可能还没有想好它的标题，还没有形成特别的组织。我希望 LLM 会自动帮我生成标题、做摘要、分类、导航等整理工作。
+
+  其二，我的书房必须打扫干净。我不想要配置复杂的构建工具，折腾复杂的文档配置，不喜欢复杂的结构。每次我看到 Docusaurus、VuePress、Astro 这些工具的配置文件和项目结构，我就头疼。现在，ZEN 选择将所有的配置都隐藏到 .zen 目录下，扫到角落里，用户只需要专注于写作内容，其他的交给 ZEN 来处理。其他的目录都是您的写作空间，您可以随意组织您的 Markdown 文件。
+
+- 回归母语：用母语写作，丝滑构建多语言版本
+
+  人生苦短，我懒得翻译。人在使用母语时，才是最能发挥自身思考深度的。但同时与世界保持连接又是必要的，我不想放弃多语言的交流。于是我希望有一个工具，能让我用母语写作，同时又能让更多人看到我的内容。现在的 i18n 需要自己翻译不说，还得自己维护内容更新，太麻烦了。我选择使用 LLM 来帮我做翻译，省下了我很多时间，并且可以一键完成多国语言翻译。
+
+## 基本功能
+
+1. **静态站点生成**
+   - 将任意一个包含 Markdown 的文件夹构建成一个静态 HTML 站点
+
+2. **智能导航**
+   - 生成站点地图和导航，不需要保持原始的 Markdown 源文件的目录结构，可以随意移动源文件。
+
+3. **增量 i18n 翻译**
+   - 使用 LLM 进行增量 i18n 翻译，让用户使用母语编写 Markdown，但是用户可以是多语言的
+
+## 设计理念
+
+- **极简主义**: 最少的配置，最大的灵活性
+- **内容优先**: 专注于写作，而不是工具配置
+- **AI 赋能**: 利用 AI 处理翻译和内容组织
+- **跨语言**: 支持多语言内容创作和展示
+
+## 快速开始
+
+### 推荐使用方式
+
+**推荐用户切换到包含 Markdown 文件的目录下，直接使用以下命令开始构建：**
+
+```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 模型
+
+# 构建站点，支持多语言翻译
+npx zengen@latest build --lang zh-Hans --lang en-US --verbose
+```
+
+**查看更多参数或帮助**：
+
+```bash
+npx zengen
+```
+
+**注意**：ZEN 强制使用当前目录作为源目录，输出到 `.zen/dist` 目录。不支持指定源目录和输出目录参数。

package/.zen/src/zh-Hans/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md

@@ -0,0 +1,71 @@
+---
+title: ZEN - 极简主义 Markdown + AI 静态站点构建器
+summary: ZEN 是一个结合 AI 的静态站点生成器，支持智能分类导航和自动增量翻译，让用户专注于用母语写作，简化配置和构建过程。
+tags:
+  - 静态站点生成器
+  - Markdown
+  - AI
+  - 多语言翻译
+  - 极简主义
+  - 文档工具
+  - Node.js
+inferred_lang: zh-Hans
+---
+
+# ZEN - 极简主义 Markdown + AI 静态站点构建器
+
+[> Website Demo](https://zccz14.github.io/ZEN/)
+
+## 基本功能
+
+1. 📃 **静态站点生成**：将任意一个包含 Markdown 的 git 文件夹构建成一个静态 HTML 站点。
+2. 🧭 **智能分类导航**：使用 AI 进行内容分析，生成站点地图和导航，源文件的位置不敏感。
+3. 🌍 **自动增量翻译**：使用 AI 进行增量翻译，让用户使用母语编写 Markdown，但是用户可以是多语言的。
+
+为什么又搞了个 Markdown 静态站点生成器？我重新思考了 AI 时代下，文档工具可以如何更好地服务于写作者：
+
+- 回归内容：最小化打扰，专注写作
+
+  让文档回归本质，让写作回归宁静。
+
+  其一，我不想做图书管理员。我有时想写下一些内容，但我可能还没有想好它的标题，还没有形成特别的组织。我希望 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（用于从 Git 列出 Markdown 文件，忽略 .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 zh-Hans --lang en-US`）。
+- 可以通过 `--base-url` 参数指定站点的基础 URL 前缀（例如 GitHub Pages 上的仓库名）。
+- 不需要配置源语言，ZEN 会自动检测。
+
+```bash
+npx zengen@latest build --lang zh-Hans --lang en-US
+```
+
+**查看更多参数或帮助**：
+
+```bash
+npx zengen@latest
+```

package/.zen/src/zh-Hans/afbf4998656c97181d0edc711e388ad11e0f08f5c6f329861327202462a3a34a.md

@@ -0,0 +1,63 @@
+---
+title: ZEN - Markdown 文档站点构建工具
+summary: ZEN 是一个极简的 Markdown 静态站点生成工具，强调内容优先，通过隐藏配置和 AI 赋能，让用户专注于母语写作，并支持多语言翻译和智能导航。
+tags:
+  - Markdown
+  - 静态站点生成
+  - AI 翻译
+  - 多语言
+  - 极简主义
+  - 内容优先
+  - 文档工具
+inferred_lang: zh-Hans
+---
+
+# ZEN - 简洁的 Markdown 文档站点构建工具
+
+[简体中文](https://zccz14.github.io/ZEN/zh-Hans) | [English](https://zccz14.github.io/ZEN/en-US)
+
+为什么又搞了个 Markdown 静态站点生成器？
+
+- 回归内容：最小化打扰，让您专注写作
+
+  让文档回归本质，让写作回归宁静。我不想要配置复杂的构建工具，折腾复杂的文档配置，不喜欢复杂的结构。每次我看到 Docusaurus、VuePress、Astro 这些工具的配置文件和项目结构，我就头疼。现在，ZEN 选择将所有的配置都隐藏到 .zen 目录下，扫到角落里，用户只需要专注于写作内容，其他的交给 ZEN 来处理。其他的目录都是您的写作空间，您可以随意组织您的 Markdown 文件。LLM 还会自动帮您生成标题、做摘要、分类、生成导航等工作。您真的只需要专注于写作。
+
+- 回归母语：仅用母语写作，丝滑构建多语言版本
+
+  人生苦短，我懒得翻译。人在使用母语时，才是最能发挥自身思考深度的。但同时与世界保持连接又是必要的，我不想放弃多语言的交流。于是我希望有一个工具，能让我用母语写作，同时又能让更多人看到我的内容。现在的 i18n 需要自己翻译不说，还得自己维护内容更新，太麻烦了。我选择使用 LLM 来帮我做翻译，省下了我很多时间，并且可以一键完成多国语言翻译。
+
+## 基本功能
+
+1. **静态站点生成**
+   - 将任意一个包含 Markdown 的文件夹构建成一个静态 HTML 站点
+
+2. **智能导航**
+   - 生成站点地图和导航，不需要保持原始的 Markdown 源文件的目录结构
+
+3. **增量 i18n 翻译**
+   - 使用 LLM 进行增量 i18n 翻译，让用户使用母语编写 Markdown，但是用户可以是多语言的
+
+## 设计理念
+
+- **极简主义**: 最少的配置，最大的灵活性
+- **内容优先**: 专注于写作，而不是工具配置
+- **AI 赋能**: 利用 AI 处理翻译和内容组织
+- **跨语言**: 支持多语言内容创作和展示
+
+## 快速开始
+
+### 推荐使用方式
+
+**推荐用户切换到包含 Markdown 文件的目录下，直接使用以下命令开始构建：**
+
+```bash
+npx zengen build
+```
+
+**查看更多参数或帮助**：
+
+```bash
+npx zengen
+```
+
+**注意**：ZEN 强制使用当前目录作为源目录，输出到 `.zen/dist` 目录。不支持指定源目录和输出目录参数。