zengen 0.2.6 → 0.3.1

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/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md

@@ -0,0 +1,71 @@
+---
+'title': 'ZEN - Constructor de Sitios Estáticos Minimalista con Markdown + IA'
+'summary': 'ZEN es un generador de sitios estáticos con funciones de IA, diseñado específicamente para documentos Markdown. Permite a los usuarios convertir una carpeta Git que contenga archivos Markdown en un sitio HTML estático, sin configuraciones complejas; toda la configuración se oculta en el directorio .zen. Las funciones principales incluyen navegación por categorías inteligente (utilizando IA para analizar el contenido y generar un mapa del sitio), traducción automática incremental (soporte para 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 guía de inicio rápido requiere instalar Node.js, obtener una clave API de OpenAI y Git, construir el sitio mediante la línea de comandos, y permite especificar el idioma y la URL base.'
+'tags':
+  - 'Generador de sitios estáticos'
+  - 'Markdown'
+  - 'IA'
+  - 'Traducción multilingüe'
+  - 'Minimalismo'
+  - 'Herramienta de documentación'
+  - 'Git'
+'inferred_lang': 'zh-Hans'
+---
+
+# ZEN - Constructor de Sitios Estáticos Minimalista con Markdown + IA
+
+[> Demostración del sitio web](https://zen.zccz14.com/)
+
+## Funciones básicas
+
+1. 📃 **Generación de sitios estáticos**: Convierte cualquier carpeta git que contenga Markdown en un sitio HTML estático.
+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 automática incremental**: Utiliza IA para realizar traducciones incrementales, permitiendo a los usuarios escribir Markdown en su idioma nativo, pero ofreciendo contenido multilingüe.
+
+¿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 interrupciones, enfocarse en la escritura
+
+  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. Espero que un LLM me ayude 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 configuraciones de documentos complicadas, ni estructuras enrevesadas. 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 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 libremente.
+
+- **Regreso al idioma nativo**: Escribir en el idioma materno, 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 materno. Pero al mismo tiempo, es necesario mantenerse conectado con el mundo, y no quiero renunciar a la comunicación multilingüe. Por eso, deseo una herramienta que me permita escribir en mi idioma nativo y, a la vez, hacer que mi contenido llegue a más personas. 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 LLM para ayudarme con las traducciones, ahorrándome mucho tiempo y permitiéndome completar traducciones a múltiples idiomas con un solo clic.
+
+## Inicio rápido
+
+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 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: 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. Utilice el directorio actual como directorio 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`).
+- Puede especificar el prefijo de la 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 zh-Hans --lang en-US
+```
+
+**Para ver más parámetros o ayuda**:
+
+```bash
+npx zengen@latest
+```

package/.zen/src/es-MX/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 verificar 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-MX'
+---
+
+# 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 : Procesamiento fallido
+    É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 (debe mostrar mensaje de error)
+
+```mermaid
+graph TD
+    A --> B
+    // Aquí falta la definición de flecha
+    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-MX/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md

@@ -0,0 +1,70 @@
+---
+'title': 'ZEN - Constructor de sitios estáticos minimalista con Markdown + IA'
+'summary': 'ZEN es un generador de sitios estáticos con IA, 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 inteligente por categorías (genera un mapa 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 soporta 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 - Constructor 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 git que contenga Markdown en un sitio HTML estático.
+2. 🧭 **Navegación inteligente por categorías**: 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 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:
+
+- **Regresar al contenido**: Minimizar 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 lo he organizado adecuadamente. Deseo que un LLM me ayude 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 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, para que el usuario solo se enfoque en escribir el contenido y deje el resto a ZEN. Los demás directorios son su espacio de escritura, donde puede organizar sus archivos Markdown libremente.
+
+- **Regresar al idioma nativo**: Escribir en el idioma materno, 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 eso, deseo una herramienta que me permita escribir en mi idioma nativo y, a la vez, llegar a más personas con mi contenido. Actualmente, la internacionalización (i18n) no solo requiere que uno mismo 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)
+- 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 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 los idiomas a 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-MX/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md

@@ -0,0 +1,71 @@
+---
+'title': 'ZEN - Constructor de Sitios Estáticos Minimalista con Markdown + IA'
+'summary': 'ZEN es un generador de sitios estáticos con funciones de IA, diseñado específicamente para documentos Markdown. Permite a los usuarios convertir una carpeta Git que contenga archivos Markdown en un sitio HTML estático, sin configuraciones complejas; toda la configuración se oculta en el directorio .zen. Las funciones principales incluyen navegación por categorización inteligente (usando IA para analizar el contenido y generar un mapa del sitio), traducción automática incremental (soporte para 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 guía de inicio rápido requiere instalar Node.js, obtener una clave API de OpenAI y Git, construir el sitio mediante línea de comandos, y permite especificar idioma y URL base.'
+'tags':
+  - 'Generador de Sitios Estáticos'
+  - 'Markdown'
+  - 'IA'
+  - 'Traducción Multilingüe'
+  - 'Minimalismo'
+  - 'Herramienta de Documentación'
+  - 'Git'
+'inferred_lang': 'es-MX'
+---
+
+# ZEN - Constructor 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 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, mientras el sitio puede ser 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 Interrupciones, Enfocarse en Escribir**
+
+  Devolver la esencia a la documentación, 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. Deseo que un LLM me ayude automáticamente generando 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, lidiar con configuraciones de documentos intrincadas o 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. El usuario solo necesita enfocarse 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, me da flojera traducir. Uno alcanza su máxima profundidad de pensamiento cuando usa su idioma nativo. Pero al mismo tiempo, es necesario mantenerse conectado con el mundo; 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, permitir que más personas vieran mi contenido. Los sistemas i18n actuales no solo requieren que uno mismo traduzca, sino que también debe mantener las actualizaciones del contenido, lo cual es muy tedioso. Elegí usar LLM para ayudarme con la traducción, ahorrándome mucho tiempo y permitiendo completar traducciones a múltiples idiomas con un solo clic.
+
+## Comenzando Rápidamente
+
+Requisitos Previos:
+
+- Tener instalado [Node.js](https://nodejs.org/) (se recomienda versión 18 o superior, necesario 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 (se utiliza para listar archivos Markdown desde un repositorio Git, ignorando los filtrados por reglas `.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: Reemplácelo 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. Utiliza el directorio actual como fuente y la salida va al directorio `.zen/dist`.
+
+- Puede especificar las versiones de idioma que desea generar usando múltiples veces el parámetro `--lang` (ej. `--lang zh-Hans --lang en-US`).
+- Puede 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
+```

package/.zen/src/fi-FI/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md

@@ -0,0 +1,121 @@
+---
+'title': 'Mermaid-kaavioiden testidokumentti'
+'summary': 'Tämä dokumentti on testitiedosto, jolla varmistetaan Mermaid-kaavioiden renderöintitoiminto ZEN:ssä. Se sisältää esimerkkejä useista Mermaid-kaaviotyypeistä, kuten vuokaavioista, sekvenssikaavioista, Gantt-kaavioista, luokkakaavioista, tilakaavioista ja ympyräkaavioista, sekä sisältää virheellisen syntaksin testauksen virheilmoitusten tarkistamiseksi. Dokumentin tarkoitus on esitellä Mermaid-integraation normaali toiminta ZEN:ssä.'
+'tags':
+  - 'Mermaid'
+  - 'kaaviotestaus'
+  - 'ZEN'
+  - 'vuokaavio'
+  - 'sekvenssikaavio'
+  - 'Gantt-kaavio'
+  - 'luokkakaavio'
+  - 'tilakaavio'
+'inferred_date': '2024-01-01'
+'inferred_lang': 'fi-FI'
+---
+
+# Mermaid-kaavioiden testaus
+
+Tämä on testitiedosto, jolla varmistetaan Mermaid-kaavioiden renderöintitoiminto ZEN:ssä.
+
+## Esimerkki vuokaaviosta
+
+```mermaid
+graph TD
+    A[开始] --> B{是否继续?}
+    B -->|是| C[执行操作]
+    B -->|否| D[结束]
+    C --> E[检查结果]
+    E --> F{是否成功?}
+    F -->|是| G[完成]
+    F -->|否| H[重试]
+    H --> C
+    G --> D
+```
+
+## Esimerkki sekvenssikaaviosta
+
+```mermaid
+sequenceDiagram
+    participant User
+    participant System
+    participant Database
+
+    User->>System: 提交请求
+    System->>Database: 查询数据
+    Database-->>System: 返回结果
+    System-->>User: 显示结果
+```
+
+## Esimerkki Gantt-kaaviosta
+
+```mermaid
+gantt
+    title 项目时间表
+    dateFormat  YYYY-MM-DD
+    section 设计
+    需求分析     :done,    des1, 2024-01-01, 7d
+    原型设计     :active,  des2, 2024-01-08, 5d
+    详细设计     :         des3, after des2, 5d
+    section 开发
+    前端开发     :         dev1, after des3, 10d
+    后端开发     :         dev2, after des3, 15d
+    section 测试
+    单元测试     :         test1, after dev1, 5d
+    集成测试     :         test2, after dev2, 5d
+```
+
+## Esimerkki luokkakaaviosta
+
+```mermaid
+classDiagram
+    class Animal {
+        +String name
+        +int age
+        +void eat()
+        +void sleep()
+    }
+    class Dog {
+        +void bark()
+    }
+    class Cat {
+        +void meow()
+    }
+
+    Animal <|-- Dog
+    Animal <|-- Cat
+```
+
+## Esimerkki tilakaaviosta
+
+```mermaid
+stateDiagram-v2
+    [*] --> Idle
+    Idle --> Processing : 开始处理
+    Processing --> Success : 处理成功
+    Processing --> Error : 处理失败
+    Success --> [*]
+    Error --> [*]
+```
+
+## Esimerkki ympyräkaaviosta
+
+```mermaid
+pie title 浏览器使用率
+    "Chrome" : 65.2
+    "Firefox" : 15.3
+    "Safari" : 12.5
+    "Edge" : 5.2
+    "其他" : 1.8
+```
+
+## Virheellisen syntaksin testaus (pitäisi näyttää virheilmoituksen)
+
+```mermaid
+graph TD
+    A --> B
+    // 这里缺少箭头定义
+    C --> D
+```
+
+Tämä testitiedosto sisältää useita Mermaid-kaaviotyyppejä, joilla varmistetaan ZEN:n Mermaid-integraation oikea toiminta.

package/.zen/src/fi-FI/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md

@@ -0,0 +1,70 @@
+---
+'title': 'ZEN - Minimalistinen Markdown + AI -staattisen sivuston rakentaja'
+'summary': 'ZEN on AI:ta hyödyntävä staattisen sivuston generaattori, joka keskittyy dokumenttien kirjoittamisen ja rakentamisen yksinkertaistamiseen. Sen avulla käyttäjät voivat luoda staattisia HTML-sivustoja git-hallinnassa oleviin kansioihin käyttäen Markdownia ilman monimutkaisia konfiguraatioita; kaikki asetukset piilotetaan .zen-hakemistoon. Keskeisiin ominaisuuksiin kuuluvat älykäs luokittelu ja navigointi (sivustokartan generointi AI:n analysoimana sisältöä), automaattinen inkrementaalinen käännös (tuki monikielisille versioille, käyttäjä voi kirjoittaa äidinkielellään ja AI käsittelee käännökset) sekä häiriöttömän kirjoittamisen kokemus. Työkalu vaatii Node.js:n, OpenAI API -avaimen ja Git:n, ja se rakentaa sivuston nopeasti komentorivin kautta tukien kieliparametreja kuten zh-Hans ja en-US.'
+'tags':
+  - 'staattisen sivuston generaattori'
+  - 'Markdown'
+  - 'AI'
+  - 'monikielinen käännös'
+  - 'minimalismi'
+  - 'dokumentointityökalu'
+  - 'ZEN'
+'inferred_lang': 'zh-Hans'
+---
+
+# ZEN - Minimalistinen Markdown + AI -staattisen sivuston rakentaja
+
+[> Verkkosivuston demo](https://zen.zccz14.com/)
+
+## Perustoiminnot
+
+1. 📃 **Staattisen sivuston generointi**: Muunna mikä tahansa git-hallinnassa oleva kansio, joka sisältää Markdown-tiedostoja, staattiseksi HTML-sivustoksi.
+2. 🧭 **Älykäs luokittelu ja navigointi**: Käytä AI:ta sisällön analysointiin, generoi sivustokartta ja navigointi. Lähdetiedostojen sijainnilla ei ole merkitystä.
+3. 🌍 **Automaattinen inkrementaalinen käännös**: Käytä AI:ta inkrementaaliseen käännökseen, jotta käyttäjä voi kirjoittaa Markdownia äidinkielellään, mutta lopputulos voi olla monikielinen.
+
+Miksi olen luonut taas uuden Markdown-pohjaisen staattisen sivuston generaattorin? Olen uudelleen miettinyt, kuinka dokumentointityökalut voisivat AI-aikakaudella palvella kirjoittajia paremmin:
+
+- Palaa sisältöön: minimoi häiriöt, keskity kirjoittamiseen
+
+  Palauta dokumenttien olemus, palauta kirjoittamisen rauha.
+
+  Ensinnäkin, en halua olla kirjastonhoitaja. Haluan joskus kirjoittaa jotain sisältöä, mutta en välttämättä ole vielä päättänyt sen otsikosta tai muodostanut selkeää rakennetta. Toivon, että LLM automaattisesti generoisi otsikoita, tekisi yhteenvetoja, luokittelisi ja navigoisi sisältöä.
+
+  Toiseksi, kirjastoni on puhdistettava siistiksi. En halua monimutkaisia konfiguraatiotyökaluja, enkä halua säätää monimutkaisten dokumenttien asetusten kanssa. Monimutkaiset rakenteet eivät ole mieleeni. Aina kun näen Docusaurusin, VuePressin tai Astron konfiguraatiotiedostot ja projektirakenteet, särkee pääni. Nyt ZEN piilottaa kaikki asetukset .zen-hakemistoon, työntää ne nurkkaan, jotta käyttäjä voi keskittyä vain kirjoittamiseen. Kaikki muut hakemistot ovat kirjoitustilaa, ja voit järjestää Markdown-tiedostosi haluamallasi tavalla.
+
+- Palaa äidinkieleen: kirjoita äidinkielellä, luo monikieliset versiot sulavasti
+
+  Elämä on lyhyt, en jaksa kääntää. Ihmiset pystyvät parhaiten hyödyntämään ajattelunsa syvyyttä äidinkielellään. Mutta yhteydenpito maailmaan on välttämätöntä, enkä halua luopua monikielisestä vuorovaikutuksesta. Siksi toivon työkalua, jonka avulla voin kirjoittaa äidinkielelläni ja samalla tehdä sisältöni saatavilla useammille. Nykyinen i18n vaatii käännösten tekemisen itse ja sisällön päivittämisen, mikä on liian vaivalloista. Käytän LLM:ää auttamaan käännöksissä, mikä säästää aikaani ja mahdollistaa monikielisten käännösten tekemisen yhdellä napsautuksella.
+
+## Pika-aloitus
+
+Edellytykset:
+
+- [Node.js](https://nodejs.org/) asennettuna (suositeltu versio 18 tai uudempi, tarvitaan npx-komento)
+- [OpenAI API -avain](https://platform.openai.com/account/api-keys) hankittu, tai OPENAI-yhteensopiva API-avain
+- Git asennettuna (käytetään Markdown-tiedostojen listaukseen git:stä, .gitignore-sääntöjen mukaisesti suodatettujen tiedostojen ohittamiseksi)
+
+Työskentele ensin git-hallinnassa olevassa kansiossa:
+
+Määritä ympäristömuuttujat
+
+```bash
+export OPENAI_API_KEY="sk-xxxxxx"  # Pakollinen: korvaa omalla OpenAI API -avaimellasi
+export OPENAI_BASE_URL="https://api.openai.com/v1"  # Valinnainen, käyttää oletuksena OpenAI:n virallista API:a
+export OPENAI_MODEL="gpt-3.5-turbo"  # Valinnainen, käyttää oletuksena gpt-3.5-turbo-mallia
+```
+
+Rakenna sivusto, tuki monikielisille käännöksille. Käytä nykyistä hakemistoa lähdehakemistona ja tulosta `.zen/dist`-hakemistoon.
+
+- Voit määrittää tarvittavat kieliversiot käyttämällä `--lang`-parametria useita kertoja (esim. `--lang zh-Hans --lang en-US`).
+- Lähdekieltä ei tarvitse määrittää, ZEN tunnistaa sen automaattisesti.
+
+```bash
+npx zengen@latest build --lang zh-Hans --lang en-US
+```
+
+**Näytä lisää parametreja tai ohjeita**:
+
+```bash
+npx zengen@latest
+```