czon 0.1.0 → 0.1.1

package/.zen/src/en-US/579c3a203225b8b7aead541f42381de0619d8bc1d451d0d9c3267dbc74205503.md

@@ -0,0 +1,79 @@
+---
+'title': 'KaTeX Formula Display Test'
+'summary': 'This document is an example for testing KaTeX formula display, containing multiple inline and block-level mathematical formulas such as E=mc^2, integrals, derivatives, series, piecewise functions, tables, matrices, etc., aimed at verifying correct formula rendering.'
+'tags':
+  - 'KaTeX'
+  - 'Formula Test'
+  - 'Mathematical Formulas'
+  - 'LaTeX'
+  - 'Display Effect'
+  - 'Document Example'
+'inferred_lang': 'en-US'
+---
+
+# KaTeX Formula Display Test
+
+This is an inline formula test: $ E = mc^2 $.
+
+This is a block-level formula test:
+
+$$
+\int_a^b f(x) \, dx = F(b) - F(a)
+$$
+
+This is another block-level formula test:
+
+$$
+\frac{d}{dx}e^x = e^x
+$$
+
+This is a complex formula test:
+
+$$
+\sum_{n=1}^{\infty} \frac{1}{n^2} = \frac{\pi^2}{6}
+$$
+
+Formula test with cases:
+
+$$
+f(x) =
+\begin{cases}
+x^2 & \text{if } x \geq 0 \\
+-x & \text{if } x < 0
+\end{cases}
+$$
+
+Table formula:
+
+$$
+\begin{array}{c|c|c}
+a & b & c \\
+\hline
+1 & 2 & 3 \\
+4 & 5 & 6 \\
+\end{array}
+$$
+
+Matrix formula:
+
+$$
+\begin{pmatrix}
+1 & 2 \\
+3 & 4
+\end{pmatrix}
+$$
+
+Formula test containing text:
+
+$$
+E = mc^2 \quad \text{where } m \text{ is mass and
+    } c \text{ is the speed of light}
+$$
+
+Generalized Kelly formula:
+
+$$
+f^* = \argmax_f \sum_{i \in X} P_i \ln (1 + f \cdot R_i)
+$$
+
+Please ensure all the above formulas display correctly.

package/.zen/src/en-US/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md

@@ -0,0 +1,70 @@
+---
+'title': 'ZEN - Minimalist Markdown + AI Static Site Builder'
+'summary': 'ZEN is an AI-powered static site generator focused on simplifying documentation writing and building. It allows users to create static HTML sites from git-managed folders using Markdown, with no complex configuration—all settings are hidden in the .zen directory. Core features include intelligent categorization and navigation (generating site maps via AI content analysis), automatic incremental translation (supporting multilingual versions, enabling users to write in their native language while AI handles translation), and a minimally disruptive writing experience. The tool relies on Node.js, an OpenAI API Key, and Git, enabling quick builds via the command line and supporting language parameters such as zh-Hans and en-US.'
+'tags':
+  - 'Static Site Generator'
+  - 'Markdown'
+  - 'AI'
+  - 'Multilingual Translation'
+  - 'Minimalism'
+  - 'Documentation Tool'
+  - 'ZEN'
+'inferred_lang': 'zh-Hans'
+---
+
+# ZEN - Minimalist Markdown + AI Static Site Builder
+
+[> Website Demo](https://zen.zccz14.com/)
+
+## Core Features
+
+1. 📃 **Static Site Generation**: Build a static HTML site from any git-managed folder containing Markdown files.
+2. 🧭 **Intelligent Categorization and Navigation**: Use AI to analyze content, generating site maps and navigation independent of source file locations.
+3. 🌍 **Automatic Incremental Translation**: Use AI for incremental translation, allowing users to write Markdown in their native language while supporting multilingual output.
+
+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**
+
+  Bring documentation back to its essence and restore tranquility to writing.
+
+  First, I don’t want to be a librarian. Sometimes I want to jot down ideas without having finalized titles or organized structures. I want LLMs to automatically generate titles, summaries, categories, navigation, and other organizational tasks.
+
+  Second, my workspace must stay clean. I don’t want complex build tools, intricate documentation configurations, or convoluted structures. Tools like Docusaurus, VuePress, and Astro with their configuration files and project structures give me a headache. ZEN hides all configurations in the `.zen` directory, tucked away in a corner. Users can focus solely on writing content, leaving the rest to ZEN. All other directories are your writing space—organize your Markdown files however you like.
+
+- **Return to Native Language: Write in Your Mother Tongue, Seamlessly Build Multilingual Versions**
+
+  Life is short; I can’t be bothered with translation. People think most deeply when using their native language. Yet, staying connected to the world is essential—I don’t want to give up multilingual communication. I wanted a tool that lets me write in my native language while making my content accessible to more people. Traditional i18n requires manual translation and content maintenance, which is too cumbersome. I chose to use LLMs for translation, saving significant time and enabling one-click multilingual translation.
+
+## Quick Start
+
+Prerequisites:
+
+- [Node.js](https://nodejs.org/) installed (version 18 or higher recommended, with `npx` command available)
+- An [OpenAI API Key](https://platform.openai.com/account/api-keys) or compatible OpenAI 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 OpenAI's official 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. Use the current directory as the source and output to the `.zen/dist` directory.
+
+- Specify language versions using the `--lang` parameter multiple times (e.g., `--lang zh-Hans --lang en-US`).
+- No need to configure the source language—ZEN automatically detects 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/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md

@@ -0,0 +1,71 @@
+---
+'title': 'ZEN - A Minimalist Markdown + AI Static Site Builder'
+'summary': 'ZEN is a static site generator with AI capabilities, designed to simplify the process of writing documentation and building websites. It allows users to focus on writing Markdown content in their native language, automatically handling title generation, categorized navigation, and incremental translation. It supports multilingual versions without complex configuration. Built on Node.js and the OpenAI API, it enables rapid site construction via the command line, making it ideal for writers who value efficiency and simplicity.'
+'tags':
+  - 'Static Site Generator'
+  - 'Markdown'
+  - 'AI'
+  - 'Minimalism'
+  - 'Multilingual Translation'
+  - 'Node.js'
+  - 'OpenAI'
+'inferred_lang': 'zh-Hans'
+---
+
+# ZEN - A Minimalist Markdown + AI Static Site Builder
+
+[> Website Demo](https://zccz14.github.io/ZEN/)
+
+## Core Features
+
+1. 📃 **Static Site Generation**: Build a static HTML site from any git-managed folder containing Markdown files.
+2. 🧭 **Intelligent Categorized Navigation**: Use AI to analyze content, generating a site map and navigation that is independent of the original file structure.
+3. 🌍 **Automatic Incremental Translation**: Use 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**
+
+  Bring documentation back to its essence and restore tranquility to the writing process.
+
+  First, I don't want to be a librarian. Sometimes I want to jot down ideas before I've settled on a title or organized them fully. I want an LLM to automatically generate titles, create summaries, categorize content, and handle navigation.
+
+  Second, my workspace must stay clean. I don't want complex build tools, intricate documentation configurations, or convoluted structures. Tools like Docusaurus, VuePress, and Astro often overwhelm me with their configuration files and project layouts. ZEN hides all configuration in a `.zen` directory, tucked out of sight. Users can focus solely on writing, leaving the rest to ZEN. All other directories are your writing space—organize your Markdown files however you like.
+
+- **Return to Native Language: Write in Your Mother Tongue, Seamlessly Build Multilingual Versions**
+
+  Life is short; I don't want to translate. People think most deeply in their native language. Yet, staying connected to the world is essential—I don't want to give up multilingual communication. I needed 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 ongoing content maintenance, which is too cumbersome. I chose to use LLMs for translation, saving significant time and enabling one-click multilingual support.
+
+## Quick Start
+
+Prerequisites:
+
+- [Node.js](https://nodejs.org/) installed (version 18 or higher recommended, with `npx` command available)
+- An [OpenAI API Key](https://platform.openai.com/account/api-keys) or a compatible OpenAI API key
+- Git installed (used to list Markdown files from a Git repository, 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. Use the current directory as the source and output to the `.zen/dist` directory.
+
+- Specify language versions using the `--lang` parameter multiple times (e.g., `--lang zh-Hans --lang en-US`).
+- Set the site's base URL prefix with the `--base-url` parameter (e.g., for a GitHub Pages repository name).
+- No need to configure the source language—ZEN detects it automatically.
+
+```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/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md

@@ -0,0 +1,71 @@
+---
+'title': 'ZEN - Minimalist Markdown + AI Static Site Builder'
+'summary': 'ZEN is a static site generator with AI capabilities, designed specifically for Markdown documents. It allows users to convert a Git folder containing Markdown files into a static HTML site without complex configuration—all settings are hidden in the .zen directory. Core features include intelligent categorization and navigation (using AI to analyze content and generate a sitemap), automatic incremental translation (supporting multilingual versions, enabling users to write in their native language with AI handling translation), and a minimally disruptive writing experience. The quick start guide requires installing Node.js, obtaining an OpenAI API Key and Git, building the site via the command line, and supports specifying languages and base URLs.'
+'tags':
+  - 'Static Site Generator'
+  - 'Markdown'
+  - 'AI'
+  - 'Multilingual Translation'
+  - 'Minimalism'
+  - 'Documentation Tool'
+  - 'Git'
+'inferred_lang': 'zh-Hans'
+---
+
+# ZEN - Minimalist Markdown + AI Static Site Builder
+
+[> Website Demo](https://zen.zccz14.com/)
+
+## Core Features
+
+1. 📃 **Static Site Generation**: Build any Git folder containing Markdown files into a static HTML site.
+2. 🧭 **Intelligent Categorization and Navigation**: Uses AI to analyze content, generating a sitemap and navigation that is insensitive to source file locations.
+3. 🌍 **Automatic Incremental Translation**: Uses AI for incremental translation, allowing users to write Markdown in their native language while supporting multilingual output.
+
+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**
+
+  Bring documentation back to its essence and restore tranquility to writing.
+
+  First, I don't want to be a librarian. Sometimes I want to jot down ideas without having finalized titles or organizational structures. I want LLMs to automatically generate titles, summaries, categories, navigation, and other organizational tasks.
+
+  Second, my workspace must stay clean. I don't want complex build tools, cumbersome documentation configurations, or intricate structures. Every time I see the configuration files and project structures of tools like Docusaurus, VuePress, or Astro, I get a headache. Now, ZEN hides all configurations in the `.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—organize your Markdown files freely.
+
+- **Return to Native Language: Write in Your Mother Tongue, Seamlessly Build Multilingual Versions**
+
+  Life is short; I can't be bothered with translation. People express their deepest thoughts best in their native language. Yet, staying connected to the world is essential, and I don't want to give up multilingual communication. I wanted 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 maintenance, which is too cumbersome. I chose to use LLMs for translation, saving significant time and enabling one-click multilingual translation.
+
+## Quick Start
+
+Prerequisites:
+
+- [Node.js](https://nodejs.org/) installed (version 18 or higher recommended, with `npx` command available)
+- [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 in 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 OpenAI's official 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 with the `--base-url` parameter (e.g., a repository name on GitHub Pages).
+- No need to configure the source language; ZEN automatically detects 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/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md

@@ -0,0 +1,30 @@
+---
+'title': 'ZEN Documentation Date Declaration Usage Tips'
+'summary': "This document introduces the technique of declaring dates directly within the body text using the ZEN tool. It contrasts this with the traditional Markdown method of declaring dates via YAML Frontmatter, highlighting ZEN's automatic recognition and intelligent processing capabilities. This approach enhances the user experience and is suitable for content types like diaries and blogs that require a timeline."
+'tags':
+  - 'ZEN'
+  - 'Date Declaration'
+  - 'Markdown'
+  - 'AI Processing'
+  - 'Timeline'
+  - 'User Experience'
+  - 'Document Management'
+'inferred_date': '2026-01-08'
+'inferred_lang': 'zh-Hans'
+---
+
+# Usage Tips
+
+## Declaring Dates in the Body Text
+
+Within the body text, you can use date declarations like "Today is January 8, 2026" (the format style is flexible), and ZEN will automatically recognize and process it.
+
+Traditional Markdown documents declare dates through YAML Frontmatter, which requires remembering the corresponding field; otherwise, the date may not be correctly identified.
+
+ZEN supports declaring dates directly within the body text, avoiding the issue of forgetting to fill in the Frontmatter field.
+
+The AI will automatically extract and infer date information from the body text and process it as the document's creation date.
+
+This method is more flexible and intelligent, enhancing the user experience.
+
+As a side note, documents with dates can generate a timeline view, making browsing and management easier. This is particularly suitable for content types like diaries and blogs that require a timeline.

package/.zen/src/es-ES/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md

@@ -0,0 +1,121 @@
+---
+'title': 'Documento de Prueba de Diagramas Mermaid'
+'summary': 'Este documento es un archivo de prueba para verificar la funcionalidad de renderizado de diagramas Mermaid en ZEN. Incluye ejemplos de varios tipos de diagramas Mermaid, como diagramas de flujo, diagramas de secuencia, diagramas de Gantt, diagramas de clases, diagramas de estado y gráficos circulares, además de una prueba de sintaxis errónea para comprobar la visualización de mensajes de error. El documento tiene como objetivo demostrar el funcionamiento correcto de la integración de Mermaid en ZEN.'
+'tags':
+  - 'Mermaid'
+  - 'Prueba de diagramas'
+  - 'ZEN'
+  - 'Diagrama de flujo'
+  - 'Diagrama de secuencia'
+  - 'Diagrama de Gantt'
+  - 'Diagrama de clases'
+  - 'Diagrama de estado'
+'inferred_date': '2024-01-01'
+'inferred_lang': 'es-ES'
+---
+
+# Prueba de Diagramas Mermaid
+
+Este es un archivo de prueba para verificar la funcionalidad de renderizado de diagramas Mermaid en ZEN.
+
+## Ejemplo de Diagrama de Flujo
+
+```mermaid
+graph TD
+    A[Inicio] --> B{¿Continuar?}
+    B -->|Sí| C[Ejecutar acción]
+    B -->|No| D[Fin]
+    C --> E[Verificar resultado]
+    E --> F{¿Éxito?}
+    F -->|Sí| G[Completado]
+    F -->|No| H[Reintentar]
+    H --> C
+    G --> D
+```
+
+## Ejemplo de Diagrama de Secuencia
+
+```mermaid
+sequenceDiagram
+    participant Usuario
+    participant Sistema
+    participant BaseDeDatos
+
+    Usuario->>Sistema: Enviar solicitud
+    Sistema->>BaseDeDatos: Consultar datos
+    BaseDeDatos-->>Sistema: Devolver resultados
+    Sistema-->>Usuario: Mostrar resultados
+```
+
+## Ejemplo de Diagrama de Gantt
+
+```mermaid
+gantt
+    title Cronograma del Proyecto
+    dateFormat  YYYY-MM-DD
+    section Diseño
+    Análisis de requisitos     :done,    des1, 2024-01-01, 7d
+    Diseño de prototipo        :active,  des2, 2024-01-08, 5d
+    Diseño detallado           :         des3, after des2, 5d
+    section Desarrollo
+    Desarrollo frontend        :         dev1, after des3, 10d
+    Desarrollo backend         :         dev2, after des3, 15d
+    section Pruebas
+    Pruebas unitarias          :         test1, after dev1, 5d
+    Pruebas de integración     :         test2, after dev2, 5d
+```
+
+## Ejemplo de Diagrama de Clases
+
+```mermaid
+classDiagram
+    class Animal {
+        +String nombre
+        +int edad
+        +void comer()
+        +void dormir()
+    }
+    class Perro {
+        +void ladrar()
+    }
+    class Gato {
+        +void maullar()
+    }
+
+    Animal <|-- Perro
+    Animal <|-- Gato
+```
+
+## Ejemplo de Diagrama de Estado
+
+```mermaid
+stateDiagram-v2
+    [*] --> Inactivo
+    Inactivo --> Procesando : Iniciar procesamiento
+    Procesando --> Éxito : Procesamiento exitoso
+    Procesando --> Error : Fallo en el procesamiento
+    Éxito --> [*]
+    Error --> [*]
+```
+
+## Ejemplo de Gráfico Circular
+
+```mermaid
+pie title Uso de Navegadores
+    "Chrome" : 65.2
+    "Firefox" : 15.3
+    "Safari" : 12.5
+    "Edge" : 5.2
+    "Otros" : 1.8
+```
+
+## Prueba de Sintaxis Errónea (debería mostrar un mensaje de error)
+
+```mermaid
+graph TD
+    A --> B
+    // Falta definición de flecha aquí
+    C --> D
+```
+
+Este archivo de prueba incluye varios tipos de diagramas Mermaid para verificar que la integración de Mermaid en ZEN funcione correctamente.

package/.zen/src/es-ES/579c3a203225b8b7aead541f42381de0619d8bc1d451d0d9c3267dbc74205503.md

@@ -0,0 +1,78 @@
+---
+'title': 'Prueba de visualización de fórmulas KaTeX'
+'summary': 'Este documento es un ejemplo para probar la visualización de fórmulas KaTeX, incluyendo múltiples fórmulas matemáticas en línea y en bloque, como E=mc^2, integrales, derivadas, series, funciones definidas por partes, tablas, matrices, etc., con el objetivo de verificar la renderización correcta de las fórmulas.'
+'tags':
+  - 'KaTeX'
+  - 'prueba de fórmulas'
+  - 'fórmulas matemáticas'
+  - 'LaTeX'
+  - 'visualización'
+  - 'ejemplo de documento'
+'inferred_lang': 'es-ES'
+---
+
+# Prueba de visualización de fórmulas KaTeX
+
+Esta es una prueba de fórmula en línea: $ E = mc^2 $.
+
+Esta es una prueba de fórmula en bloque:
+
+$$
+\int_a^b f(x) \, dx = F(b) - F(a)
+$$
+
+Esta es otra prueba de fórmula en bloque:
+
+$$
+\frac{d}{dx}e^x = e^x
+$$
+
+Esta es una prueba de fórmula compleja:
+
+$$
+\sum_{n=1}^{\infty} \frac{1}{n^2} = \frac{\pi^2}{6}
+$$
+
+Prueba de fórmula con casos:
+
+$$
+f(x) =
+\begin{cases}
+x^2 & \text{si } x \geq 0 \\
+-x & \text{si } x < 0
+\end{cases}
+$$
+
+Fórmula con tabla:
+
+$$
+\begin{array}{c|c|c}
+a & b & c \\
+\hline
+1 & 2 & 3 \\
+4 & 5 & 6 \\
+\end{array}
+$$
+
+Fórmula con matriz:
+
+$$
+\begin{pmatrix}
+1 & 2 \\
+3 & 4
+\end{pmatrix}
+$$
+
+Prueba de fórmula con texto:
+
+$$
+E = mc^2 \quad \text{donde } m \text{ es la masa y } c \text{ es la velocidad de la luz}
+$$
+
+Fórmula generalizada de Kelly:
+
+$$
+f^* = \argmax_f \sum_{i \in X} P_i \ln (1 + f \cdot R_i)
+$$
+
+Por favor, asegúrate de que todas las fórmulas anteriores se muestren correctamente.

package/.zen/src/es-ES/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md

@@ -0,0 +1,70 @@
+---
+'title': 'ZEN - Generador de sitios estáticos minimalista con Markdown + IA'
+'summary': 'ZEN es un generador de sitios estáticos con IA integrada, enfocado en simplificar la escritura de documentación y el proceso de construcción. Permite a los usuarios crear sitios HTML estáticos usando Markdown en carpetas gestionadas por git, sin configuraciones complejas; toda la configuración se oculta en el directorio .zen. Sus funciones principales incluyen navegación por categorización inteligente (genera mapas del sitio mediante análisis de contenido con IA), traducción automática incremental (soporta versiones multilingüe, los usuarios pueden escribir en su idioma nativo y la IA maneja la traducción), y una experiencia de escritura con mínimas interrupciones. La herramienta depende de Node.js, una clave API de OpenAI y Git, se construye rápidamente mediante línea de comandos y admite parámetros de idioma como zh-Hans y en-US.'
+'tags':
+  - 'Generador de sitios estáticos'
+  - 'Markdown'
+  - 'IA'
+  - 'Traducción multilingüe'
+  - 'Minimalismo'
+  - 'Herramienta de documentación'
+  - 'ZEN'
+'inferred_lang': 'zh-Hans'
+---
+
+# ZEN - Generador de sitios estáticos minimalista con Markdown + IA
+
+[> Demostración del sitio web](https://zen.zccz14.com/)
+
+## Funcionalidades básicas
+
+1. 📃 **Generación de sitios estáticos**: Convierte cualquier carpeta gestionada por git que contenga Markdown en un sitio HTML estático.
+2. 🧭 **Navegación por categorización 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 automática incremental**: Emplea IA para realizar traducciones incrementales, permitiendo a los usuarios escribir Markdown en su idioma nativo, pero con soporte multilingüe.
+
+¿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 interrupciones, 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 he organizado bien las ideas. Me gustaría que un LLM me ayudara automáticamente a generar títulos, resúmenes, categorías, navegación y otras tareas de organización.
+
+  Segundo, mi espacio de trabajo 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, barriéndola bajo la alfombra, para que el usuario solo se concentre 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 libremente.
+
+- **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, y no quiero renunciar a la comunicación multilingüe. Por eso, deseaba una herramienta que me permitiera escribir en mi idioma nativo y, a la vez, llegar a más personas con mi contenido. Los sistemas actuales de i18n no solo requieren 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 las traducciones, 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 Git, ignorando los filtrados por reglas de .gitignore)
+
+Primero, trabaje en una carpeta ya gestionada por git:
+
+Configure las variables de entorno:
+
+```bash
+export OPENAI_API_KEY="sk-xxxxxx"  # Obligatorio: reemplace 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. Use el directorio actual como fuente y genere la salida en el directorio `.zen/dist`.
+
+- Puede especificar las versiones de idioma que desea generar usando múltiples veces el parámetro `--lang` (por ejemplo, `--lang zh-Hans --lang en-US`).
+- No es necesario configurar el idioma fuente; ZEN lo detectará automáticamente.
+
+```bash
+npx zengen@latest build --lang zh-Hans --lang en-US
+```
+
+**Ver más parámetros o ayuda**:
+
+```bash
+npx zengen@latest
+```

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

@@ -0,0 +1,71 @@
+---
+'title': 'ZEN - Generador de sitios estáticos minimalista con Markdown + IA'
+'summary': 'ZEN es un generador de sitios estáticos con funciones de IA, diseñado para simplificar la escritura de documentación y la construcción de sitios. Permite a los usuarios centrarse en escribir contenido en Markdown en su idioma nativo, gestionando automáticamente la generación de títulos, navegación por categorías y traducción incremental, con soporte para versiones multilingües sin configuración compleja. Basado en Node.js y la API de OpenAI, construye sitios rápidamente desde la línea de comandos, ideal para escritores que buscan eficiencia y simplicidad.'
+'tags':
+  - 'Generador de sitios estáticos'
+  - 'Markdown'
+  - 'IA'
+  - 'Minimalismo'
+  - 'Traducción multilingüe'
+  - 'Node.js'
+  - 'OpenAI'
+'inferred_lang': 'zh-Hans'
+---
+
+# 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**: Convierte cualquier carpeta git con archivos Markdown en un sitio HTML estático.
+2. 🧭 **Navegación inteligente por categorías**: Utiliza IA para analizar el contenido, generando mapas del sitio y navegación, independientemente de la ubicación de los archivos fuente.
+3. 🌍 **Traducción incremental automática**: Emplea IA para traducciones incrementales, permitiendo a los usuarios escribir en Markdown en su idioma nativo, pero con soporte multilingüe.
+
+¿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 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. Me gustaría que un LLM generara automáticamente títulos, resúmenes, categorías, navegación y otras tareas de organización.
+
+  Segundo, mi espacio de trabajo debe estar ordenado. No quiero herramientas de construcción con configuraciones complejas, ni estructuras complicadas. 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 oculta toda la configuración en el directorio `.zen`, barriéndola bajo la alfombra. El usuario solo necesita centrarse en escribir, y ZEN se encarga del resto. Los demás directorios son su espacio de escritura, donde puede organizar sus archivos Markdown libremente.
+
+- **Regreso al idioma nativo**: Escribir en la lengua materna, construyendo versiones multilingües sin esfuerzo
+
+  La vida es corta, no quiero traducir. Las personas piensan con mayor profundidad cuando usan su idioma nativo. Pero conectar con el mundo también es necesario, y no quiero renunciar a la comunicación multilingüe. Por eso, deseo una herramienta que me permita escribir en mi idioma nativo y, al mismo tiempo, llegar a más personas. Los sistemas actuales de i18n requieren que traduzcas tú mismo y mantengas las actualizaciones, lo cual es tedioso. He optado por usar LLM para traducir, ahorrando tiempo y permitiendo traducciones a múltiples idiomas con un solo clic.
+
+## Comenzar rápidamente
+
+Requisitos previos:
+
+- Tener instalado [Node.js](https://nodejs.org/) (versión 18 o superior recomendada, con el comando `npx` disponible).
+- Obtener 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 filtrados por `.gitignore`).
+
+Primero, trabaja en una carpeta gestionada por git:
+
+Configura las variables de entorno:
+
+```bash
+export OPENAI_API_KEY="sk-xxxxxx"  # Obligatorio: reemplaza con tu 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
+```
+
+Construye el sitio, con soporte para traducción multilingüe. Usa el directorio actual como fuente y genera la salida en `.zen/dist`.
+
+- Puedes especificar los idiomas a generar usando múltiples veces el parámetro `--lang` (ej. `--lang zh-Hans --lang en-US`).
+- Puedes especificar el prefijo de la URL base del sitio con el parámetro `--base-url` (ej. 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 zh-Hans --lang en-US
+```
+
+**Ver más parámetros o ayuda**:
+
+```bash
+npx zengen@latest
+```