zengen 0.2.4 → 0.2.6

package/.zen/src/en-US/80ae9bed74fc6348a7c1fe9f33e86b65f5d919169721f77bcf0e1bc29fbdb4f9.md

@@ -1,61 +0,0 @@
----
-title: ZEN Configuration Guide
-summary: This document introduces the configuration and usage of the ZEN tool, including basic commands such as building documentation, live preview, and starting a development server, as well as detailed explanations of command-line options like --watch, --serve, and --port.
-tags:
-  - ZEN
-  - Configuration Guide
-  - Command Line
-  - Documentation Build
-  - Development Server
-  - Minimalism
-inferred_lang: en-US
----
-
-# Configuration Guide
-
-ZEN is designed with a minimalist philosophy, making its configuration very simple.
-
-## Command Line Usage
-
-### Basic Commands
-
-```bash
-# Build documentation (recommended usage)
-npx zengen build
-
-# Live preview (watch for file changes)
-npx zengen build --watch
-
-# Start development server (requires --watch)
-npx zengen build --watch --serve
-
-# Custom port
-npx zengen build --watch --serve --port 8080
-
-# Show verbose logs
-npx zengen build --verbose
-
-# Set base URL
-npx zengen build --base-url /my-docs
-
-# View help
-npx zengen
-```
-
-**Important Notes:**
-
-- ZEN enforces the use of the current directory as the source directory, outputting to the `.zen/dist` directory.
-- Specifying source and output directories via command-line arguments is no longer supported.
-- When using `--watch` mode, modifying files triggers automatic rebuilds.
-
-### Command Line Options
-
-| Option       | Short | Description                                      | Default     |
-| ------------ | ----- | ------------------------------------------------ | ----------- |
-| `--watch`    | `-w`  | Watch for file changes and rebuild automatically | `false`     |
-| `--serve`    | `-s`  | Start development server (requires `--watch`)    | `false`     |
-| `--port`     | `-p`  | Development server port                          | `3000`      |
-| `--host`     |       | Development server host                          | `localhost` |
-| `--verbose`  | `-v`  | Show verbose logs                                | `false`     |
-| `--base-url` |       | Site base URL                                    | None        |
-| `--help`     | `-h`  | Show help information                            | None        |

package/.zen/src/en-US/afbf4998656c97181d0edc711e388ad11e0f08f5c6f329861327202462a3a34a.md

@@ -1,63 +0,0 @@
----
-title: ZEN - Markdown Documentation Site Builder
-summary: ZEN is a minimalist Markdown static site generator that emphasizes content-first, hides configuration, and leverages AI to empower users to focus on writing in their native language, while supporting multilingual translation and intelligent navigation.
-tags:
-  - Markdown
-  - Static Site Generation
-  - AI Translation
-  - Multilingual
-  - Minimalism
-  - Content-First
-  - Documentation Tool
-inferred_lang: en-US
----
-
-# ZEN - A Minimalist Markdown Documentation Site Builder
-
-[简体中文](https://zccz14.github.io/ZEN/zh-Hans) | [English](https://zccz14.github.io/ZEN/en-US)
-
-Why create another Markdown static site generator?
-
-- **Return to Content**: Minimize distractions, let you focus on writing
-
-  Let documentation return to its essence, let writing return to tranquility. I don't want complex build tools with complicated configurations, I dislike fiddling with intricate documentation setups and convoluted structures. Every time I see the configuration files and project structures of tools like Docusaurus, VuePress, or Astro, my head hurts. Now, ZEN chooses to hide all configuration in the `.zen` directory, sweeping it into a corner. Users only need to focus on writing content; ZEN handles the rest. All other directories are your writing space; you can organize your Markdown files however you like. LLMs will automatically help you generate titles, create summaries, categorize, and generate navigation. You really only need to focus on writing.
-
-- **Return to Native Language**: Write only in your native language, smoothly build multilingual versions
-
-  Life is short, I'm too lazy to translate. People can best express the depth of their thinking when using their native language. But staying connected to the world is also necessary; I don't want to give up multilingual communication. So I wanted a tool that allows me to write in my native language while also letting more people see my content. Current i18n solutions not only require you to translate yourself but also to maintain content updates, which is too troublesome. I choose to use LLMs to handle translation for me, saving me a lot of time and enabling one-click translation into multiple languages.
-
-## Core Features
-
-1. **Static Site Generation**
-   - Build any folder containing Markdown files into a static HTML site.
-
-2. **Intelligent Navigation**
-   - Generate site maps and navigation without needing to maintain the original directory structure of the Markdown source files.
-
-3. **Incremental i18n Translation**
-   - Use LLMs for incremental i18n translation, allowing users to write Markdown in their native language while the audience can be multilingual.
-
-## Design Philosophy
-
-- **Minimalism**: Minimal configuration, maximum flexibility.
-- **Content-First**: Focus on writing, not tool configuration.
-- **AI-Powered**: Leverage AI for translation and content organization.
-- **Cross-Language**: Support multilingual content creation and display.
-
-## Quick Start
-
-### Recommended Usage
-
-**It is recommended that users switch to the directory containing their Markdown files and directly use the following command to start building:**
-
-```bash
-npx zengen build
-```
-
-**To view more parameters or help:**
-
-```bash
-npx zengen
-```
-
-**Note**: ZEN enforces using the current directory as the source directory and outputs to the `.zen/dist` directory. It does not support specifying source and output directory parameters.

package/.zen/src/en-US/f0c2799126931ccd113a0c45b1e623870b0d4f4f400becf6dd877da8f1011517.md

@@ -1,40 +0,0 @@
----
-title: Quick Start Guide
-summary: This document introduces how to quickly get started with the ZEN documentation generator, including installation steps, basic usage, and main features.
-tags:
-  - ZEN Documentation Generator
-  - Quick Start
-  - Installation
-  - Basic Usage
-  - Features
-  - Markdown
-  - Build Command
-inferred_lang: en-US
----
-
-# Quick Start Guide
-
-This document introduces how to quickly get started with the ZEN documentation generator.
-
-## Installation
-
-```bash
-npm install -g zengen
-```
-
-## Basic Usage
-
-1. Create a documentation directory
-2. Write Markdown files
-3. Run the build command
-
-```bash
-zengen build --src ./docs --out ./dist
-```
-
-## Features
-
-- Minimal configuration
-- Built-in responsive templates
-- AI-assisted metadata extraction
-- Multi-language support

package/.zen/src/en-US/fdfca9b960d0eaa8b2b96fe988ead7481d2c0b16f66ebc94fb477139b4178cdc.md

@@ -1,65 +0,0 @@
----
-title: ZEN Documentation Site Example
-summary: Introducing ZEN documentation builder, a minimalist Markdown documentation site generator, including features, quick start guide, code examples, and next-step learning resources.
-tags:
-  - ZEN
-  - Documentation Builder
-  - Markdown
-  - Site Generator
-  - Quick Start
-  - Code Examples
-  - Multi-language Support
-inferred_lang: en-US
----
-
-# ZEN Documentation Site Example
-
-Welcome to the ZEN documentation builder! This is a minimalist Markdown documentation site generator.
-
-## Features
-
-- **Minimal Configuration**: No complex configuration files required
-- **Content-First**: Focus on writing, not tool configuration
-- **Smart Navigation**: Automatically generates site maps and navigation
-- **Multi-language Support**: Supports incremental i18n translation
-
-## Quick Start
-
-```bash
-# Build documentation using npx (recommended)
-npx zengen build
-
-# Live preview (watches for file changes)
-npx zengen build --watch
-
-# View more parameters or help
-npx zengen
-```
-
-**Note**: ZEN enforces the use of the current directory as the source directory and outputs to the `.zen/dist` directory. Specifying source and output directory parameters is no longer supported.
-
-## Code Examples
-
-```javascript
-// This is a JavaScript example
-const zen = require('zengen');
-
-async function buildDocs() {
-  await zen.build({
-    // ZEN now enforces using the current directory as the source directory
-    // Outputs to the .zen/dist directory
-  });
-}
-```
-
-```python
-# This is a Python example
-def hello_world():
-    print("Hello from ZEN!")
-```
-
-## Next Steps
-
-1. Read the [API Documentation](./api.md)
-2. Check the [Configuration Guide](./config.md)
-3. Learn about [Best Practices](./best-practices.md)

package/.zen/src/es-ES/04319611d7cde718d0e82da8e034e04b15fb3bb37c3784d8f7313577c5178b06.md

@@ -1,73 +0,0 @@
----
-title: ZEN - Herramienta para construir sitios de documentación en Markdown
-summary: ZEN es una herramienta minimalista para generar sitios estáticos a partir de Markdown, centrada en la escritura de contenido. Utiliza IA para gestionar traducciones y navegación, soporta construcción multilingüe y no requiere configuración compleja.
-tags:
-  - Markdown
-  - Generador de sitios estáticos
-  - Traducción por IA
-  - Multilingüe
-  - Minimalismo
-  - Herramienta de documentación
-  - ZEN
-inferred_lang: es-ES
----
-
-# ZEN - Herramienta sencilla para construir sitios de documentación en Markdown
-
-[简体中文](https://zccz14.github.io/ZEN/zh-Hans) | [English](https://zccz14.github.io/ZEN/en-US) | [Español](https://zccz14.github.io/ZEN/es-ES)
-
-¿Por qué crear otro generador de sitios estáticos con Markdown? He reconsiderado cómo las herramientas de documentación pueden servir mejor a los escritores en la era de la IA:
-
-- **Regreso al contenido**: Minimizar las distracciones, concentrarse en escribir
-
-  Devolver la esencia a la documentación y la tranquilidad a la escritura.
-
-  Primero, no quiero ser un bibliotecario. A veces quiero escribir algo, pero quizás aún no he pensado en su título o no he organizado bien las ideas. Me gustaría que una LLM generara automáticamente títulos, resúmenes, categorías, navegación y otras tareas de organización.
-
-  Segundo, mi estudio debe estar ordenado. No quiero herramientas de construcción con configuraciones complejas, ni lidiar con estructuras complicadas. Cada vez que veo los archivos de configuración y la estructura de proyectos de herramientas como Docusaurus, VuePress o Astro, me duele la cabeza. Ahora, ZEN opta por ocultar toda la configuración en el directorio `.zen`, apartándola a un rincón, para que el usuario solo se centre en escribir el contenido y deje el resto a ZEN. Todos los demás directorios son su espacio de escritura, donde puede organizar sus archivos Markdown como desee.
-
-- **Regreso a la lengua materna**: Escribir en la lengua materna, construir versiones multilingües sin esfuerzo
-
-  La vida es corta, no tengo ganas de traducir. Uno alcanza su máxima profundidad de pensamiento cuando usa su lengua materna. Pero al mismo tiempo, es necesario mantenerse conectado con el mundo; no quiero renunciar a la comunicación multilingüe. Por eso deseo una herramienta que me permita escribir en mi lengua materna y, a la vez, llegar a más personas con mi contenido. Actualmente, la internacionalización (i18n) requiere que uno mismo traduzca y mantenga las actualizaciones del contenido, lo cual es muy tedioso. He optado por usar una LLM para que me ayude con las traducciones, ahorrándome mucho tiempo y permitiéndome completar traducciones a múltiples idiomas con un solo clic.
-
-## Funcionalidades básicas
-
-1. **Generación de sitios estáticos**
-   - Convierte cualquier carpeta que contenga archivos Markdown en un sitio web estático HTML.
-
-2. **Navegación inteligente**
-   - Genera un mapa del sitio y navegación. No es necesario mantener la estructura de directorios original de los archivos fuente Markdown; puedes mover los archivos fuente libremente.
-
-3. **Traducción incremental i18n**
-   - Utiliza LLM para realizar traducciones i18n incrementales, permitiendo a los usuarios escribir Markdown en su lengua materna, pero siendo el resultado multilingüe.
-
-## Filosofía de diseño
-
-- **Minimalismo**: Mínima configuración, máxima flexibilidad.
-- **Contenido primero**: Enfocarse en escribir, no en configurar herramientas.
-- **Potenciado por IA**: Utiliza la IA para gestionar traducciones y organización del contenido.
-- **Multilingüe**: Soporta la creación y visualización de contenido en múltiples idiomas.
-
-## Comenzar rápidamente
-
-### Forma recomendada de uso
-
-**Se recomienda que el usuario cambie al directorio que contiene los archivos Markdown y utilice directamente el siguiente comando para comenzar la construcción:**
-
-```bash
-# Establecer variables de entorno (modificar según su situación real)
-export OPENAI_API_KEY="sk-xxxxxx"  # Obligatorio: reemplazar con su propia clave de API de OpenAI
-export OPENAI_BASE_URL="https://api.openai.com/v1"  # Opcional, por defecto usa la API oficial de OpenAI
-export OPENAI_MODEL="gpt-3.5-turbo"  # Opcional, por defecto usa el modelo gpt-3.5-turbo
-
-# Construir el sitio, soporta traducción multilingüe
-npx zengen@latest build --lang zh-Hans --lang en-US --verbose
-```
-
-**Ver más parámetros o ayuda**:
-
-```bash
-npx zengen
-```
-
-**Nota**: ZEN obliga a usar el directorio actual como directorio fuente y la salida se genera en el directorio `.zen/dist`. No admite parámetros para especificar directorios de origen o de salida.

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

@@ -1,81 +0,0 @@
----
-title: ZEN - Herramienta de construcción de sitios de documentación en Markdown
-summary: ZEN es una herramienta de generación de sitios estáticos en Markdown, sencilla y centrada en el contenido y el minimalismo. Utiliza IA para una navegación inteligente y traducción multilingüe, ayudando a los usuarios a concentrarse en la escritura sin configuraciones complejas.
-tags:
-  - Markdown
-  - Generación de sitios estáticos
-  - Traducción con IA
-  - Multilingüe
-  - Minimalismo
-  - Herramienta de documentación
-  - ZEN
-inferred_lang: es-ES
----
-
-# ZEN - Herramienta de construcción de sitios de documentación en Markdown
-
-[简体中文](https://zccz14.github.io/ZEN/zh-Hans) |
-[English](https://zccz14.github.io/ZEN/en-US) |
-[Español](https://zccz14.github.io/ZEN/es-ES) |
-[Português](https://zccz14.github.io/ZEN/pt-PT) |
-[Русский](https://zccz14.github.io/ZEN/ru-RU) |
-[Français](https://zccz14.github.io/ZEN/fr-FR) |
-[日本語](https://zccz14.github.io/ZEN/ja-JP) |
-[한국어](https://zccz14.github.io/ZEN/ko-KR) |
-[Deutsch](https://zccz14.github.io/ZEN/de-DE) |
-
-¿Por qué crear otro generador de sitios estáticos en Markdown? He reconsiderado cómo las herramientas de documentación pueden servir mejor a los escritores en la era de la IA:
-
-- **Regreso al contenido**: Minimizar las distracciones, concentrarse en escribir
-
-  Devolver la documentación a su esencia, devolver la escritura a la tranquilidad.
-
-  Primero, no quiero ser un bibliotecario. A veces quiero escribir algo, pero quizás aún no he pensado en su título, no he formado una organización particular. Espero que la LLM me ayude automáticamente a generar títulos, hacer resúmenes, clasificar, navegar y otras tareas de organización.
-
-  Segundo, mi estudio debe estar limpio y ordenado. No quiero herramientas de construcción con configuraciones complejas, lidiar con configuraciones de documentos complicadas, ni estructuras complejas. Cada vez que veo los archivos de configuración y la estructura de proyectos de herramientas como Docusaurus, VuePress, Astro, me duele la cabeza. Ahora, ZEN elige ocultar toda la configuración en el directorio `.zen`, barrerla a un rincón. El usuario solo necesita concentrarse en escribir el contenido, y ZEN se encarga del resto. Los demás directorios son su espacio de escritura, puede organizar sus archivos Markdown como desee.
-
-- **Regreso a la lengua materna**: Escribir en la lengua materna, construir versiones multilingües de forma fluida
-
-  La vida es corta, soy demasiado perezoso para traducir. Cuando una persona usa su lengua materna, es cuando puede aprovechar al máximo la profundidad de su pensamiento. Pero al mismo tiempo, mantener la conexión con el mundo es necesario, no quiero renunciar a la comunicación multilingüe. Por eso, deseo una herramienta que me permita escribir en mi lengua materna y, a la vez, permita que más personas vean mi contenido. La i18n actual no solo requiere que uno traduzca por sí mismo, sino que también debe mantener actualizado el contenido, es demasiado engorroso. Elijo usar LLM para ayudarme con la traducción, ahorrándome mucho tiempo y pudiendo completar la traducción a múltiples idiomas con un solo clic.
-
-## Funcionalidades básicas
-
-1. **Generación de sitios estáticos**
-   - Convierte cualquier carpeta que contenga archivos Markdown en un sitio HTML estático.
-
-2. **Navegación inteligente**
-   - Genera un mapa del sitio y navegación. No es necesario mantener la estructura de directorios original de los archivos fuente Markdown; se pueden mover libremente.
-
-3. **Traducción i18n incremental**
-   - Utiliza LLM para realizar traducciones i18n incrementales, permitiendo a los usuarios escribir Markdown en su lengua materna, pero siendo multilingües.
-
-## Filosofía de diseño
-
-- **Minimalismo**: Mínima configuración, máxima flexibilidad.
-- **Contenido primero**: Enfocarse en escribir, no en configurar herramientas.
-- **Potenciado por IA**: Utiliza IA para manejar traducciones y organización de contenido.
-- **Multilingüe**: Soporta la creación y visualización de contenido en múltiples idiomas.
-
-## Comenzar rápidamente
-
-### Forma recomendada de uso
-
-**Se recomienda que los usuarios cambien al directorio que contiene los archivos Markdown y utilicen directamente el siguiente comando para comenzar la construcción:**
-
-```bash
-# Establecer variables de entorno (modificar según su situación real)
-export OPENAI_API_KEY="sk-xxxxxx"  # Obligatorio: reemplazar con su clave API de OpenAI
-export OPENAI_BASE_URL="https://api.openai.com/v1"  # Opcional, por defecto usa la API oficial de OpenAI
-export OPENAI_MODEL="gpt-3.5-turbo"  # Opcional, por defecto usa el modelo gpt-3.5-turbo
-
-# Construir el sitio, soporta traducción multilingüe
-npx zengen@latest build --lang zh-Hans --lang en-US --verbose
-```
-
-**Ver más parámetros o ayuda**:
-
-```bash
-npx zengen
-```
-
-**Nota**: ZEN obliga a usar el directorio actual como directorio fuente y la salida va al directorio `.zen/dist`. No admite parámetros para especificar directorios de origen o de salida.

package/.zen/src/fr-FR/04319611d7cde718d0e82da8e034e04b15fb3bb37c3784d8f7313577c5178b06.md

@@ -1,73 +0,0 @@
----
-title: ZEN - Outil de construction de sites de documentation Markdown
-summary: ZEN est un générateur de site statique Markdown minimaliste, axé sur l'écriture de contenu. Il utilise l'IA pour gérer la traduction et la navigation, prend en charge la construction multilingue et ne nécessite aucune configuration complexe.
-tags:
-  - Markdown
-  - Générateur de site statique
-  - Traduction IA
-  - Multilingue
-  - Minimalisme
-  - Outil de documentation
-  - ZEN
-inferred_lang: fr-FR
----
-
-# ZEN - Outil de construction de site de documentation Markdown épuré
-
-[简体中文](https://zccz14.github.io/ZEN/zh-Hans) | [English](https://zccz14.github.io/ZEN/en-US)
-
-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** : Perturbation minimale, concentration sur l'écriture
-
-  Rendre à la documentation son essence, rendre à l'écriture sa sérénité.
-
-  Premièrement, je ne veux pas être bibliothécaire. Parfois, je veux écrire du contenu, mais je n'ai peut-être pas encore trouvé son titre ou je n'ai pas encore de structure bien définie. J'aimerais que l'IA génère automatiquement les titres, fasse des résumés, classe et organise la navigation.
-
-  Deuxièmement, mon espace de travail doit être propre. Je ne veux pas d'outils de construction complexes à configurer, je ne veux pas me battre avec des configurations de documentation compliquées, et je n'aime pas les structures complexes. Chaque fois que je vois les fichiers de configuration et la structure de projet d'outils comme Docusaurus, VuePress ou Astro, j'ai mal à la tête. Maintenant, ZEN choisit de cacher toute la configuration dans le répertoire `.zen`, de la reléguer 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
-
-  La vie est courte, je n'ai pas envie de traduire. On exprime le mieux la profondeur de sa pensée dans sa langue maternelle. Mais en même temps, rester connecté au monde est nécessaire, et je ne veux pas renoncer à la communication multilingue. J'ai donc souhaité un outil qui me permette d'écrire dans ma langue maternelle tout en permettant à plus de personnes 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, ce qui est trop fastidieux. J'ai choisi d'utiliser l'IA pour m'aider à traduire, ce qui me fait gagner beaucoup de temps et permet de réaliser des traductions multilingues en un clic.
-
-## Fonctionnalités de base
-
-1. **Génération de site statique**
-   - Transforme n'importe quel dossier contenant des fichiers Markdown en un site HTML statique.
-
-2. **Navigation intelligente**
-   - Génère un plan du site et une navigation. Il n'est pas nécessaire de conserver la structure de répertoire originale des fichiers sources Markdown, vous pouvez déplacer les fichiers sources librement.
-
-3. **Traduction i18n incrémentale**
-   - Utilise l'IA pour une traduction i18n incrémentale, permettant à l'utilisateur d'écrire en Markdown dans sa langue maternelle, tout en offrant un contenu multilingue.
-
-## Philosophie de conception
-
-- **Minimalisme** : Configuration minimale, flexibilité maximale.
-- **Priorité au contenu** : Se concentrer sur l'écriture, pas sur la configuration des outils.
-- **IA au service de l'utilisateur** : Utiliser l'IA pour gérer la traduction et l'organisation du contenu.
-- **Multilingue** : Prend en charge la création et l'affichage de contenu multilingue.
-
-## Démarrage rapide
-
-### Méthode d'utilisation recommandée
-
-**Il est recommandé de se placer dans le répertoire contenant les fichiers Markdown et d'utiliser directement la commande suivante pour commencer la construction :**
-
-```bash
-# Définir les variables d'environnement (modifiez selon votre situation)
-export OPENAI_API_KEY="sk-xxxxxx"  # Obligatoire : remplacez par votre clé API OpenAI
-export OPENAI_BASE_URL="https://api.openai.com/v1"  # Optionnel, utilise par défaut l'API officielle OpenAI
-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
-npx zengen@latest build --lang zh-Hans --lang en-US --verbose
-```
-
-**Voir plus de paramètres ou obtenir de l'aide** :
-
-```bash
-npx zengen
-```
-
-**Remarque** : ZEN impose l'utilisation du répertoire courant comme répertoire source et génère la sortie dans le répertoire `.zen/dist`. Il ne prend pas en charge la spécification de paramètres pour le répertoire source ou le répertoire de sortie.

package/.zen/src/fr-FR/48eb2ad3e174cd06ed16c959fa58e0381dbc4a4147fa3456b21eea2b3d67c329.md

@@ -1,81 +0,0 @@
----
-title: ZEN - Outil de construction de site de documentation Markdown
-summary: ZEN est un générateur de site statique Markdown simple, mettant l'accent sur la priorité au contenu et le minimalisme. Il utilise l'IA pour une navigation intelligente et la traduction multilingue, aidant les utilisateurs à se concentrer sur l'écriture sans configuration complexe.
-tags:
-  - Markdown
-  - Génération de site statique
-  - Traduction IA
-  - Multilingue
-  - Minimalisme
-  - Outil de documentation
-  - ZEN
-inferred_lang: fr-FR
----
-
-# ZEN - Outil de construction de site de documentation Markdown simple
-
-[简体中文](https://zccz14.github.io/ZEN/zh-Hans) |
-[English](https://zccz14.github.io/ZEN/en-US) |
-[Español](https://zccz14.github.io/ZEN/es-ES) |
-[Português](https://zccz14.github.io/ZEN/pt-PT) |
-[Русский](https://zccz14.github.io/ZEN/ru-RU) |
-[Français](https://zccz14.github.io/ZEN/fr-FR) |
-[日本語](https://zccz14.github.io/ZEN/ja-JP) |
-[한국어](https://zccz14.github.io/ZEN/ko-KR) |
-[Deutsch](https://zccz14.github.io/ZEN/de-DE) |
-
-Pourquoi créer un autre générateur de site statique Markdown ? J'ai repensé comment 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 tranquillité.
-
-  Premièrement, je ne veux pas être bibliothécaire. Parfois, je veux écrire du contenu, mais je n'ai peut-être pas encore trouvé son titre, ni formé une organisation particulière. J'aimerais que l'IA génère automatiquement des titres, fasse des résumés, des catégorisations, de la navigation et d'autres travaux d'organisation pour moi.
-
-  Deuxièmement, mon bureau doit être rangé. Je ne veux pas d'outils de construction complexes à configurer, je ne veux pas me battre avec des configurations de documentation compliquées, je n'aime pas les structures complexes. 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. L'utilisateur n'a qu'à se concentrer sur le contenu de l'écriture, le reste est géré par ZEN. 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
-
-  La vie est courte, je suis trop paresseux pour 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, rester connecté au monde est nécessaire, 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.
-
-## Fonctionnalités de base
-
-1. **Génération de site statique**
-   - Transforme n'importe quel dossier contenant des fichiers Markdown en un site HTML statique.
-
-2. **Navigation intelligente**
-   - Génère un plan du site et une navigation. Il n'est pas nécessaire de conserver la structure de répertoire originale des fichiers sources Markdown, vous pouvez déplacer les fichiers sources à votre guise.
-
-3. **Traduction i18n incrémentale**
-   - Utilise l'IA pour une traduction i18n incrémentale, permettant aux utilisateurs d'écrire en Markdown dans leur langue maternelle, tout en étant multilingues.
-
-## Philosophie de conception
-
-- **Minimalisme** : Configuration minimale, flexibilité maximale.
-- **Priorité au contenu** : Se concentrer sur l'écriture, pas sur la configuration des outils.
-- **IA au service** : Utiliser l'IA pour gérer la traduction et l'organisation du contenu.
-- **Multilingue** : Prend en charge la création et l'affichage de contenu multilingue.
-
-## Démarrage rapide
-
-### Méthode d'utilisation recommandée
-
-**Il est recommandé aux utilisateurs de se placer dans le répertoire contenant les fichiers Markdown et d'utiliser directement la commande suivante pour commencer la construction :**
-
-```bash
-# Définir les variables d'environnement (modifier selon votre situation réelle)
-export OPENAI_API_KEY="sk-xxxxxx"  # Obligatoire : remplacez par votre clé API OpenAI
-export OPENAI_BASE_URL="https://api.openai.com/v1"  # Optionnel, utilise par défaut l'API officielle OpenAI
-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
-npx zengen@latest build --lang zh-Hans --lang en-US --verbose
-```
-
-**Voir plus de paramètres ou obtenir de l'aide** :
-
-```bash
-npx zengen
-```
-
-**Remarque** : ZEN impose d'utiliser le répertoire courant comme répertoire source et de sortir dans le répertoire `.zen/dist`. Il ne prend pas en charge les paramètres spécifiant le répertoire source et le répertoire de sortie.

package/.zen/src/ja-JP/04319611d7cde718d0e82da8e034e04b15fb3bb37c3784d8f7313577c5178b06.md

@@ -1,71 +0,0 @@
----
-title: ZEN - Markdown ドキュメントサイト構築ツール
-summary: ZEN は、コンテンツ作成に特化した極簡の Markdown 静的サイトジェネレータです。AI を活用した翻訳とナビゲーション処理、複雑な設定不要の多言語構築をサポートします。
-tags:
-  - Markdown
-  - 静的サイトジェネレータ
-  - AI 翻訳
-  - 多言語
-  - ミニマリズム
-  - ドキュメントツール
-  - ZEN
-inferred_lang: ja-JP
----
-
-# ZEN - シンプルな Markdown ドキュメントサイト構築ツール
-
-[简体中文](https://zccz14.github.io/ZEN/zh-Hans) | [English](https://zccz14.github.io/ZEN/en-US)
-
-なぜまた Markdown 静的サイトジェネレータを作ったのか？AI 時代において、ドキュメントツールが書き手により良くサービスを提供する方法を再考しました：
-
-- **コンテンツへの回帰：最小限の干渉で、執筆に集中**
-  ドキュメントの本質と、静かな執筆環境を取り戻します。
-
-  第一に、私は図書館司書になりたくありません。時々何かを書き留めたいことがありますが、タイトルが決まっていなかったり、明確な構成ができていなかったりします。LLM が自動的にタイトルを生成し、要約、分類、ナビゲーションなどの整理作業をしてくれることを望んでいます。
-
-  第二に、私の書斎はきれいに掃除されていなければなりません。複雑な設定ファイルを持つビルドツールや、複雑なドキュメント設定、複雑な構造は好みません。Docusaurus、VuePress、Astro などのツールの設定ファイルやプロジェクト構造を見るたびに頭が痛くなります。現在、ZEN はすべての設定を `.zen` ディレクトリに隠し、隅に追いやることを選択しました。ユーザーは執筆内容に集中し、残りは ZEN が処理します。他のディレクトリはすべてあなたの執筆スペースであり、Markdown ファイルを自由に整理できます。
-
-- **母国語への回帰：母国語で執筆し、滑らかに多言語バージョンを構築**
-  人生は短いので、翻訳は面倒です。人は母国語を使用するとき、自身の思考の深さを最も発揮できます。しかし同時に、世界とのつながりを保つことも必要であり、多言語でのコミュニケーションを諦めたくはありません。そこで、母国語で執筆しながら、より多くの人に私のコンテンツを見てもらえるツールを望んでいます。現在の i18n は自分で翻訳するだけでなく、コンテンツの更新も自分で管理しなければならず、非常に面倒です。私は LLM を使って翻訳を手伝ってもらうことを選択し、多くの時間を節約し、ワンクリックで多国語翻訳を完了できます。
-
-## 基本機能
-
-1.  **静的サイト生成**
-    - Markdown を含む任意のフォルダを静的 HTML サイトに構築します。
-
-2.  **インテリジェントナビゲーション**
-    - サイトマップとナビゲーションを生成します。元の Markdown ソースファイルのディレクトリ構造を維持する必要はなく、ソースファイルを自由に移動できます。
-
-3.  **インクリメンタル i18n 翻訳**
-    - LLM を使用したインクリメンタル i18n 翻訳により、ユーザーは母国語で Markdown を記述できますが、ユーザーは多言語対応になります。
-
-## 設計理念
-
-- **ミニマリズム**: 最小限の設定、最大限の柔軟性
-- **コンテンツファースト**: ツールの設定ではなく、執筆に集中
-- **AI エンパワーメント**: AI を活用した翻訳とコンテンツ整理
-- **クロスランゲージ**: 多言語コンテンツの作成と表示をサポート
-
-## クイックスタート
-
-### 推奨使用方法
-
-**ユーザーは Markdown ファイルを含むディレクトリに移動し、以下のコマンドを直接使用して構築を開始することをお勧めします：**
-
-```bash
-# 環境変数を設定する (実際の状況に応じて変更してください)
-export OPENAI_API_KEY="sk-xxxxxx"  # 必須：ご自身の OpenAI API Key に置き換えてください
-export OPENAI_BASE_URL="https://api.openai.com/v1"  # オプション、デフォルトは OpenAI 公式 API を使用
-export OPENAI_MODEL="gpt-3.5-turbo"  # オプション、デフォルトは gpt-3.5-turbo モデルを使用
-
-# サイトを構築し、多言語翻訳をサポート
-npx zengen@latest build --lang zh-Hans --lang en-US --verbose
-```
-
-**その他のパラメータやヘルプを表示する**：
-
-```bash
-npx zengen
-```
-
-**注意**：ZEN は現在のディレクトリをソースディレクトリとして使用し、`.zen/dist` ディレクトリに出力することを強制します。ソースディレクトリと出力ディレクトリのパラメータ指定はサポートしていません。