zengen 0.2.4 → 0.2.6

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

@@ -1,67 +1,67 @@
 ---
-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
+'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
+# ZEN - Generador de sitios estáticos minimalista con Markdown + IA
 
-[> Demostración del Sitio Web](https://zccz14.github.io/ZEN/)
+[> Demostración del sitio web](https://zccz14.github.io/ZEN/)
 
-## Funcionalidades Básicas
+## 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.
+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 reflexionado sobre cómo las herramientas de documentación pueden servir mejor a los escritores en la era de la IA:
+¿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, centrarse en escribir.
+- **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. Quiero que un LLM me ayude automáticamente generando títulos, resúmenes, categorías, navegación y otras tareas de organización.
+  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 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.
+  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 a la Lengua Materna**: Escribir en la lengua materna, construir versiones multilingües sin esfuerzo.
+- **Regreso al idioma nativo**: Escribir en la lengua materna, construyendo 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.
+  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
+## 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`).
+- 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, trabaje en una carpeta que ya esté gestionada por Git:
+Primero, trabaja en una carpeta gestionada por git:
 
-Configure las variables de entorno:
+Configura las variables de entorno:
 
 ```bash
-export OPENAI_API_KEY="sk-xxxxxx"  # Obligatorio: Reemplazar con su Clave API de OpenAI
+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
 ```
 
-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`.
+Construye el sitio, con soporte para traducción multilingüe. Usa el directorio actual como fuente y genera la salida en `.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).
+- 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 es-ES --lang en-US
+npx zengen@latest build --lang zh-Hans --lang en-US
 ```
 
 **Ver más parámetros o ayuda**:

package/.zen/src/es-ES/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md

@@ -0,0 +1,30 @@
+---
+'title': 'Técnicas de uso de declaraciones de fecha en documentos ZEN'
+'summary': 'Este documento presenta técnicas para declarar fechas directamente en el cuerpo del texto utilizando la herramienta ZEN, contrastándolo con el método tradicional de Markdown mediante YAML Frontmatter. Destaca las capacidades de reconocimiento automático y procesamiento inteligente de ZEN, mejorando la experiencia del usuario, y es aplicable a tipos de contenido que requieren líneas de tiempo, como diarios y blogs.'
+'tags':
+  - 'ZEN'
+  - 'Declaración de fecha'
+  - 'Markdown'
+  - 'Procesamiento por IA'
+  - 'Línea de tiempo'
+  - 'Experiencia de usuario'
+  - 'Gestión de documentos'
+'inferred_date': '2026-01-08'
+'inferred_lang': 'es-ES'
+---
+
+# Técnicas de uso
+
+## Declarar fechas en el cuerpo del texto
+
+En el cuerpo del texto se pueden utilizar declaraciones de fecha como "Hoy es 8 de enero de 2026" (el formato y estilo son libres), y ZEN las reconocerá y procesará automáticamente.
+
+Los documentos tradicionales en Markdown declaran la fecha mediante YAML Frontmatter, lo que requiere recordar los campos correspondientes; de lo contrario, la fecha podría no reconocerse correctamente.
+
+ZEN permite declarar fechas directamente en el cuerpo del texto, evitando el problema de olvidar completar los campos del Frontmatter.
+
+La IA extraerá e inferirá automáticamente la información de fecha del texto y la procesará como la fecha de creación del documento.
+
+Este método es más flexible e inteligente, mejorando la experiencia del usuario.
+
+Como nota adicional, los documentos que incluyen fechas pueden generar vistas de línea de tiempo, facilitando la navegación y gestión. Es especialmente adecuado para tipos de contenido que requieren líneas de tiempo, como diarios y blogs.

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

@@ -1,64 +1,64 @@
 ---
-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
+'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 para simplificar la escritura de documentación y la construcción de sitios. Permite a los usuarios enfocarse en escribir contenido en Markdown en su idioma nativo, manejando automáticamente la generación de títulos, navegación por categorías y traducción incremental, con soporte para versiones multilingües, sin necesidad de configuraciones complejas. La herramienta está basada en Node.js y la API de OpenAI, construyendo sitios rápidamente mediante 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': 'es-MX'
 ---
 
-# ZEN - Generador de Sitios Estáticos Minimalista con Markdown + IA
+# ZEN - Constructor 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.
+1. 📃 **Generación de Sitios Estáticos**: Convierte cualquier carpeta git que contenga archivos 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 Incremental Automática**: Emplea IA para traducciones incrementales, permitiendo a los usuarios escribir en 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 las distracciones, enfocarse en escribir.
+- **Regreso al contenido**: Minimizar las distracciones, enfocarse en escribir
 
-  Devolver la documentación a su esencia, devolver la tranquilidad a la escritura.
+  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. Espero que un LLM me ayude automáticamente a generar títulos, hacer resúmenes, clasificar, navegar y otras tareas de organización.
+  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. Quiero que un LLM genere automáticamente títulos, resúmenes, categorías, navegación 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.
+  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 enfocarse en escribir; 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, construir versiones multilingües sin esfuerzo.
+- **Regreso al idioma nativo**: Escribir en la lengua materna, construyendo 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.
+  La vida es corta, no quiero traducir. Las personas piensan con mayor profundidad cuando usan su idioma nativo. Pero también 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, al mismo tiempo, llegar a más personas. Los sistemas i18n actuales requieren que uno mismo traduzca y mantenga las actualizaciones, lo cual es muy tedioso. He optado por usar LLM para manejar las traducciones, ahorrándome mucho tiempo y permitiendo 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`).
+- Tener instalado [Node.js](https://nodejs.org/) (se recomienda versión 18 o superior, 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, trabaje en una carpeta que ya esté gestionada por Git:
+Primero, trabaje en una carpeta ya gestionada por Git:
 
-Configure las variables de entorno:
+Configurar variables de entorno
 
 ```bash
-export OPENAI_API_KEY="sk-xxxxxx"  # Obligatorio: reemplazar con su Clave API de OpenAI
+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. Usa el directorio actual como fuente y genera la salida en el directorio `.zen/dist`.
+Construir 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.
+- Puede especificar los idiomas a generar usando múltiples veces el parámetro `--lang` (por ejemplo, `--lang es-MX --lang en-US`).
+- Puede especificar el prefijo base de la URL 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-MX --lang en-US

package/.zen/src/es-MX/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md

@@ -0,0 +1,30 @@
+---
+'title': 'Técnicas de uso de declaración de fechas en documentos ZEN'
+'summary': 'Este documento presenta técnicas para declarar fechas directamente en el cuerpo del texto usando la herramienta ZEN, contrastándolo con el método tradicional de Markdown mediante YAML Frontmatter. Destaca las funciones de reconocimiento automático y procesamiento inteligente de ZEN, mejorando la experiencia del usuario, y es aplicable a tipos de contenido que requieren líneas de tiempo como diarios y blogs.'
+'tags':
+  - 'ZEN'
+  - 'Declaración de fechas'
+  - 'Markdown'
+  - 'Procesamiento con IA'
+  - 'Línea de tiempo'
+  - 'Experiencia de usuario'
+  - 'Gestión de documentos'
+'inferred_date': '2026-01-08'
+'inferred_lang': 'es-MX'
+---
+
+# Técnicas de uso
+
+## Declarar fechas en el cuerpo del texto
+
+En el cuerpo del texto se pueden usar declaraciones de fecha como "Hoy es 8 de enero de 2026" (el estilo de formato es libre), y ZEN las reconocerá y procesará automáticamente.
+
+Los documentos tradicionales de Markdown declaran fechas mediante YAML Frontmatter, lo que requiere recordar los campos correspondientes; de lo contrario, la fecha podría no reconocerse correctamente.
+
+ZEN permite declarar fechas directamente en el cuerpo del texto, evitando el problema de olvidar completar los campos del Frontmatter.
+
+La IA extraerá e inferirá automáticamente la información de fecha del cuerpo del texto y la procesará como la fecha de creación del documento.
+
+Este método es más flexible e inteligente, mejorando la experiencia del usuario.
+
+Por cierto, los documentos que incluyen fechas pueden generar vistas de línea de tiempo, facilitando la navegación y gestión. Es especialmente adecuado para tipos de contenido que requieren líneas de tiempo, como diarios y blogs.

package/.zen/src/fi-FI/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md

@@ -1,67 +1,67 @@
 ---
-title: ZEN - Minimalistinen Markdown + AI -staattinen sivuston rakentaja
-summary: ZEN on AI:ta hyödyntävä staattinen sivuston generoija, joka tukee älykästä luokittelunavigointia ja automaattista inkrementaalista käännöstä. Se mahdollistaa käyttäjän keskittyä äidinkielellä kirjoittamiseen ja yksinkertaistaa konfigurointia ja rakennusprosessia.
-tags:
-  - staattinen sivuston generoija
-  - Markdown
-  - AI
-  - monikielinen käännös
-  - minimalismi
-  - dokumentointityökalu
-  - Node.js
-inferred_lang: fi-FI
+'title': 'ZEN - Minimalistinen Markdown + AI -staattisen sivuston rakentaja'
+'summary': 'ZEN on staattinen sivustonluontityökalu, joka yhdistää tekoälyominaisuuksia ja pyrkii yksinkertaistamaan dokumenttien kirjoittamista ja sivuston rakentamista. Sen avulla käyttäjät voivat keskittyä alkuperäiskielellään kirjoitettuun Markdown-sisältöön, kun työkalu käsittelee automaattisesti otsikoiden luonnin, luokittelunavigoinnin ja inkrementaalisen käännöksen. Se tukee monikielisiä versioita ilman monimutkaisia määrityksiä. Työkalu perustuu Node.js:ään ja OpenAI API:hin, ja se mahdollistaa komentorivin kautta nopean sivuston rakentamisen, mikä sopii tehokkuutta ja yksinkertaisuutta tavoitteleville kirjoittajille.'
+'tags':
+  - 'staattinen sivustonluontityökalu'
+  - 'Markdown'
+  - 'tekoäly'
+  - 'minimalismi'
+  - 'monikielinen käännös'
+  - 'Node.js'
+  - 'OpenAI'
+'inferred_lang': 'zh-Hans'
 ---
 
-# ZEN - Minimalistinen Markdown + AI -staattinen sivuston rakentaja
+# ZEN - Minimalistinen Markdown + AI -staattisen sivuston rakentaja
 
 [> Verkkosivuston demo](https://zccz14.github.io/ZEN/)
 
 ## Perustoiminnot
 
-1. 📃 **Staattinen sivuston generointi**: Muunna mikä tahansa git-kansio, joka sisältää Markdown-tiedostoja, staattiseksi HTML-sivustoksi.
-2. 🧭 **Älykäs luokittelunavigointi**: Käytä AI:ta sisällön analysointiin, sivustokartan ja navigoinnin luomiseen. Lähdetiedostojen sijainti ei ole merkityksellinen.
-3. 🌍 **Automaattinen inkrementaalinen käännös**: Käytä AI:ta inkrementaaliseen käännökseen, jotta käyttäjä voi kirjoittaa Markdownia äidinkielellään, mutta käyttäjä voi olla monikielinen.
+1. 📃 **Staattisen sivuston luonti**: Muunna mikä tahansa git-kansio, joka sisältää Markdown-tiedostoja, staattiseksi HTML-sivustoksi.
+2. 🧭 **Älykäs luokittelunavigointi**: Analysoi sisältöä tekoälyn avulla, luo sivustokartan ja navigoinnin, eikä ole riippuvainen lähdetiedostojen sijainnista.
+3. 🌍 **Automaattinen inkrementaalinen käännös**: Käytä tekoälyä inkrementaaliseen käännökseen, jotta käyttäjät voivat kirjoittaa Markdownia äidinkielellään, mutta sivusto voi olla monikielinen.
 
-Miksi olen luonut taas uuden Markdown-staattisen sivuston generoijan? Olen uudelleen miettinyt, kuinka dokumentointityökalut voisivat AI-aikakaudella palvella kirjoittajia paremmin:
+Miksi olen luonut uuden Markdown-pohjaisen staattisen sivustonluontityökalun? Olen uudelleen miettinyt, kuinka dokumentointityökalut voisivat tekoälykaudella palvella kirjoittajia paremmin:
 
 - Palaa sisältöön: Minimoi häiriöt, keskity kirjoittamiseen
 
-  Palauta dokumenttien olemus, palauta kirjoittamisen rauha.
+  Palauta dokumenttien olemus, anna kirjoittamisen olla rauhallista.
 
-  Ensinnäkin, en halua olla kirjastonhoitaja. Joskus haluan kirjoittaa jotain sisältöä, mutta en ehkä ole vielä keksinyt sille otsikkoa tai muodostanut selkeää organisointia. Toivoisin, että LLM automaattisesti luo otsikoita, tekee yhteenvetoja, luokittelee ja navigoi sisällön järjestelytyöt.
+  Ensinnäkin, en halua olla kirjastonhoitaja. Joskus haluan kirjoittaa jotain sisältöä, mutta en ehkä ole vielä päättänyt sen otsikosta tai muodostanut selkeää järjestelyä. Toivon, että LLM auttaisi automaattisesti luomaan otsikoita, tekemään yhteenvetoja, luokittelemaan ja navigoimaan.
 
-  Toiseksi, kirjastoni on puhdistettava siistiksi. En halua monimutkaisia konfigurointityökaluja, sotkea monimutkaisia dokumenttikokoonpanoja tai monimutkaisia rakenteita. Joka kerta kun näen Docusaurus-, VuePress- tai Astro-työkalujen konfiguraatiotiedostot ja projektirakenteet, särkee päätäni. Nyt ZEN valitsee piilottaa kaikki konfiguraatiot `.zen`-hakemistoon, nurkkaan, jotta käyttäjä voi keskittyä vain kirjoittamiseen. Kaikki muut hakemistot ovat sinun kirjoitustilasi, voit järjestellä Markdown-tiedostojasi vapaasti.
+  Toiseksi, työtilani on puhdistettava. En halua monimutkaisia määritystyökaluja, sotkea monimutkaisia dokumenttimäärityksiä tai monimutkaisia rakenteita. Aina kun näen Docusaurus-, VuePress- tai Astro-työkalujen määritystiedostot ja projektirakenteet, särkee päätäni. Nyt ZEN piilottaa kaikki määritykset `.zen`-hakemistoon, työnnä ne nurkkaan, jotta käyttäjät voivat keskittyä vain sisällön kirjoittamiseen, ja ZEN hoitaa loput. Kaikki muut hakemistot ovat kirjoitustilaa, ja voit järjestää Markdown-tiedostosi haluamallasi tavalla.
 
-- Palaa äidinkieleen: Kirjoita äidinkielellä, luo monikieliset versiot sulavasti
+- Palaa äidinkieleen: Kirjoita äidinkielellä, luo monikielisiä versioita 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 toivoisin työkalua, jonka avulla voisin kirjoittaa äidinkielelläni ja samalla saada sisältöni näkyville useammille. Nykyinen i18n vaatii käännösten tekemistä itse ja sisällön päivitysten ylläpidon, mikä on liian työlästä. Valitsen käyttää LLM:ää käännösten tekemiseen, säästän paljon aikaa ja voin suorittaa monikieliset käännökset yhdellä napsautuksella.
+  Elämä on lyhyt, en jaksa kääntää. Ihmiset saavuttavat syvimmän ajattelunsa äidinkielellään. Mutta yhteydenpito maailmaan on välttämätöntä, enkä halua luopua monikielisestä vuorovaikutuksesta. Siksi toivon työkalua, joka mahdollistaa äidinkielellä kirjoittamisen ja samalla tekee sisällöstä saatavilla laajemmalle yleisölle. Nykyinen i18n vaatii oman käännöksen ja sisällön ylläpidon, mikä on liian vaivalloista. Käytän LLM:ää auttamaan käännöksissä, mikä säästää aikaa ja mahdollistaa monikielisten versioiden luomisen yhdellä napsautuksella.
 
-## Nopea aloitus
+## 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 suodatetut tiedostot ohitetaan)
+- [OpenAI API -avain](https://platform.openai.com/account/api-keys) hankittu, tai OpenAI-yhteensopiva API-avain
+- Git asennettuna (käytetään Markdown-tiedostojen listaukseen gitistä, .gitignore-sääntöjen mukaisesti suodatettujen tiedostojen ohittamiseksi)
 
-Työskentele ensin git-hallinnassa olevassa kansiossa:
+Ensinnäkin, työskentele git-hallinnassa olevassa hakemistossa:
 
 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
+export OPENAI_BASE_URL="https://api.openai.com/v1"  # Valinnainen, oletuksena käytetään OpenAI:n virallista API:a
+export OPENAI_MODEL="gpt-3.5-turbo"  # Valinnainen, oletuksena käytetään gpt-3.5-turbo -mallia
 ```
 
 Rakenna sivusto, tuki monikielisiä käännöksiä. Käytä nykyistä hakemistoa lähdehakemistona, tuloste `.zen/dist`-hakemistoon.
 
-- Voit määrittää tarvittavat kieliversiot käyttämällä `--lang`-parametria useita kertoja (esim. `--lang fi-FI --lang en-US`).
+- Voit määrittää tarvittavat kieliversiot käyttämällä `--lang`-parametria useita kertoja (esim. `--lang zh-Hans --lang en-US`).
 - Voit määrittää sivuston perus-URL-etuliitteen `--base-url`-parametrilla (esim. GitHub Pages -varaston nimi).
-- Lähdekieltä ei tarvitse konfiguroida, ZEN tunnistaa sen automaattisesti.
+- Lähdekielen määritystä ei tarvita, ZEN tunnistaa sen automaattisesti.
 
 ```bash
-npx zengen@latest build --lang fi-FI --lang en-US
+npx zengen@latest build --lang zh-Hans --lang en-US
 ```
 
 **Näytä lisää parametreja tai ohjeita**:

package/.zen/src/fi-FI/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md

@@ -0,0 +1,30 @@
+---
+'title': 'ZEN-dokumentin päivämäärän ilmoittamisen käyttötekniikat'
+'summary': 'Tämä dokumentti esittelee ZEN-työkalun käyttötekniikoita päivämäärän ilmoittamiseen suoraan tekstissä. Perinteiseen Markdown-tyyliin verrattuna, jossa päivämäärä ilmoitetaan YAML Frontmatterissa, ZEN korostaa automaattista tunnistusta ja älykästä käsittelyä, parantaen käyttäjäkokemusta. Soveltuu erityisesti päiväkirjoihin, blogeihin ja muihin aikajanaa vaativiin sisältötyyppeihin.'
+'tags':
+  - 'ZEN'
+  - 'päivämäärän ilmoitus'
+  - 'Markdown'
+  - 'tekoälykäsittely'
+  - 'aikajana'
+  - 'käyttäjäkokemus'
+  - 'dokumenttien hallinta'
+'inferred_date': '2026-01-08'
+'inferred_lang': 'zh-Hans'
+---
+
+# Käyttötekniikat
+
+## Päivämäärän ilmoittaminen tekstissä
+
+Tekstissä voi käyttää päivämääräilmoituksia kuten "Tänään on 8. tammikuuta 2026" (muotoilu on vapaavalintainen), ja ZEN tunnistaa ja käsittelee ne automaattisesti.
+
+Perinteisissä Markdown-dokumenteissa päivämäärä ilmoitetaan YAML Frontmatterissa, mikä vaatii vastaavien kenttien muistamista, muuten päivämäärä ei tunnisteta oikein.
+
+ZEN tukee päivämäärän ilmoittamista suoraan tekstissä, mikä välttää Frontmatter-kenttien unohtamisen ongelman.
+
+Tekoäly poimii ja päättelee automaattisesti tekstistä päivämäärätiedot ja käsittelee ne dokumentin luontipäivämääränä.
+
+Tämä tapa on joustavampi ja älykkäämpi, parantaen käyttäjäkokemusta.
+
+Mainittakoon vielä, että päivämäärällisistä dokumenteista voidaan luoda aikajanakatselu, mikä helpottaa selaamista ja hallintaa. Erityisen sopiva päiväkirjoille, blogeille ja muille aikajanaa vaativille sisältötyypeille.

package/.zen/src/fr-FR/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md

@@ -1,15 +1,15 @@
 ---
-title: ZEN - Générateur de site statique minimaliste Markdown + IA
-summary: ZEN est un générateur de site statique intégrant l'IA, prenant en charge la navigation par catégories intelligente et la traduction incrémentale automatique, permettant aux utilisateurs de se concentrer sur l'écriture dans leur langue maternelle et de simplifier les processus de configuration et de construction.
-tags:
-  - Générateur de site statique
-  - Markdown
-  - IA
-  - Traduction multilingue
-  - Minimalisme
-  - Outil de documentation
-  - Node.js
-inferred_lang: fr-FR
+'title': 'ZEN - Générateur de site statique minimaliste Markdown + IA'
+'summary': "ZEN est un générateur de site statique intégrant des fonctionnalités d'IA, conçu pour simplifier l'écriture de documentation et la construction de sites. Il permet aux utilisateurs de se concentrer sur la rédaction de contenu Markdown dans leur langue maternelle, en automatisant la génération de titres, la navigation par catégories et la traduction incrémentale. Il prend en charge les versions multilingues sans configuration complexe. Basé sur Node.js et l'API OpenAI, il construit rapidement des sites via la ligne de commande, idéal pour les rédacteurs recherchant efficacité et simplicité."
+'tags':
+  - 'Générateur de site statique'
+  - 'Markdown'
+  - 'IA'
+  - 'Minimalisme'
+  - 'Traduction multilingue'
+  - 'Node.js'
+  - 'OpenAI'
+'inferred_lang': 'zh-Hans'
 ---
 
 # ZEN - Générateur de site statique minimaliste Markdown + IA
@@ -18,35 +18,35 @@ inferred_lang: fr-FR
 
 ## Fonctionnalités de base
 
-1.  📃 **Génération de site statique** : Transforme n'importe quel dossier git contenant des fichiers Markdown en un site HTML statique.
-2.  🧭 **Navigation par catégories intelligente** : Utilise l'IA pour analyser le contenu, générer un plan du site et une navigation, indépendamment de l'emplacement des fichiers sources.
-3.  🌍 **Traduction incrémentale automatique** : Utilise l'IA pour des traductions incrémentielles, permettant aux utilisateurs d'écrire en Markdown dans leur langue maternelle, tout en offrant un contenu multilingue.
+1. 📃 **Génération de site statique** : Transforme n'importe quel dossier git contenant des fichiers Markdown en un site HTML statique.
+2. 🧭 **Navigation par catégories intelligente** : Utilise l'IA pour analyser le contenu, générer un plan du site et une navigation, indépendamment de l'emplacement des fichiers sources.
+3. 🌍 **Traduction incrémentale automatique** : Utilise l'IA pour des traductions incrémentales, permettant aux utilisateurs d'écrire en Markdown dans leur langue maternelle tout en offrant un contenu multilingue.
 
-Pourquoi créer un autre générateur de site statique Markdown ? J'ai repensé la manière dont les outils de documentation pourraient mieux servir les auteurs à l'ère de l'IA :
+Pourquoi créer un autre générateur de site statique Markdown ? J'ai repensé la manière dont les outils de documentation pourraient mieux servir les rédacteurs à l'ère de l'IA :
 
 - Retour au contenu : Minimiser les distractions, se concentrer sur l'écriture
 
-  Ramener la documentation à son essence, ramener l'écriture à la sérénité.
+  Rendre à la documentation son essence, et à l'écriture sa sérénité.
 
-  Premièrement, je ne veux pas être un bibliothécaire. Parfois, je veux écrire quelque chose, mais je n'ai peut-être pas encore trouvé son titre, ni établi une organisation particulière. J'aimerais que l'IA génère automatiquement les titres, fasse des résumés, des catégorisations, de la navigation et d'autres tâches d'organisation.
+  Premièrement, je ne veux pas être bibliothécaire. Parfois, je souhaite écrire du contenu sans avoir encore réfléchi à son titre ou à son organisation. Je souhaite que l'IA génère automatiquement les titres, résumés, catégories, navigation et autres tâches d'organisation.
 
-  Deuxièmement, mon espace de travail doit être propre. Je ne veux pas d'outils de construction complexes à configurer, ni de configurations de documentation compliquées, ni de structures alambiquées. Chaque fois que je vois les fichiers de configuration et les structures de projet d'outils comme Docusaurus, VuePress, Astro, j'ai mal à la tête. Maintenant, ZEN choisit de cacher toute la configuration dans le répertoire `.zen`, de la balayer dans un coin, permettant à l'utilisateur de se concentrer uniquement sur le contenu de l'écriture, et laissant ZEN gérer le reste. Tous les autres répertoires sont votre espace d'écriture, vous pouvez organiser vos fichiers Markdown comme bon vous semble.
+  Deuxièmement, mon espace de travail doit rester propre. Je ne veux pas d'outils de construction complexes à configurer, ni de structures de documentation compliquées. Chaque fois que je vois les fichiers de configuration et les structures de projet de Docusaurus, VuePress ou Astro, j'ai mal à la tête. Désormais, ZEN cache toute la configuration dans le répertoire `.zen`, le reléguant dans un coin. L'utilisateur se concentre uniquement sur l'écriture du contenu, et ZEN s'occupe du reste. Tous les autres répertoires sont votre espace d'écriture, vous pouvez organiser vos fichiers Markdown comme bon vous semble.
 
-- Retour à la langue maternelle : Écrire dans sa langue maternelle, construire des versions multilingues de manière fluide
+- Retour à la langue maternelle : Écrire dans sa langue maternelle, générer facilement des versions multilingues
 
-  La vie est courte, je n'ai pas envie de traduire. C'est dans sa langue maternelle qu'une personne peut exploiter au mieux la profondeur de sa réflexion. Mais en même temps, il est nécessaire de rester connecté au monde, je ne veux pas renoncer à la communication multilingue. J'espérais donc un outil qui me permette d'écrire dans ma langue maternelle, tout en permettant à plus de gens de voir mon contenu. Actuellement, l'i18n nécessite non seulement de traduire soi-même, mais aussi de maintenir les mises à jour du contenu, c'est trop fastidieux. J'ai choisi d'utiliser l'IA pour m'aider à traduire, ce qui m'économise beaucoup de temps et permet de réaliser des traductions multilingues en un clic.
+  La vie est trop courte pour perdre du temps en traduction. On exprime le mieux la profondeur de sa pensée dans sa langue maternelle. Mais rester connecté au monde est essentiel, et je ne veux pas renoncer à la communication multilingue. J'ai donc souhaité un outil me permettant d'écrire dans ma langue maternelle tout en rendant mon contenu accessible à un public plus large. Les solutions i18n actuelles nécessitent non seulement de traduire soi-même, mais aussi de maintenir les mises à jour, ce qui est trop fastidieux. J'ai choisi d'utiliser l'IA pour gérer la traduction, ce qui me fait gagner beaucoup de temps et permet de générer des traductions dans plusieurs langues en un clic.
 
 ## Démarrage rapide
 
 Prérequis :
 
 - [Node.js](https://nodejs.org/) installé (version 18 ou supérieure recommandée, nécessite la commande `npx`)
-- Clé API [OpenAI](https://platform.openai.com/account/api-keys) obtenue, ou clé API compatible avec OpenAI
+- Clé API [OpenAI](https://platform.openai.com/account/api-keys) obtenue, ou une clé API compatible avec OpenAI
 - Git installé (pour lister les fichiers Markdown depuis un dépôt Git, en ignorant les fichiers filtrés par les règles `.gitignore`)
 
-Tout d'abord, travaillez dans un dossier déjà géré par git :
+Tout d'abord, travaillez dans un dossier déjà géré par Git :
 
-Configurer les variables d'environnement
+Configurez les variables d'environnement
 
 ```bash
 export OPENAI_API_KEY="sk-xxxxxx"  # Obligatoire : remplacez par votre clé API OpenAI
@@ -54,14 +54,14 @@ export OPENAI_BASE_URL="https://api.openai.com/v1"  # Optionnel, utilise par dé
 export OPENAI_MODEL="gpt-3.5-turbo"  # Optionnel, utilise par défaut le modèle gpt-3.5-turbo
 ```
 
-Construire le site, avec prise en charge de la traduction multilingue. Utilise le répertoire courant comme source et génère la sortie dans le répertoire `.zen/dist`.
+Construisez le site, avec prise en charge de la traduction multilingue. Utilise le répertoire courant comme source et génère la sortie dans le dossier `.zen/dist`.
 
-- Vous pouvez spécifier les versions linguistiques à générer en utilisant plusieurs fois le paramètre `--lang` (par exemple `--lang fr-FR --lang en-US`).
+- Vous pouvez spécifier les versions linguistiques à générer en utilisant plusieurs fois le paramètre `--lang` (par exemple `--lang zh-Hans --lang en-US`).
 - Vous pouvez spécifier le préfixe d'URL de base du site avec le paramètre `--base-url` (par exemple le nom du dépôt sur GitHub Pages).
 - Aucune configuration de la langue source n'est nécessaire, ZEN la détecte automatiquement.
 
 ```bash
-npx zengen@latest build --lang fr-FR --lang en-US
+npx zengen@latest build --lang zh-Hans --lang en-US
 ```
 
 **Voir plus de paramètres ou obtenir de l'aide** :

package/.zen/src/fr-FR/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md

@@ -0,0 +1,30 @@
+---
+'title': "Astuces d'utilisation des déclarations de date dans ZEN"
+'summary': "Ce document présente les techniques d'utilisation des déclarations de date directement dans le corps du texte avec l'outil ZEN. Comparé à la méthode traditionnelle de déclaration de date via YAML Frontmatter dans Markdown, il met en avant les fonctionnalités de reconnaissance automatique et de traitement intelligent de ZEN, améliorant ainsi l'expérience utilisateur. Cette approche est particulièrement adaptée aux types de contenu nécessitant une chronologie, comme les journaux personnels ou les blogs."
+'tags':
+  - 'ZEN'
+  - 'Déclaration de date'
+  - 'Markdown'
+  - 'Traitement IA'
+  - 'Chronologie'
+  - 'Expérience utilisateur'
+  - 'Gestion de documents'
+'inferred_date': '2026-01-08'
+'inferred_lang': 'fr-FR'
+---
+
+# Astuces d'utilisation
+
+## Déclarer une date dans le corps du texte
+
+Dans le corps du texte, vous pouvez utiliser une déclaration de date telle que "Aujourd'hui, nous sommes le 8 janvier 2026" (le format et le style sont libres). ZEN la reconnaîtra et la traitera automatiquement.
+
+Dans les documents Markdown traditionnels, la date est déclarée via le YAML Frontmatter, ce qui nécessite de mémoriser le champ correspondant, sans quoi la date risque de ne pas être correctement identifiée.
+
+ZEN permet de déclarer directement la date dans le corps du texte, évitant ainsi le problème d'oublier de remplir le champ dans le Frontmatter.
+
+L'IA extraira et déduira automatiquement les informations de date présentes dans le texte et les traitera comme date de création du document.
+
+Cette méthode est plus flexible et intelligente, améliorant l'expérience utilisateur.
+
+À noter que les documents comportant une date peuvent générer une vue chronologique, facilitant la navigation et la gestion. Cela convient particulièrement aux types de contenu nécessitant une chronologie, comme les journaux personnels ou les blogs.