czon 0.1.1 → 0.1.3

package/.zen/src/es-MX/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md

@@ -1,71 +0,0 @@
----
-'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/es-MX/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md

@@ -1,30 +0,0 @@
----
-'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/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md

@@ -1,121 +0,0 @@
----
-'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/579c3a203225b8b7aead541f42381de0619d8bc1d451d0d9c3267dbc74205503.md

@@ -1,79 +0,0 @@
----
-'title': 'KaTeX-kaavojen näyttötesti'
-'summary': 'Tämä dokumentti on esimerkki KaTeX-kaavojen näyttötestausta varten. Se sisältää useita rivinsisäisiä ja lohkotason matemaattisia kaavoja, kuten E=mc^2, integraaleja, derivaattoja, sarjoja, paloittain määriteltyjä funktioita, taulukoita ja matriiseja, ja sen tarkoituksena on varmistaa kaavojen oikea renderöinti.'
-'tags':
-  - 'KaTeX'
-  - 'kaavotesti'
-  - 'matemaattiset kaavat'
-  - 'LaTeX'
-  - 'näyttövaikutelma'
-  - 'dokumenttiesimerkki'
-'inferred_lang': 'fi-FI'
----
-
-# KaTeX-kaavojen näyttötesti
-
-Tämä on rivinsisäinen kaavatestaus: $ E = mc^2 $.
-
-Tämä on lohkotason kaavatestaus:
-
-$$
-\int_a^b f(x) \, dx = F(b) - F(a)
-$$
-
-Tämä on toinen lohkotason kaavatestaus:
-
-$$
-\frac{d}{dx}e^x = e^x
-$$
-
-Tämä on monimutkainen kaavatestaus:
-
-$$
-\sum_{n=1}^{\infty} \frac{1}{n^2} = \frac{\pi^2}{6}
-$$
-
-Kaavatestaus cases-rakenteella:
-
-$$
-f(x) =
-\begin{cases}
-x^2 & \text{if } x \geq 0 \\
--x & \text{if } x < 0
-\end{cases}
-$$
-
-Taulukkokaava:
-
-$$
-\begin{array}{c|c|c}
-a & b & c \\
-\hline
-1 & 2 & 3 \\
-4 & 5 & 6 \\
-\end{array}
-$$
-
-Matriisikaava:
-
-$$
-\begin{pmatrix}
-1 & 2 \\
-3 & 4
-\end{pmatrix}
-$$
-
-Kaavatestaus tekstielementeillä:
-
-$$
-E = mc^2 \quad \text{where } m \text{ is mass and
-    } c \text{ is the speed of light}
-$$
-
-Yleistetty Kellyn kaava:
-
-$$
-f^* = \argmax_f \sum_{i \in X} P_i \ln (1 + f \cdot R_i)
-$$
-
-Varmista, että kaikki yllä olevat kaavat näkyvät oikein.

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

@@ -1,70 +0,0 @@
----
-'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
-```

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

@@ -1,71 +0,0 @@
----
-'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 -staattisen sivuston rakentaja
-
-[> Verkkosivuston demo](https://zccz14.github.io/ZEN/)
-
-## Perustoiminnot
-
-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 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, anna kirjoittamisen olla rauhallista.
-
-  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, 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 monikielisiä versioita sulavasti
-
-  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.
-
-## 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 gitistä, .gitignore-sääntöjen mukaisesti suodatettujen tiedostojen ohittamiseksi)
-
-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, 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 zh-Hans --lang en-US`).
-- Voit määrittää sivuston perus-URL-etuliitteen `--base-url`-parametrilla (esim. GitHub Pages -varaston nimi).
-- Lähdekielen määritystä ei tarvita, 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
-```

package/.zen/src/fi-FI/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md

@@ -1,71 +0,0 @@
----
-'title': 'ZEN - Minimalistinen Markdown + AI -staattisen sivuston rakentaja'
-'summary': 'ZEN on staattinen sivustogeneraattori, joka yhdistää tekoälyominaisuuksia ja on suunniteltu Markdown-dokumenteille. Sen avulla käyttäjät voivat muuntaa Git-kansion, joka sisältää Markdown-tiedostoja, staattiseksi HTML-sivustoksi ilman monimutkaisia määrityksiä. Kaikki asetukset piilotetaan .zen-hakemistoon. Keskeisiin ominaisuuksiin kuuluvat älykäs luokittelu ja navigointi (käyttäen tekoälyä sisällön analysointiin ja sivustokartan luomiseen), automaattinen inkrementaalinen käännös (tukee monikielisiä versioita, jolloin käyttäjät voivat kirjoittaa äidinkielellään ja tekoäly käsittelee käännökset) sekä häiriöttömän kirjoittamisen kokemus. Pika-aloitusoppaassa vaaditaan Node.js:n asennus, OpenAI API -avaimen ja Gitin hankinta, sivuston rakentaminen komentorivin kautta sekä kielen ja perus-URL:n määrittäminen.'
-'tags':
-  - 'staattinen sivustogeneraattori'
-  - 'Markdown'
-  - 'tekoäly'
-  - 'monikielinen käännös'
-  - 'minimalismi'
-  - 'dokumentointityökalu'
-  - 'Git'
-'inferred_lang': 'zh-Hans'
----
-
-# ZEN - Minimalistinen Markdown + AI -staattisen sivuston rakentaja
-
-[> Sivuston demo](https://zen.zccz14.com/)
-
-## Perusominaisuudet
-
-1. 📃 **Staattisen sivuston generointi**: Muunna mikä tahansa Git-kansio, joka sisältää Markdown-tiedostoja, staattiseksi HTML-sivustoksi.
-2. 🧭 **Älykäs luokittelu ja navigointi**: Käytä tekoälyä sisällön analysointiin, luo sivustokartta ja navigointi. Lähdetiedostojen sijainti ei ole merkityksellinen.
-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 sivustogeneraattorin? Olen uudelleen miettinyt, kuinka dokumentointityökalut voisivat palvella kirjoittajia paremmin tekoälyn aikakaudella:
-
-- Palaa sisältöön: Minimoi häiriöt, keskitty kirjoittamiseen
-
-  Palauta dokumentointi olemukseensa, tuo kirjoittamiseen rauha.
-
-  Ensinnäkin, en halua olla kirjastonhoitaja. Haluan joskus kirjoittaa 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. En halua monimutkaisia määritystyökaluja, sotkea monimutkaisia dokumentointimäärityksiä tai monimutkaisia rakenteita. Joka kerta, kun näen Docusaurus-, VuePress- tai Astro-työkalujen määritystiedostot ja projektirakenteet, särkee pääni. Nyt ZEN piilottaa kaikki määritykset .zen-hakemistoon, työnnä ne nurkkaan. Käyttäjän tarvitsee keskittyä vain sisällön kirjoittamiseen, loput hoitaa ZEN. Kaikki muut hakemistot ovat kirjoitustilaa, voit järjestellä Markdown-tiedostojasi vapaasti.
-
-- Palaa äidinkieleen: Kirjoita äidinkielellä, luo monikieliset versiot sujuvasti
-
-  Elämä on lyhyt, en jaksa kääntää. Ihmiset pystyvät parhaiten hyödyntämään ajattelunsa syvyyttä äidinkielellään. Mutta yhteydenpito maailmaan on myös välttämätöntä, en halua luopua monikielisestä vuorovaikutuksesta. Siksi toivon työkalua, jonka avulla voin kirjoittaa äidinkielelläni ja samalla näyttää sisältöni useammille ihmisille. Nykyinen i18n vaatii oman käännöksen ja sisällön päivitysten ylläpidon, se on liian vaivalloista. Käytän LLM:ää auttamaan käännöksissä, se säästää paljon aikaa ja monikieliset käännökset voidaan tehdä yhdellä napsautuksella.
-
-## Pika-aloitus
-
-Edellytykset:
-
-- [Node.js](https://nodejs.org/) asennettuna (suositellaan versiota 18 tai uudempaa, 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 Gitistä, .gitignore-sääntöjen mukaisesti suodatetut tiedostot ohitetaan)
-
-Ensiksi, työskentele kansiossa, joka on jo Git-hallinnassa:
-
-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, 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 zh-Hans --lang en-US`).
-- Voit määrittää sivuston perus-URL-etuliitteen `--base-url`-parametrilla (esim. GitHub Pages -varaston nimi).
-- Lähdekielen määritystä ei tarvita, ZEN tunnistaa sen automaattisesti.
-
-```bash
-npx zengen@latest build --lang zh-Hans --lang en-US
-```
-
-**Näe lisää parametreja tai ohjeita**:
-
-```bash
-npx zengen@latest
-```

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

@@ -1,30 +0,0 @@
----
-'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/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md

@@ -1,121 +0,0 @@
----
-'title': 'Document de test des diagrammes Mermaid'
-'summary': "Ce document est un fichier de test destiné à vérifier la fonctionnalité de rendu des diagrammes Mermaid dans ZEN. Il contient des exemples de plusieurs types de diagrammes Mermaid, tels que des organigrammes, des diagrammes de séquence, des diagrammes de Gantt, des diagrammes de classes, des diagrammes d'état et des diagrammes circulaires, et inclut un test de syntaxe erronée pour vérifier l'affichage des messages d'erreur. Le document vise à démontrer le fonctionnement correct de l'intégration de Mermaid dans ZEN."
-'tags':
-  - 'Mermaid'
-  - 'Test de diagrammes'
-  - 'ZEN'
-  - 'Organigramme'
-  - 'Diagramme de séquence'
-  - 'Diagramme de Gantt'
-  - 'Diagramme de classes'
-  - "Diagramme d'état"
-'inferred_date': '2024-01-01'
-'inferred_lang': 'fr-FR'
----
-
-# Test des diagrammes Mermaid
-
-Ceci est un fichier de test destiné à vérifier la fonctionnalité de rendu des diagrammes Mermaid dans ZEN.
-
-## Exemple d'organigramme
-
-```mermaid
-graph TD
-    A[Commencement] --> B{Continuer ?}
-    B -->|Oui| C[Exécuter l'opération]
-    B -->|Non| D[Fin]
-    C --> E[Vérifier le résultat]
-    E --> F{Succès ?}
-    F -->|Oui| G[Terminé]
-    F -->|Non| H[Réessayer]
-    H --> C
-    G --> D
-```
-
-## Exemple de diagramme de séquence
-
-```mermaid
-sequenceDiagram
-    participant Utilisateur
-    participant Système
-    participant Base_de_données
-
-    Utilisateur->>Système: Soumettre une requête
-    Système->>Base_de_données: Interroger les données
-    Base_de_données-->>Système: Retourner le résultat
-    Système-->>Utilisateur: Afficher le résultat
-```
-
-## Exemple de diagramme de Gantt
-
-```mermaid
-gantt
-    title Calendrier du projet
-    dateFormat  YYYY-MM-DD
-    section Conception
-    Analyse des besoins     :done,    des1, 2024-01-01, 7d
-    Conception du prototype :active,  des2, 2024-01-08, 5d
-    Conception détaillée    :         des3, after des2, 5d
-    section Développement
-    Développement front-end :         dev1, after des3, 10d
-    Développement back-end  :         dev2, after des3, 15d
-    section Tests
-    Tests unitaires         :         test1, after dev1, 5d
-    Tests d'intégration     :         test2, after dev2, 5d
-```
-
-## Exemple de diagramme de classes
-
-```mermaid
-classDiagram
-    class Animal {
-        +String nom
-        +int âge
-        +void manger()
-        +void dormir()
-    }
-    class Chien {
-        +void aboyer()
-    }
-    class Chat {
-        +void miauler()
-    }
-
-    Animal <|-- Chien
-    Animal <|-- Chat
-```
-
-## Exemple de diagramme d'état
-
-```mermaid
-stateDiagram-v2
-    [*] --> Inactif
-    Inactif --> Traitement_en_cours : Démarrer le traitement
-    Traitement_en_cours --> Succès : Traitement réussi
-    Traitement_en_cours --> Erreur : Échec du traitement
-    Succès --> [*]
-    Erreur --> [*]
-```
-
-## Exemple de diagramme circulaire
-
-```mermaid
-pie title Taux d'utilisation des navigateurs
-    "Chrome" : 65.2
-    "Firefox" : 15.3
-    "Safari" : 12.5
-    "Edge" : 5.2
-    "Autres" : 1.8
-```
-
-## Test de syntaxe erronée (devrait afficher un message d'erreur)
-
-```mermaid
-graph TD
-    A --> B
-    // Définition de flèche manquante ici
-    C --> D
-```
-
-Ce fichier de test contient plusieurs types de diagrammes Mermaid pour vérifier que l'intégration de Mermaid dans ZEN fonctionne correctement.