zengen 0.2.4 → 0.2.5

package/.zen/src/pt-PT/04319611d7cde718d0e82da8e034e04b15fb3bb37c3784d8f7313577c5178b06.md

@@ -1,73 +0,0 @@
----
-title: ZEN - Ferramenta de Construção de Sites de Documentação em Markdown
-summary: O ZEN é uma ferramenta minimalista de geração de sites estáticos em Markdown, focada na escrita de conteúdo, utilizando IA para processar tradução e navegação, suportando construção multilíngue sem configuração complexa.
-tags:
-  - Markdown
-  - Gerador de Sites Estáticos
-  - Tradução por IA
-  - Multilíngue
-  - Minimalismo
-  - Ferramenta de Documentação
-  - ZEN
-inferred_lang: pt-PT
----
-
-# ZEN - Ferramenta de Construção de Sites de Documentação em Markdown
-
-[简体中文](https://zccz14.github.io/ZEN/zh-Hans) | [English](https://zccz14.github.io/ZEN/en-US)
-
-Por que criar mais um gerador de sites estáticos em Markdown? Refliti sobre como as ferramentas de documentação podem servir melhor os escritores na era da IA:
-
-- **Regresso ao conteúdo**: Minimizar distrações, focar na escrita
-
-  Devolver a essência à documentação e a serenidade à escrita.
-
-  Primeiro, não quero ser um bibliotecário. Às vezes quero escrever algo, mas talvez ainda não tenha pensado no título ou na organização. Quero que um LLM gere automaticamente títulos, resumos, categorias, navegação e outras tarefas de organização.
-
-  Segundo, o meu escritório deve estar arrumado. Não quero ferramentas de construção com configurações complexas, nem estruturas complicadas. Sempre que vejo os ficheiros de configuração e estruturas de projetos de ferramentas como Docusaurus, VuePress ou Astro, fico com dor de cabeça. Agora, o ZEN opta por esconder toda a configuração no diretório `.zen`, varrendo-a para um canto. O utilizador só precisa de se concentrar em escrever o conteúdo; o resto é tratado pelo ZEN. Todos os outros diretórios são o seu espaço de escrita, onde pode organizar os seus ficheiros Markdown como desejar.
-
-- **Regresso à língua materna**: Escrever na língua materna, construir versões multilíngues de forma fluida
-
-  A vida é curta, não tenho paciência para traduzir. É na língua materna que conseguimos expressar a nossa profundidade de pensamento. No entanto, manter a ligação com o mundo é necessário, e não quero abdicar da comunicação multilíngue. Por isso, desejo uma ferramenta que me permita escrever na minha língua materna e, ao mesmo tempo, tornar o meu conteúdo acessível a mais pessoas. Atualmente, a i18n exige que traduzamos e mantenhamos as atualizações de conteúdo, o que é muito trabalhoso. Opto por usar LLM para me ajudar com as traduções, poupando muito tempo e permitindo a tradução para vários idiomas com um único clique.
-
-## Funcionalidades Básicas
-
-1. **Geração de Sites Estáticos**
-   - Constrói um site HTML estático a partir de qualquer pasta que contenha ficheiros Markdown.
-
-2. **Navegação Inteligente**
-   - Gera um mapa do site e navegação, sem necessidade de manter a estrutura de diretórios original dos ficheiros Markdown de origem. Pode mover os ficheiros de origem livremente.
-
-3. **Tradução i18n Incremental**
-   - Utiliza LLM para tradução i18n incremental, permitindo que os utilizadores escrevam Markdown na sua língua materna, mas possam ter conteúdo multilíngue.
-
-## Filosofia de Design
-
-- **Minimalismo**: Configuração mínima, máxima flexibilidade.
-- **Prioridade ao Conteúdo**: Foco na escrita, não na configuração da ferramenta.
-- **Potenciado por IA**: Utiliza IA para processar tradução e organização de conteúdo.
-- **Translinguístico**: Suporta criação e exibição de conteúdo multilíngue.
-
-## Início Rápido
-
-### Modo de Uso Recomendado
-
-**Recomenda-se que os utilizadores mudem para o diretório que contém os ficheiros Markdown e usem diretamente o seguinte comando para começar a construção:**
-
-```bash
-# Definir variáveis de ambiente (modifique conforme a sua situação real)
-export OPENAI_API_KEY="sk-xxxxxx"  # Obrigatório: substitua pela sua chave de API da OpenAI
-export OPENAI_BASE_URL="https://api.openai.com/v1"  # Opcional, usa a API oficial da OpenAI por padrão
-export OPENAI_MODEL="gpt-3.5-turbo"  # Opcional, usa o modelo gpt-3.5-turbo por padrão
-
-# Construir o site, com suporte a tradução multilíngue
-npx zengen@latest build --lang pt-PT --lang en-US --verbose
-```
-
-**Ver mais parâmetros ou ajuda**:
-
-```bash
-npx zengen
-```
-
-**Nota**: O ZEN obriga a usar o diretório atual como diretório de origem, com saída para o diretório `.zen/dist`. Não suporta a especificação de parâmetros de diretório de origem ou de saída.

package/.zen/src/pt-PT/48eb2ad3e174cd06ed16c959fa58e0381dbc4a4147fa3456b21eea2b3d67c329.md

@@ -1,81 +0,0 @@
----
-title: ZEN - Ferramenta de Construção de Sites de Documentação em Markdown
-summary: O ZEN é uma ferramenta de geração de sites estáticos em Markdown, focada na prioridade do conteúdo e no minimalismo. Utiliza IA para navegação inteligente e tradução multilíngue, ajudando os utilizadores a concentrarem-se na escrita sem configurações complexas.
-tags:
-  - Markdown
-  - Geração de Sites Estáticos
-  - Tradução por IA
-  - Multilíngue
-  - Minimalismo
-  - Ferramenta de Documentação
-  - ZEN
-inferred_lang: pt-PT
----
-
-# ZEN - Ferramenta de Construção de Sites de Documentação em 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) |
-
-Porque criar mais um gerador de sites estáticos em Markdown? Refliti sobre como as ferramentas de documentação podem servir melhor os escritores na era da IA:
-
-- **Regresso ao conteúdo**: Minimizar distrações, focar na escrita
-
-  Devolver a essência à documentação, devolver a tranquilidade à escrita.
-
-  Primeiro, não quero ser um bibliotecário. Às vezes quero escrever algo, mas talvez ainda não tenha pensado no título, ou não tenha uma organização específica. Espero que a LLM me ajude automaticamente a gerar títulos, fazer resumos, classificar, navegar e outras tarefas de organização.
-
-  Segundo, o meu escritório tem de estar arrumado. Não quero ferramentas de construção com configurações complexas, não gosto de estruturas complicadas. Sempre que vejo os ficheiros de configuração e a estrutura de projetos de ferramentas como Docusaurus, VuePress, Astro, fico com dor de cabeça. Agora, o ZEN opta por esconder todas as configurações no diretório `.zen`, varrendo-as para um canto. O utilizador só precisa de se concentrar no conteúdo da escrita, o resto é tratado pelo ZEN. Todos os outros diretórios são o seu espaço de escrita, pode organizar os seus ficheiros Markdown como quiser.
-
-- **Regresso à língua materna**: Escrever na língua materna, construir versões multilíngue de forma fluida
-
-  A vida é curta, não tenho paciência para traduzir. É na língua materna que conseguimos explorar melhor a profundidade do nosso pensamento. Mas, ao mesmo tempo, manter a ligação com o mundo é necessário, não quero abdicar da comunicação multilíngue. Por isso, desejo uma ferramenta que me permita escrever na minha língua materna e, ao mesmo tempo, permita que mais pessoas vejam o meu conteúdo. Atualmente, o i18n exige que traduzamos nós próprios e ainda temos de manter as atualizações de conteúdo, é muito trabalhoso. Opto por usar a LLM para me ajudar com as traduções, poupando muito tempo e permitindo a tradução para vários idiomas com um único clique.
-
-## Funcionalidades Básicas
-
-1. **Geração de Sites Estáticos**
-   - Constrói uma pasta qualquer que contenha ficheiros Markdown num site HTML estático.
-
-2. **Navegação Inteligente**
-   - Gera um mapa do site e navegação. Não é necessário manter a estrutura de diretórios original dos ficheiros Markdown de origem; pode mover os ficheiros de origem livremente.
-
-3. **Tradução i18n Incremental**
-   - Utiliza LLM para tradução i18n incremental, permitindo que os utilizadores escrevam Markdown na sua língua materna, mas possam ter conteúdo multilíngue.
-
-## Filosofia de Design
-
-- **Minimalismo**: Configuração mínima, flexibilidade máxima.
-- **Prioridade ao Conteúdo**: Foco na escrita, não na configuração da ferramenta.
-- **Potenciado por IA**: Utiliza IA para processar tradução e organização de conteúdo.
-- **Translinguístico**: Suporta criação e exibição de conteúdo multilíngue.
-
-## Início Rápido
-
-### Modo de Utilização Recomendado
-
-**Recomenda-se que os utilizadores mudem para o diretório que contém os ficheiros Markdown e utilizem diretamente o seguinte comando para começar a construção:**
-
-```bash
-# Definir variáveis de ambiente (modificar de acordo com a sua situação real)
-export OPENAI_API_KEY="sk-xxxxxx"  # Obrigatório: substitua pela sua Chave de API da OpenAI
-export OPENAI_BASE_URL="https://api.openai.com/v1"  # Opcional, por padrão utiliza a API oficial da OpenAI
-export OPENAI_MODEL="gpt-3.5-turbo"  # Opcional, por padrão utiliza o modelo gpt-3.5-turbo
-
-# Construir o site, suporta tradução multilíngue
-npx zengen@latest build --lang pt-PT --lang en-US --verbose
-```
-
-**Ver mais parâmetros ou ajuda**:
-
-```bash
-npx zengen
-```
-
-**Nota**: O ZEN obriga a utilizar o diretório atual como diretório de origem, com saída para o diretório `.zen/dist`. Não suporta a especificação de parâmetros de diretório de origem e diretório de saída.

package/.zen/src/ru-RU/04319611d7cde718d0e82da8e034e04b15fb3bb37c3784d8f7313577c5178b06.md

@@ -1,73 +0,0 @@
----
-title: ZEN - Инструмент для создания сайтов документации на Markdown
-summary: ZEN — это минималистичный генератор статических сайтов на Markdown, ориентированный на написание контента. Использует ИИ для обработки перевода и навигации, поддерживает многоязычную сборку без сложной конфигурации.
-tags:
-  - Markdown
-  - Генератор статических сайтов
-  - ИИ-перевод
-  - Мультиязычность
-  - Минимализм
-  - Инструмент для документации
-  - ZEN
-inferred_lang: ru-RU
----
-
-# ZEN - Простой инструмент для создания сайтов документации на Markdown
-
-[简体中文](https://zccz14.github.io/ZEN/zh-Hans) | [English](https://zccz14.github.io/ZEN/en-US)
-
-Зачем ещё один генератор статических сайтов на Markdown? Я заново обдумал, как инструменты для документации в эпоху ИИ могут лучше служить авторам:
-
-- **Возвращение к содержанию**: Минимизация отвлечений, концентрация на письме
-
-  Вернуть документации её суть, а письму — спокойствие.
-
-  Во-первых, я не хочу быть библиотекарем. Иногда я хочу что-то записать, но, возможно, ещё не придумал заголовок или не сформировал чёткую структуру. Я хочу, чтобы LLM автоматически генерировала для меня заголовки, делала резюме, классифицировала, создавала навигацию и другую организационную работу.
-
-  Во-вторых, мой кабинет должен быть чистым. Мне не нужны инструменты сборки со сложной конфигурацией, возня со сложными настройками документации, не нравятся сложные структуры. Каждый раз, когда я вижу конфигурационные файлы и структуру проектов таких инструментов, как Docusaurus, VuePress, Astro, у меня начинает болеть голова. Теперь ZEN прячет всю конфигурацию в каталог `.zen`, сметает её в угол. Пользователю нужно сосредоточиться только на написании контента, всё остальное ZEN берёт на себя. Все остальные каталоги — это ваше рабочее пространство, вы можете организовывать свои Markdown-файлы как угодно.
-
-- **Возвращение к родному языку**: Пишите на родном языке, плавно создавайте многоязычные версии
-
-  Жизнь коротка, мне лень переводить. Человек наиболее полно раскрывает глубину своего мышления, используя родной язык. Но при этом оставаться на связи с миром необходимо, я не хочу отказываться от многоязычного общения. Поэтому мне хотелось бы иметь инструмент, который позволил бы мне писать на родном языке и одновременно сделать мой контент доступным для большего числа людей. Современные решения i18n требуют не только самостоятельного перевода, но и поддержания актуальности контента, что слишком хлопотно. Я выбираю использование LLM для перевода, что экономит мне массу времени и позволяет выполнить перевод на множество языков одним нажатием.
-
-## Основные возможности
-
-1. **Генерация статического сайта**
-   - Преобразует любую папку с Markdown-файлами в статический HTML-сайт.
-
-2. **Интеллектуальная навигация**
-   - Генерирует карту сайта и навигацию. Не требуется сохранять исходную структуру каталогов Markdown-файлов, исходные файлы можно свободно перемещать.
-
-3. **Инкрементный i18n-перевод**
-   - Использует LLM для инкрементного i18n-перевода, позволяя пользователю писать Markdown на родном языке, но при этом быть многоязычным.
-
-## Философия дизайна
-
-- **Минимализм**: Минимум конфигурации, максимум гибкости.
-- **Приоритет контента**: Сосредоточьтесь на письме, а не на настройке инструментов.
-- **Расширение возможностей с помощью ИИ**: Использование ИИ для обработки перевода и организации контента.
-- **Кросс-язычность**: Поддержка создания и отображения многоязычного контента.
-
-## Быстрый старт
-
-### Рекомендуемый способ использования
-
-**Рекомендуется перейти в каталог, содержащий 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/ru-RU/48eb2ad3e174cd06ed16c959fa58e0381dbc4a4147fa3456b21eea2b3d67c329.md

@@ -1,81 +0,0 @@
----
-title: ZEN - Инструмент для создания сайтов документации на Markdown
-summary: ZEN — это простой генератор статических сайтов на Markdown, ориентированный на контент и минимализм. Использует ИИ для интеллектуальной навигации и многоязычного перевода, помогая пользователям сосредоточиться на написании текстов без сложных настроек.
-tags:
-  - Markdown
-  - Генератор статических сайтов
-  - ИИ-перевод
-  - Многоязычность
-  - Минимализм
-  - Инструмент для документации
-  - ZEN
-inferred_lang: ru-RU
----
-
-# 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? Я задумался о том, как инструменты для документации могут лучше служить авторам в эпоху ИИ:
-
-- **Возвращение к контенту**: Минимизация отвлекающих факторов, фокус на написании
-
-  Вернуть документации её суть, а написанию — спокойствие.
-
-  Во-первых, я не хочу быть библиотекарем. Иногда я хочу что-то записать, но, возможно, ещё не придумал заголовок или не организовал это должным образом. Я хочу, чтобы LLM автоматически генерировала заголовки, делала резюме, классифицировала, создавала навигацию и выполняла другую организационную работу.
-
-  Во-вторых, мой рабочий кабинет должен быть чистым. Мне не нужны сложные инструменты сборки с запутанными конфигурациями, не нравятся сложные структуры. Каждый раз, когда я вижу конфигурационные файлы и структуру проектов таких инструментов, как Docusaurus, VuePress, Astro, у меня начинает болеть голова. Теперь ZEN прячет все настройки в каталог `.zen`, сметает их в угол. Пользователю нужно сосредоточиться только на содержании, а всё остальное ZEN берёт на себя. Все остальные каталоги — это ваше рабочее пространство, вы можете свободно организовывать свои Markdown-файлы.
-
-- **Возвращение к родному языку**: Пишите на родном языке, плавно создавайте многоязычные версии
-
-  Жизнь коротка, мне лень переводить. Человек наиболее полно раскрывает глубину своего мышления, используя родной язык. Но при этом оставаться на связи с миром необходимо, и я не хочу отказываться от многоязычного общения. Поэтому мне хотелось бы иметь инструмент, который позволил бы мне писать на родном языке, но при этом сделать мой контент доступным для большего числа людей. Текущие решения i18n требуют не только самостоятельного перевода, но и поддержания актуальности контента, что слишком хлопотно. Я выбрал использование LLM для перевода, что экономит мне много времени и позволяет выполнить перевод на множество языков одним нажатием кнопки.
-
-## Основные возможности
-
-1.  **Генерация статического сайта**
-    - Преобразует любую папку с Markdown-файлами в статический HTML-сайт.
-
-2.  **Интеллектуальная навигация**
-    - Генерирует карту сайта и навигацию. Не требуется сохранять исходную структуру каталогов Markdown-файлов, исходные файлы можно свободно перемещать.
-
-3.  **Инкрементный i18n-перевод**
-    - Использует LLM для инкрементного i18n-перевода, позволяя пользователям писать Markdown на родном языке, но при этом создавать многоязычный контент.
-
-## Философия дизайна
-
-- **Минимализм**: Минимум настроек, максимум гибкости.
-- **Приоритет контента**: Фокус на написании, а не на настройке инструментов.
-- **ИИ-возможности**: Использование ИИ для обработки перевода и организации контента.
-- **Кросс-язычность**: Поддержка создания и отображения многоязычного контента.
-
-## Быстрый старт
-
-### Рекомендуемый способ использования
-
-**Рекомендуется перейти в каталог, содержащий Markdown-файлы, и сразу начать сборку с помощью следующей команды:**
-
-```bash
-# Установите переменные окружения (измените в соответствии с вашей ситуацией)
-export OPENAI_API_KEY="sk-xxxxxx"  # Обязательно: замените на ваш OpenAI API Key
-export OPENAI_BASE_URL="https://api.openai.com/v1"  # Опционально, по умолчанию используется официальный API OpenAI
-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/01d04f7c17b4a541ead9d759d877b30b403e15b849182a49eb1f62bd29ecd18c.md

@@ -1,120 +0,0 @@
----
-title: GitHub Pages 部署配置
-summary: 本文档介绍了 ZEN 项目文档站点的 GitHub Pages 部署配置，包括工作流程、触发条件、构建步骤、自定义配置、故障排除和手动触发方法。
-tags:
-  - GitHub Pages
-  - 部署配置
-  - 工作流程
-  - 文档构建
-  - 故障排除
-  - ZEN 项目
-inferred_lang: zh-Hans
----
-
-# GitHub Pages 部署配置
-
-此目录包含 ZEN 项目文档站点的 GitHub Pages 部署配置。
-
-## 工作流程
-
-### `pages.yml`
-
-此工作流程会自动构建 ZEN 项目的文档站点并部署到 GitHub Pages。
-
-**触发条件：**
-
-- 推送到 `main` 分支（当 `demo/src/`、`package.json` 或工作流程文件发生变化时）
-- 针对 `main` 分支的 Pull Request
-- 手动触发
-
-**工作流程步骤：**
-
-1. **检出代码**：从远程分支检出代码，确保代码同步
-2. **设置 Node.js**：配置 Node.js 20.x 环境
-3. **安装依赖**：使用 `npm ci` 安装项目依赖
-4. **构建 zengen**：构建本地 zengen 包
-5. **安装 zengen**：将本地构建的 zengen 安装为全局工具
-6. **测试 zengen CLI**：验证 CLI 工具正常工作
-7. **构建文档站点**：使用 `cd demo/src && zengen build` 构建文档，输出到 `.zen/dist` 目录
-8. **配置 Pages**：设置 GitHub Pages
-9. **上传制品**：将构建的文档站点上传为 Pages 制品
-10. **部署到 GitHub Pages**：自动部署到 GitHub Pages
-
-## 访问文档站点
-
-部署成功后，文档站点将可通过以下 URL 访问：
-
-```
-https://[用户名].github.io/[仓库名]/
-```
-
-## 自定义配置
-
-### 自定义域名
-
-如果需要使用自定义域名，可以在构建步骤后添加 CNAME 文件：
-
-```yaml
-# 创建 CNAME 文件（如果需要自定义域名）
-echo "docs.example.com" > docs-dist/CNAME
-```
-
-### 构建选项
-
-当前使用的构建命令：
-
-```bash
-cd demo/src
-zengen build --verbose
-```
-
-可用的选项：
-
-- `--verbose`：显示详细输出
-- `--watch`：监听模式（不适用于 CI/CD）
-- `--template`：指定自定义模板文件
-- `--config`：指定配置文件
-
-### 环境变量
-
-工作流程使用以下环境变量：
-
-- `GITHUB_TOKEN`：自动提供的 GitHub 令牌
-- `NODE_VERSION`：Node.js 版本（默认为 20.x）
-
-## 故障排除
-
-### 构建失败
-
-1. **检查 Node.js 版本**：确保使用支持的 Node.js 版本
-2. **验证依赖安装**：确保 `npm ci` 成功执行
-3. **检查构建输出**：查看 `zengen build` 的详细输出
-4. **CLI 输出目录问题**：ZEN 现在强制输出到 `.zen/dist` 目录，不再支持 `--out` 参数。
-
-### 部署失败
-
-1. **检查权限**：确保工作流程有正确的 Pages 写入权限
-2. **验证制品**：确保 `.zen/dist` 目录包含有效的 HTML 文件
-3. **查看日志**：检查 GitHub Actions 日志获取详细错误信息
-
-### 文档未更新
-
-1. **检查触发条件**：确保修改了 `demo/src/` 目录下的文件
-2. **等待部署完成**：GitHub Pages 部署可能需要几分钟
-3. **清除浏览器缓存**：浏览器可能缓存了旧版本
-
-## 手动触发
-
-可以通过 GitHub Actions 界面手动触发部署：
-
-1. 进入仓库的 "Actions" 标签页
-2. 选择 "Deploy to GitHub Pages" 工作流程
-3. 点击 "Run workflow" 按钮
-4. 选择分支并运行
-
-## 相关文件
-
-- `demo/src/`：文档源文件（Markdown 格式）
-- `package.json`：项目配置和依赖
-- `src/cli.ts`：zengen CLI 工具实现
-- `src/builder.ts`：文档构建器实现

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

@@ -1,73 +0,0 @@
----
-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

@@ -1,80 +0,0 @@
----
-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` 目录。不支持指定源目录和输出目录参数。