zengen 0.2.1 → 0.2.3

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/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/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.

package/.zen/src/es-ES/48eb2ad3e174cd06ed16c959fa58e0381dbc4a4147fa3456b21eea2b3d67c329.md

@@ -0,0 +1,81 @@
+---
+title: ZEN - Herramienta de construcción de sitios de documentación en Markdown
+summary: ZEN es una herramienta de generación de sitios estáticos en Markdown, sencilla y centrada en el contenido y el minimalismo. Utiliza IA para una navegación inteligente y traducción multilingüe, ayudando a los usuarios a concentrarse en la escritura sin configuraciones complejas.
+tags:
+  - Markdown
+  - Generación de sitios estáticos
+  - Traducción con IA
+  - Multilingüe
+  - Minimalismo
+  - Herramienta de documentación
+  - ZEN
+inferred_lang: es-ES
+---
+
+# ZEN - Herramienta de construcción de 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) |
+[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) |
+
+¿Por qué crear otro generador de sitios estáticos en 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 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, no he formado una organización particular. Espero que la 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 limpio y ordenado. No quiero herramientas de construcción con configuraciones complejas, lidiar con 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, Astro, me duele la cabeza. Ahora, ZEN elige ocultar toda la configuración en el directorio `.zen`, barrerla a un rincón. El usuario solo necesita concentrarse en escribir el contenido, y ZEN se encarga del resto. 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 de forma fluida
+
+  La vida es corta, soy demasiado perezoso para traducir. Cuando una persona usa su lengua materna, es cuando puede aprovechar al máximo la profundidad de su pensamiento. Pero al mismo tiempo, mantener la conexión con el mundo es necesario, 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, permita que más personas vean mi contenido. La i18n actual no solo requiere que uno traduzca por sí mismo, sino que también debe mantener actualizado el contenido, es demasiado engorroso. Elijo usar LLM para ayudarme con la traducción, ahorrándome mucho tiempo y pudiendo completar la traducción 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 HTML estático.
+
+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; se pueden mover libremente.
+
+3. **Traducción i18n incremental**
+   - Utiliza LLM para realizar traducciones i18n incrementales, permitiendo a los usuarios escribir Markdown en su lengua materna, pero siendo multilingües.
+
+## 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 IA para manejar traducciones y organización de 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 los usuarios cambien al directorio que contiene los archivos Markdown y utilicen 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 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
+
+# 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 va al directorio `.zen/dist`. No admite parámetros para especificar directorios de origen o de salida.

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