zengen 0.2.4 → 0.2.6

package/.zen/src/pt-BR/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md

@@ -1,70 +1,70 @@
 ---
-title: ZEN - Construtor de Site Estático Minimalista Markdown + IA
-summary: ZEN é um gerador de site estático integrado com IA, suportando navegação por categorização inteligente e tradução incremental automática, permitindo que os usuários se concentrem em escrever em sua língua materna e simplificando o processo de configuração e construção.
-tags:
-  - Gerador de Site Estático
-  - Markdown
-  - IA
-  - Tradução Multilíngue
-  - Minimalismo
-  - Ferramenta de Documentação
-  - Node.js
-inferred_lang: pt-BR
+'title': 'ZEN - Construtor de Site Estático Minimalista com Markdown + IA'
+'summary': 'ZEN é um gerador de sites estáticos com funcionalidades de IA, projetado para simplificar a escrita de documentação e o processo de construção de sites. Permite que os usuários se concentrem em escrever conteúdo em Markdown em sua língua materna, processando automaticamente a geração de títulos, navegação por categorias e tradução incremental, com suporte a versões multilíngues, sem configurações complexas. A ferramenta é baseada em Node.js e na API da OpenAI, construindo sites rapidamente via linha de comando, ideal para escritores que buscam eficiência e simplicidade.'
+'tags':
+  - 'Gerador de Site Estático'
+  - 'Markdown'
+  - 'IA'
+  - 'Minimalismo'
+  - 'Tradução Multilíngue'
+  - 'Node.js'
+  - 'OpenAI'
+'inferred_lang': 'pt-BR'
 ---
 
-# ZEN - Construtor de Site Estático Minimalista Markdown + IA
+# ZEN - Construtor de Site Estático Minimalista com Markdown + IA
 
 [> Demonstração do Site](https://zccz14.github.io/ZEN/)
 
 ## Funcionalidades Básicas
 
-1.  📃 **Geração de Site Estático**: Transforma qualquer pasta git contendo arquivos Markdown em um site HTML estático.
-2.  🧭 **Navegação por Categorização Inteligente**: Utiliza IA para análise de conteúdo, gerando mapa do site e navegação, independente da localização dos arquivos fonte.
-3.  🌍 **Tradução Incremental Automática**: Utiliza IA para tradução incremental, permitindo que o usuário escreva em Markdown usando sua língua materna, mas o conteúdo final pode ser multilíngue.
+1. 📃 **Geração de Site Estático**: Transforma qualquer pasta git contendo Markdown em um site HTML estático.
+2. 🧭 **Navegação Inteligente por Categorias**: Usa IA para analisar o conteúdo, gerando mapa do site e navegação, independente da localização dos arquivos fonte.
+3. 🌍 **Tradução Incremental Automática**: Usa IA para tradução incremental, permitindo que o usuário escreva em Markdown em sua língua materna, mas com suporte multilíngue.
 
-Por que criar mais um gerador de site estático com Markdown? Reflito sobre como as ferramentas de documentação podem servir melhor aos escritores na era da IA:
+Por que criar mais um gerador de site estático com Markdown? Reflito sobre como as ferramentas de documentação podem servir melhor os escritores na era da IA:
 
-- Retorno ao Conteúdo: Minimizar distrações, focar na escrita
+- Retorno ao conteúdo: Minimizar distrações, focar na escrita
 
-  Devolver a essência à documentação, devolver a tranquilidade à escrita.
+  Devolver a essência à documentação e a tranquilidade à escrita.
 
-  Primeiro, não quero ser um bibliotecário. Às vezes quero anotar algo, mas talvez ainda não tenha pensado em um título, ou não tenha uma organização clara. Espero que um LLM (Large Language Model) me ajude automaticamente a gerar títulos, resumos, categorias, navegação e outras tarefas de organização.
+  Primeiro, não quero ser um bibliotecário. Às vezes quero anotar algo, mas talvez ainda não tenha pensado no título ou na organização. Quero que um LLM gere automaticamente títulos, resumos, categorias, navegação e outras tarefas de organização.
 
-  Segundo, meu escritório precisa estar arrumado. Não quero configurar ferramentas de construção complexas, lidar com configurações de documentação intrincadas, nem gosto de estruturas complicadas. Sempre que vejo os arquivos de configuração e a estrutura de projetos de ferramentas como Docusaurus, VuePress, Astro, fico com dor de cabeça. Agora, o ZEN opta por esconder todas as configurações no diretório `.zen`, varrendo-as para um canto. O usuário só precisa se concentrar no conteúdo da escrita, o resto fica por conta do ZEN. Todos os outros diretórios são seu espaço de escrita, você pode organizar seus arquivos Markdown como quiser.
+  Segundo, meu espaço de trabalho deve estar limpo. Não quero ferramentas de construção com configurações complexas, nem estruturas complicadas. Sempre que vejo os arquivos de configuração e a estrutura de projetos de ferramentas como Docusaurus, VuePress ou Astro, fico com dor de cabeça. Agora, o ZEN esconde todas as configurações no diretório `.zen`, deixando o usuário focado apenas no conteúdo da escrita. Os outros diretórios são seu espaço de escrita, onde você pode organizar seus arquivos Markdown livremente.
 
-- Retorno à Língua Materna: Escreva em sua língua materna, construa versões multilíngues suavemente
+- Retorno à língua materna: Escrever na língua materna, construindo versões multilíngues de forma fluida
 
-  A vida é curta, não tenho paciência para traduzir. As pessoas atingem sua máxima profundidade de pensamento quando usam sua língua materna. Mas, ao mesmo tempo, manter-se conectado ao mundo é necessário, não quero abrir mão da comunicação multilíngue. Portanto, desejo uma ferramenta que me permita escrever em minha língua materna e, ao mesmo tempo, permita que mais pessoas vejam meu conteúdo. Atualmente, o i18n exige que você mesmo traduza e ainda mantenha as atualizações do conteúdo, o que é muito trabalhoso. Escolhi usar LLM para me ajudar com a tradução, economizando muito tempo e permitindo a tradução para vários idiomas com um clique.
+  A vida é curta, não tenho paciência para traduzir. É na língua materna que conseguimos expressar nossa profundidade de pensamento. Mas manter conexão com o mundo também é necessário, e não quero abrir mão da comunicação multilíngue. Por isso, desejo uma ferramenta que me permita escrever na minha língua materna e, ao mesmo tempo, tornar meu conteúdo acessível a mais pessoas. Atualmente, o i18n exige que você mesmo traduza e mantenha as atualizações, o que é muito trabalhoso. Escolhi usar LLM para fazer a tradução, economizando tempo e permitindo a tradução para vários idiomas com um clique.
 
-## Início Rápido
+## Começo Rápido
 
 Pré-requisitos:
 
-- Ter o [Node.js](https://nodejs.org/) instalado (versão 18 ou superior recomendada, necessário comando `npx`)
-- Ter uma [Chave de API da OpenAI](https://platform.openai.com/account/api-keys), ou uma chave de API compatível com OpenAI
-- Ter o Git instalado (para listar arquivos Markdown de um repositório Git, ignorando arquivos filtrados pelas regras do `.gitignore`)
+- [Node.js](https://nodejs.org/) instalado (versão 18 ou superior recomendada, com comando `npx` disponível)
+- Chave da [API da OpenAI](https://platform.openai.com/account/api-keys) obtida, ou chave de API compatível com OpenAI
+- Git instalado (para listar arquivos Markdown de um repositório git, ignorando arquivos filtrados por regras `.gitignore`)
 
-Primeiro, trabalhe em uma pasta que já esteja sob controle do Git:
+Primeiro, trabalhe em uma pasta já gerenciada pelo git:
 
-Configure as variáveis de ambiente
+Configure as variáveis de ambiente:
 
 ```bash
-export OPENAI_API_KEY="sk-xxxxxx"  # Obrigatório: Substitua pela sua Chave de API da OpenAI
+export OPENAI_API_KEY="sk-xxxxxx"  # Obrigatório: substitua pela sua chave da API da OpenAI
 export OPENAI_BASE_URL="https://api.openai.com/v1"  # Opcional, usa a API oficial da OpenAI por padrão
 export OPENAI_MODEL="gpt-3.5-turbo"  # Opcional, usa o modelo gpt-3.5-turbo por padrão
 ```
 
-Construa o site, com suporte a tradução multilíngue. Usa o diretório atual como fonte e gera a saída no diretório `.zen/dist`.
+Construa o site, com suporte a tradução multilíngue. Use o diretório atual como fonte e saída no diretório `.zen/dist`.
 
-- É possível especificar os idiomas a serem gerados usando o parâmetro `--lang` várias vezes (ex: `--lang pt-BR --lang en-US`).
-- É possível especificar o prefixo da URL base do site usando o parâmetro `--base-url` (ex: nome do repositório no GitHub Pages).
-- Não é necessário configurar o idioma fonte, o ZEN detecta automaticamente.
+- É possível especificar os idiomas de saída usando o parâmetro `--lang` várias vezes (ex.: `--lang pt-BR --lang en-US`).
+- Use o parâmetro `--base-url` para definir o prefixo da URL base do site (ex.: nome do repositório no GitHub Pages).
+- Não é necessário configurar o idioma fonte; o ZEN detecta automaticamente.
 
 ```bash
 npx zengen@latest build --lang pt-BR --lang en-US
 ```
 
-**Veja mais parâmetros ou obtenha ajuda**:
+**Veja mais parâmetros ou ajuda**:
 
 ```bash
 npx zengen@latest

package/.zen/src/pt-BR/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md

@@ -0,0 +1,30 @@
+---
+'title': 'Técnicas de Uso da Declaração de Datas em Documentos ZEN'
+'summary': 'Este documento apresenta técnicas para declarar datas diretamente no corpo do texto usando a ferramenta ZEN, contrastando com o método tradicional do Markdown que utiliza YAML Frontmatter. Destaca a capacidade de reconhecimento automático e processamento inteligente do ZEN, melhorando a experiência do usuário, e é ideal para tipos de conteúdo como diários e blogs que exigem uma linha do tempo.'
+'tags':
+  - 'ZEN'
+  - 'Declaração de Datas'
+  - 'Markdown'
+  - 'Processamento por IA'
+  - 'Linha do Tempo'
+  - 'Experiência do Usuário'
+  - 'Gerenciamento de Documentos'
+'inferred_date': '2026-01-08'
+'inferred_lang': 'pt-BR'
+---
+
+# Técnicas de Uso
+
+## Declarando Datas no Corpo do Texto
+
+No corpo do texto, você pode usar declarações de data como "Hoje é 8 de janeiro de 2026" (o estilo de formatação é livre), e o ZEN irá reconhecer e processar automaticamente.
+
+Documentos Markdown tradicionais declaram datas através do YAML Frontmatter, exigindo que o usuário lembre os campos correspondentes, caso contrário, a data pode não ser identificada corretamente.
+
+O ZEN suporta a declaração direta de datas no corpo do texto, evitando o problema de esquecer de preencher os campos do Frontmatter.
+
+A IA extrairá e inferirá automaticamente as informações de data presentes no texto, tratando-as como a data de criação do documento.
+
+Essa abordagem é mais flexível e inteligente, melhorando a experiência do usuário.
+
+A propósito, documentos com datas podem gerar uma visualização de linha do tempo, facilitando a navegação e o gerenciamento. É especialmente útil para tipos de conteúdo como diários e blogs que exigem uma linha do tempo.

package/.zen/src/pt-PT/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md

@@ -1,15 +1,15 @@
 ---
-title: ZEN - Construtor de Sites Estáticos Minimalista com Markdown + IA
-summary: ZEN é um gerador de sites estáticos com IA, suportando navegação inteligente por categorias e tradução incremental automática, permitindo que os utilizadores se concentrem em escrever na sua língua materna, simplificando o processo de configuração e construção.
-tags:
-  - Gerador de Sites Estáticos
-  - Markdown
-  - IA
-  - Tradução Multilingue
-  - Minimalismo
-  - Ferramentas de Documentação
-  - Node.js
-inferred_lang: pt-PT
+'title': 'ZEN - Construtor de Sites Estáticos Minimalista com Markdown + IA'
+'summary': 'O ZEN é um gerador de sites estáticos com funcionalidades de IA, concebido para simplificar a escrita de documentação e o processo de construção de sites. Permite que os utilizadores se concentrem em escrever conteúdo em Markdown na sua língua materna, processando automaticamente a geração de títulos, navegação por categorias e tradução incremental, suportando versões multilingues sem configuração complexa. A ferramenta baseia-se em Node.js e na API da OpenAI, construindo sites rapidamente através da linha de comandos, sendo ideal para escritores que valorizam eficiência e simplicidade.'
+'tags':
+  - 'Gerador de Sites Estáticos'
+  - 'Markdown'
+  - 'IA'
+  - 'Minimalismo'
+  - 'Tradução Multilingue'
+  - 'Node.js'
+  - 'OpenAI'
+'inferred_lang': 'pt-PT'
 ---
 
 # ZEN - Construtor de Sites Estáticos Minimalista com Markdown + IA
@@ -18,46 +18,46 @@ inferred_lang: pt-PT
 
 ## Funcionalidades Básicas
 
-1.  📃 **Geração de Sites Estáticos**: Constrói uma pasta git contendo ficheiros Markdown num site HTML estático.
-2.  🧭 **Navegação Inteligente por Categorias**: Utiliza IA para analisar o conteúdo, gerando um mapa do site e navegação, independente da localização dos ficheiros de origem.
-3.  🌍 **Tradução Incremental Automática**: Utiliza IA para tradução incremental, permitindo que os utilizadores escrevam Markdown na sua língua materna, mas o conteúdo pode ser multilingue.
+1. 📃 **Geração de Sites Estáticos**: Constrói um site HTML estático a partir de qualquer pasta git que contenha ficheiros Markdown.
+2. 🧭 **Navegação Inteligente por Categorias**: Utiliza IA para analisar o conteúdo, gerando um mapa do site e navegação, independentemente da localização dos ficheiros de origem.
+3. 🌍 **Tradução Automática Incremental**: Utiliza IA para realizar traduções incrementais, permitindo que os utilizadores escrevam em Markdown na sua língua materna, mas com suporte multilingue.
 
 Porque criar mais um gerador de sites estáticos com Markdown? Refliti sobre como as ferramentas de documentação podem servir melhor os escritores na era da IA:
 
-- Regresso ao Conteúdo: Minimizar distrações, focar na escrita
+- Regresso ao conteúdo: Minimizar distrações, focar na escrita
 
-  Devolver a essência à documentação, devolver a tranquilidade à escrita.
+  Devolver a essência à documentação e a serenidade à escrita.
 
-  Primeiro, não quero ser um bibliotecário. Por vezes quero escrever algo, mas ainda não pensei no título ou na sua organização. Desejo que um LLM me ajude automaticamente a gerar títulos, resumos, categorias, navegação e outras tarefas de organização.
+  Primeiro, não quero ser um bibliotecário. Por vezes, quero escrever algo, mas ainda não pensei no título ou na sua organização. Desejo que um LLM gere automaticamente títulos, resumos, categorias, navegação e outras tarefas de organização.
 
-  Segundo, o meu escritório deve estar arrumado. Não quero ferramentas de construção complexas para configurar, nem estruturas de documentos complicadas. Sempre que vejo os ficheiros de configuração e estruturas de projetos de ferramentas como Docusaurus, VuePress ou Astro, fico com dor de cabeça. Agora, o ZEN opta por esconder toda a configuração no diretório `.zen`, varrendo-a para um canto. O utilizador só precisa de se concentrar no conteúdo da escrita, o resto fica a cargo do ZEN. Todos os outros diretórios são o seu espaço de escrita, pode organizar os seus ficheiros Markdown como desejar.
+  Segundo, o meu espaço de trabalho deve estar arrumado. Não quero ferramentas de construção com configurações complexas, nem estruturas complicadas. Sempre que vejo os ficheiros de configuração e estruturas de projetos de ferramentas como Docusaurus, VuePress ou Astro, fico com dor de cabeça. Agora, o ZEN opta por esconder todas as configurações no diretório `.zen`, arrumando-as num canto, para que o utilizador se concentre apenas no conteúdo da escrita, deixando o resto a cargo do ZEN. Todos os outros diretórios são o seu espaço de escrita, onde pode organizar os seus ficheiros Markdown livremente.
 
-- Regresso à Língua Materna: Escrever na língua materna, construir versões multilingues de forma fluida
+- Regresso à língua materna: Escrever na língua materna, construindo versões multilingues de forma fluida
 
-  A vida é curta, não tenho paciência para traduzir. É na língua materna que conseguimos expressar a nossa profundidade de pensamento. No entanto, manter a ligação com o mundo é necessário, não quero abdicar da comunicação multilingue. Por isso, desejo uma ferramenta que me permita escrever na minha língua materna e, ao mesmo tempo, tornar o meu conteúdo acessível a mais pessoas. Atualmente, o i18n exige que traduzamos e mantenhamos as atualizações de conteúdo, o que é demasiado trabalhoso. Opto por usar um LLM para me ajudar com as traduções, poupando muito tempo e permitindo a tradução para vários idiomas com um clique.
+  A vida é curta, não tenho paciência para traduzir. É na língua materna que conseguimos explorar melhor a profundidade do nosso pensamento. No entanto, manter a ligação com o mundo é essencial, e não quero abdicar da comunicação multilingue. Por isso, desejei uma ferramenta que me permitisse escrever na minha língua materna, ao mesmo tempo que torna o meu conteúdo acessível a mais pessoas. Atualmente, o i18n exige que façamos as nossas próprias traduções e mantenhamos as atualizações de conteúdo, o que é demasiado trabalhoso. Optei por utilizar um LLM para me ajudar nas traduções, poupando-me muito tempo e permitindo a tradução para vários idiomas com um único clique.
 
 ## Início Rápido
 
 Pré-requisitos:
 
-- Ter o [Node.js](https://nodejs.org/) instalado (versão 18 ou superior recomendada, necessário comando `npx`)
+- Ter o [Node.js](https://nodejs.org/) instalado (recomenda-se versão 18 ou superior, com comando npx disponível)
 - Obter uma [Chave de API da OpenAI](https://platform.openai.com/account/api-keys), ou uma chave de API compatível com a OpenAI
-- Ter o Git instalado (para listar ficheiros Markdown a partir de um repositório Git, ignorando ficheiros filtrados pelas regras do `.gitignore`)
+- Ter o Git instalado (para listar ficheiros Markdown a partir de um repositório Git, ignorando ficheiros filtrados pelas regras do .gitignore)
 
-Primeiro, trabalhe numa pasta já gerida pelo Git:
+Primeiro, trabalhe numa pasta já gerida pelo git:
 
 Configure as variáveis de ambiente
 
 ```bash
 export OPENAI_API_KEY="sk-xxxxxx"  # Obrigatório: Substitua pela sua Chave de API da OpenAI
-export OPENAI_BASE_URL="https://api.openai.com/v1"  # Opcional, por padrão usa a API oficial da OpenAI
-export OPENAI_MODEL="gpt-3.5-turbo"  # Opcional, por padrão usa o modelo gpt-3.5-turbo
+export OPENAI_BASE_URL="https://api.openai.com/v1"  # Opcional, utiliza por predefinição a API oficial da OpenAI
+export OPENAI_MODEL="gpt-3.5-turbo"  # Opcional, utiliza por predefinição o modelo gpt-3.5-turbo
 ```
 
-Construa o site, suportando tradução multilingue. Usa o diretório atual como origem e gera a saída no diretório `.zen/dist`.
+Construa o site, com suporte para tradução multilingue. Utiliza o diretório atual como fonte e gera a saída para o diretório `.zen/dist`.
 
-- Pode especificar as versões de idioma a gerar usando o parâmetro `--lang` várias vezes (ex: `--lang pt-PT --lang en-US`).
-- Pode especificar o prefixo do URL base do site com o parâmetro `--base-url` (ex: o nome do repositório no GitHub Pages).
+- Pode especificar as versões de idioma a gerar utilizando várias vezes o parâmetro `--lang` (por exemplo, `--lang pt-PT --lang en-US`).
+- Pode especificar o prefixo do URL base do site com o parâmetro `--base-url` (por exemplo, o nome do repositório no GitHub Pages).
 - Não é necessário configurar o idioma de origem, o ZEN deteta-o automaticamente.
 
 ```bash

package/.zen/src/pt-PT/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md

@@ -0,0 +1,30 @@
+---
+'title': 'Técnicas de Utilização da Declaração de Datas na Documentação ZEN'
+'summary': 'Este documento apresenta técnicas para declarar datas diretamente no corpo do texto na ferramenta ZEN, contrastando com o método tradicional do Markdown através de YAML Frontmatter. Destaca a capacidade de reconhecimento automático e processamento inteligente do ZEN, melhorando a experiência do utilizador, e é adequado para tipos de conteúdo como diários, blogs e outros que necessitem de uma linha temporal.'
+'tags':
+  - 'ZEN'
+  - 'Declaração de Datas'
+  - 'Markdown'
+  - 'Processamento por IA'
+  - 'Linha Temporal'
+  - 'Experiência do Utilizador'
+  - 'Gestão de Documentos'
+'inferred_date': '2026-01-08'
+'inferred_lang': 'zh-Hans'
+---
+
+# Técnicas de Utilização
+
+## Declarar Datas no Corpo do Texto
+
+No corpo do texto, pode utilizar declarações de datas como "Hoje é 8 de janeiro de 2026" (o estilo do formato é livre), e o ZEN irá reconhecê-las e processá-las automaticamente.
+
+Os documentos Markdown tradicionais declaram datas através de YAML Frontmatter, o que requer a memorização dos campos correspondentes; caso contrário, a data pode não ser corretamente identificada.
+
+O ZEN suporta a declaração direta de datas no corpo do texto, evitando o problema de esquecer de preencher os campos do Frontmatter.
+
+A IA extrairá e inferirá automaticamente as informações de data presentes no corpo do texto, tratando-as como a data de criação do documento.
+
+Esta abordagem é mais flexível e inteligente, melhorando a experiência do utilizador.
+
+A propósito, documentos com datas podem gerar uma vista de linha temporal, facilitando a navegação e gestão. É especialmente adequado para tipos de conteúdo como diários, blogs e outros que necessitem de uma linha temporal.

package/.zen/src/ru-RU/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md

@@ -1,70 +1,70 @@
 ---
-title: ZEN - Минималистичный генератор статических сайтов на Markdown + AI
-summary: ZEN — это генератор статических сайтов с интеграцией AI, поддерживающий интеллектуальную навигацию по категориям и автоматический инкрементный перевод, позволяя пользователям сосредоточиться на написании на родном языке и упрощая процесс настройки и сборки.
-tags:
-  - Генератор статических сайтов
-  - Markdown
-  - Искусственный интеллект
-  - Многоязычный перевод
-  - Минимализм
-  - Инструменты для документации
-  - Node.js
-inferred_lang: ru
+'title': 'ZEN - минималистичный Markdown + AI генератор статических сайтов'
+'summary': 'ZEN — это генератор статических сайтов с функциями искусственного интеллекта, предназначенный для упрощения написания документации и процесса создания сайтов. Он позволяет пользователям сосредоточиться на написании контента на Markdown на родном языке, автоматически обрабатывая генерацию заголовков, навигацию по категориям и инкрементный перевод, поддерживает многоязычные версии без сложных настроек. Инструмент основан на Node.js и OpenAI API, позволяет быстро создавать сайты через командную строку и подходит для авторов, стремящихся к эффективности и простоте.'
+'tags':
+  - 'генератор статических сайтов'
+  - 'Markdown'
+  - 'AI'
+  - 'минимализм'
+  - 'многоязычный перевод'
+  - 'Node.js'
+  - 'OpenAI'
+'inferred_lang': 'ru-RU'
 ---
 
-# ZEN - Минималистичный генератор статических сайтов на Markdown + AI
+# ZEN - минималистичный Markdown + AI генератор статических сайтов
 
 [> Демо сайта](https://zccz14.github.io/ZEN/)
 
-## Основные возможности
+## Основные функции
 
-1.  📃 **Генерация статических сайтов**: Преобразует любую папку Git, содержащую Markdown-файлы, в статический HTML-сайт.
-2.  🧭 **Интеллектуальная навигация по категориям**: Использует AI для анализа контента, автоматически генерирует карту сайта и навигацию, независимо от расположения исходных файлов.
-3.  🌍 **Автоматический инкрементный перевод**: Использует AI для поэтапного перевода, позволяя пользователям писать Markdown на родном языке, при этом конечный сайт может быть многоязычным.
+1. 📃 **Генерация статических сайтов**: Преобразует любую папку Git, содержащую Markdown, в статический HTML-сайт.
+2. 🧭 **Интеллектуальная навигация по категориям**: Использует AI для анализа контента, создания карты сайта и навигации, не зависит от расположения исходных файлов.
+3. 🌍 **Автоматический инкрементный перевод**: Использует AI для инкрементного перевода, позволяя пользователям писать на Markdown на родном языке, но поддерживая многоязычность.
 
 Зачем ещё один генератор статических сайтов на Markdown? Я задумался о том, как инструменты для документации в эпоху AI могут лучше служить авторам:
 
-- **Возвращение к содержанию: минимум отвлечений, максимум внимания письму**
+- Возвращение к содержанию: Минимизация отвлечений, фокус на написании
 
-  Вернуть документации её суть, а письму — спокойствие.
+  Вернуть документации её суть, а написанию — спокойствие.
 
-  Во-первых, я не хочу быть библиотекарем. Иногда я хочу записать что-то, но ещё не придумал заголовок или чёткую структуру. Я хочу, чтобы LLM автоматически генерировала заголовки, делала выжимки, классифицировала, создавала навигацию и выполняла другую организационную работу.
+  Во-первых, я не хочу быть библиотекарем. Иногда я хочу записать что-то, но, возможно, ещё не придумал заголовок или не организовал это должным образом. Я хочу, чтобы LLM автоматически генерировала заголовки, делала резюме, классифицировала, создавала навигацию и другую организационную работу.
 
-  Во-вторых, мой рабочий кабинет должен быть чистым. Мне не нужны сложные инструменты сборки с запутанными конфигурациями, сложные настройки документации или громоздкие структуры. Каждый раз, когда я вижу конфигурационные файлы и структуру проектов таких инструментов, как Docusaurus, VuePress или Astro, у меня начинает болеть голова. Теперь ZEN прячет все настройки в директорию `.zen`, сметая их в угол. Пользователю нужно сосредоточиться только на содержании, а всё остальное ZEN берёт на себя. Все остальные директории — это ваше пространство для письма, где вы можете свободно организовывать свои Markdown-файлы.
+  Во-вторых, мой рабочий кабинет должен быть чистым. Мне не нужны сложные инструменты сборки с запутанными конфигурациями, сложные настройки документации или громоздкие структуры. Каждый раз, когда я вижу конфигурационные файлы и структуру проектов таких инструментов, как Docusaurus, VuePress, Astro, у меня начинает болеть голова. Теперь ZEN скрывает все настройки в каталоге `.zen`, убирая их с глаз долой. Пользователю нужно только сосредоточиться на написании контента, а всё остальное ZEN берёт на себя. Все остальные каталоги — это ваше пространство для письма, вы можете свободно организовывать свои Markdown-файлы.
 
-- **Возвращение к родному языку: пишите на родном языке, легко создавайте многоязычные версии**
+- Возвращение к родному языку: Пишите на родном языке, плавно создавайте многоязычные версии
 
-  Жизнь коротка, мне лень переводить. Человек наиболее полно раскрывает глубину своего мышления, используя родной язык. Но при этом оставаться на связи с миром необходимо, и я не хочу отказываться от многоязычного общения. Поэтому мне нужен инструмент, который позволит мне писать на родном языке и одновременно делиться контентом с большей аудиторией. Текущие решения i18n требуют не только самостоятельного перевода, но и поддержки актуальности контента, что слишком хлопотно. Я выбираю использование LLM для перевода, что экономит массу времени и позволяет одним кликом получить версии на нескольких языках.
+  Жизнь коротка, мне лень переводить. Человек наиболее полно раскрывает глубину своего мышления, когда использует родной язык. Но при этом оставаться на связи с миром необходимо, и я не хочу отказываться от многоязычного общения. Поэтому мне нужен инструмент, который позволит мне писать на родном языке, но при этом сделать мой контент доступным для большего числа людей. Текущие решения i18n требуют не только самостоятельного перевода, но и поддержки обновлений контента, что слишком хлопотно. Я выбрал использование LLM для перевода, что экономит мне много времени и позволяет выполнить перевод на несколько языков одним нажатием.
 
 ## Быстрый старт
 
-**Предварительные требования:**
+Предварительные требования:
 
-- Установлен [Node.js](https://nodejs.org/) (рекомендуется версия 18 и выше, должна быть доступна команда `npx`)
-- Получен [OpenAI API Key](https://platform.openai.com/account/api-keys) или совместимый с OPENAI API-ключ
-- Установлен Git (используется для получения списка Markdown-файлов из Git-репозитория с учётом правил `.gitignore`)
+- Установлен [Node.js](https://nodejs.org/) (рекомендуется версия 18 и выше, должна быть доступна команда npx)
+- Получен [OpenAI API Key](https://platform.openai.com/account/api-keys) или совместимый с OPENAI API Key
+- Установлен Git (для получения списка Markdown-файлов из Git, игнорируются файлы, отфильтрованные по правилам .gitignore)
 
-Сначала работайте в папке, которая уже находится под управлением Git:
+Сначала работайте в папке, которая уже управляется Git:
 
-Настройте переменные окружения:
+Настройте переменные окружения
 
 ```bash
-export OPENAI_API_KEY="sk-xxxxxx"  # Обязательно: замените на ваш OpenAI API Key
-export OPENAI_BASE_URL="https://api.openai.com/v1"  # Опционально, по умолчанию используется официальный API OpenAI
-export OPENAI_MODEL="gpt-3.5-turbo"  # Опционально, по умолчанию используется модель gpt-3.5-turbo
+export OPENAI_API_KEY="sk-xxxxxx"  # обязательно: замените на ваш OpenAI API Key
+export OPENAI_BASE_URL="https://api.openai.com/v1"  # опционально, по умолчанию используется официальный API OpenAI
+export OPENAI_MODEL="gpt-3.5-turbo"  # опционально, по умолчанию используется модель gpt-3.5-turbo
 ```
 
-Соберите сайт с поддержкой многоязычного перевода. Использует текущую директорию как исходную, результат сохраняется в директорию `.zen/dist`.
+Соберите сайт с поддержкой многоязычного перевода. Используйте текущий каталог как исходный, вывод в каталог `.zen/dist`.
 
-- Можно указать несколько языковых версий для генерации, используя параметр `--lang` несколько раз (например, `--lang ru --lang en-US`).
-- Можно указать базовый URL-префикс сайта с помощью параметра `--base-url` (например, имя репозитория на GitHub Pages).
-- Исходный язык указывать не нужно, ZEN определит его автоматически.
+- Можно указать нужные языковые версии, несколько раз используя параметр `--lang` (например, `--lang zh-Hans --lang en-US`).
+- Можно указать базовый префикс URL сайта с помощью параметра `--base-url` (например, имя репозитория на GitHub Pages).
+- Исходный язык настраивать не нужно, ZEN определит его автоматически.
 
 ```bash
-npx zengen@latest build --lang ru --lang en-US
+npx zengen@latest build --lang zh-Hans --lang en-US
 ```
 
-**Просмотреть больше параметров или справку:**
+**Посмотреть больше параметров или справку**:
 
 ```bash
 npx zengen@latest

package/.zen/src/ru-RU/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md

@@ -0,0 +1,30 @@
+---
+'title': 'Использование объявлений дат в документах ZEN'
+'summary': 'В этом документе представлены методы использования прямого объявления дат в основном тексте с помощью инструмента ZEN. В сравнении с традиционным способом объявления дат через YAML Frontmatter в Markdown, подчеркиваются функции автоматического распознавания и интеллектуальной обработки ZEN, что улучшает пользовательский опыт и подходит для типов контента, требующих временной шкалы, таких как дневники и блоги.'
+'tags':
+  - 'ZEN'
+  - 'Объявление даты'
+  - 'Markdown'
+  - 'AI обработка'
+  - 'Временная шкала'
+  - 'Пользовательский опыт'
+  - 'Управление документами'
+'inferred_date': '2026-01-08'
+'inferred_lang': 'ru-RU'
+---
+
+# Методы использования
+
+## Объявление даты в основном тексте
+
+В основном тексте можно использовать объявления даты, такие как "Сегодня 8 января 2026 года" (формат и стиль могут быть произвольными), и ZEN автоматически распознает и обработает их.
+
+Традиционные документы Markdown объявляют даты через YAML Frontmatter, что требует запоминания соответствующих полей, иначе дата может быть неправильно распознана.
+
+ZEN поддерживает прямое объявление дат в основном тексте, что позволяет избежать проблемы забывания заполнения полей Frontmatter.
+
+ИИ автоматически извлекает и определяет информацию о дате из основного текста и обрабатывает ее как дату создания документа.
+
+Этот способ более гибкий и интеллектуальный, что улучшает пользовательский опыт.
+
+Кстати, документы с датами могут генерировать представление в виде временной шкалы, что упрощает просмотр и управление. Особенно подходит для типов контента, требующих временной шкалы, таких как дневники и блоги.

package/.zen/src/sv-SE/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md

@@ -1,48 +1,48 @@
 ---
-title: ZEN - Minimalistisk Markdown + AI Static Site Builder
-summary: ZEN är en statisk site-generator som kombinerar AI, stöder intelligent kategorisering och navigering samt automatisk inkrementell översättning. Det låter användaren fokusera på att skriva på sitt modersmål och förenklar konfigurations- och byggprocessen.
-tags:
-  - Static Site Generator
-  - Markdown
-  - AI
-  - Multilingual Translation
-  - Minimalism
-  - Documentation Tools
-  - Node.js
-inferred_lang: sv-SE
+'title': 'ZEN - Minimalistisk Markdown + AI-statisk webbplatsbyggare'
+'summary': 'ZEN är en statisk webbplatsbyggare med AI-funktioner som syftar till att förenkla dokumentationsskrivande och webbplatsbyggnad. Den låter användare fokusera på att skriva Markdown-innehåll på sitt modersmål, hanterar automatiskt rubrikgenerering, kategorinavigering och inkrementell översättning, stöder flerspråkiga versioner utan krånglig konfiguration. Verktyget bygger på Node.js och OpenAI API, bygger snabbt webbplatser via kommandoraden och passar författare som söker effektivitet och enkelhet.'
+'tags':
+  - 'Statisk webbplatsbyggare'
+  - 'Markdown'
+  - 'AI'
+  - 'Minimalism'
+  - 'Flerspråkig översättning'
+  - 'Node.js'
+  - 'OpenAI'
+'inferred_lang': 'zh-Hans'
 ---
 
-# ZEN - Minimalistisk Markdown + AI Static Site Builder
+# ZEN - Minimalistisk Markdown + AI-statisk webbplatsbyggare
 
 [> Webbplatsdemo](https://zccz14.github.io/ZEN/)
 
 ## Grundläggande funktioner
 
-1.  📃 **Statisk site-generering**: Bygg en statisk HTML-webbplats från vilken git-mapp som helst som innehåller Markdown-filer.
-2.  🧭 **Intelligent kategorisering och navigering**: Använder AI för att analysera innehåll, generera webbplatskarta och navigering. Platsen för källfilerna är inte känslig.
-3.  🌍 **Automatisk inkrementell översättning**: Använder AI för inkrementell översättning. Låter användaren skriva Markdown på sitt modersmål, men webbplatsen kan vara flerspråkig.
+1. 📃 **Statisk webbplatsbyggnad**: Bygg en statisk HTML-webbplats från vilken git-mapp som helst som innehåller Markdown-filer.
+2. 🧭 **Intelligent kategorinavigering**: Använder AI för innehållsanalys, genererar webbplatsskarta och navigering, oberoende av källfilernas placering.
+3. 🌍 **Automatisk inkrementell översättning**: Använder AI för inkrementell översättning, låter användare skriva Markdown på sitt modersmål, men webbplatsen kan vara flerspråkig.
 
-Varför skapa ännu en Markdown-baserad statisk site-generator? Jag har tänkt på hur dokumentationsverktyg i AI-eran bättre kan tjäna författare:
+Varför ännu en Markdown-statisk webbplatsbyggare? Jag har tänkt på hur dokumentationsverktyg i AI-eran bättre kan tjäna författare:
 
-- **Återgå till innehållet**: Minimera störningar, fokusera på skrivandet
+- Återgå till innehållet: Minimera störningar, fokusera på skrivandet
 
-  Låt dokumentationen återgå till sin kärna, låt skrivandet återgå till lugn och ro.
+  Låt dokumentationen återgå till sin kärna, låt skrivandet återgå till lugn.
 
-  För det första vill jag inte vara bibliotekarie. Ibland vill jag skriva ner något, men jag kanske inte har bestämt mig för en titel eller organiserat det särskilt väl. Jag vill att LLM automatiskt ska hjälpa mig med att generera titlar, göra sammanfattningar, kategorisera, skapa navigering och annat organiseringsarbete.
+  För det första vill jag inte vara bibliotekarie. Ibland vill jag skriva ner något, men jag kanske inte har bestämt mig för en rubrik eller organiserat det särskilt. Jag vill att LLM automatiskt ska generera rubriker, göra sammanfattningar, kategorisera, navigera och organisera.
 
-  För det andra måste mitt skrivrum vara rent och snyggt. Jag vill inte ha komplexa byggverktyg med krånglig konfiguration, krångla med komplicerade dokumentstrukturer. Varje gång jag ser konfigurationsfiler och projektstrukturer för verktyg som Docusaurus, VuePress eller Astro får jag huvudvärk. Nu väljer ZEN att gömma all konfiguration i mappen `.zen`, sopa undan den i ett hörn. Användaren behöver bara fokusera på att skriva innehåll, resten hanterar ZEN. Alla andra mappar är ditt skrivutrymme, du kan organisera dina Markdown-filer hur du vill.
+  För det andra måste mitt skrivbord vara rent. Jag vill inte ha krångliga byggverktyg, krångla med komplex dokumentationskonfiguration eller gilla komplicerade strukturer. Varje gång jag ser konfigurationsfiler och projektstrukturer för verktyg som Docusaurus, VuePress eller Astro får jag huvudvärk. Nu väljer ZEN att gömma all konfiguration i mappen `.zen`, sopa undan den i ett hörn, så att användaren bara behöver fokusera på att skriva innehåll, resten hanterar ZEN. Alla andra mappar är ditt skrivutrymme, du kan organisera dina Markdown-filer hur du vill.
 
-- **Återgå till modersmålet**: Skriv på ditt modersmål, bygg sömlöst flerspråkiga versioner
+- Återgå till modersmålet: Skriv på ditt modersmål, bygg smidigt flerspråkiga versioner
 
-  Livet är för kort för att jag ska orka översätta. Man uttrycker sina tankar på djupast sätt när man använder sitt modersmål. Men att hålla kontakten med världen är också nödvändigt, jag vill inte avstå från flerspråkig kommunikation. Därför önskar jag ett verktyg som låter mig skriva på mitt modersmål, samtidigt som det gör mitt innehåll tillgängligt för fler. Nuvarande i18n-lösningar kräver inte bara att man översätter själv, utan också att man underhåller uppdateringar av innehållet – för besvärligt. Jag väljer att använda LLM för att hjälpa mig med översättningar, det sparar mycket tid och flera språkversioner kan skapas med ett enda kommando.
+  Livet är kort, jag orkar inte översätta. Människor uttrycker sina djupaste tankar bäst på sitt modersmål. Men att hålla kontakten med världen är också nödvändigt, jag vill inte avstå från flerspråkig kommunikation. Därför vill jag ha ett verktyg som låter mig skriva på mitt modersmål, samtidigt som fler kan se mitt innehåll. Nuvarande i18n kräver inte bara egen översättning utan också eget underhåll av innehållsuppdateringar, för besvärligt. Jag väljer att använda LLM för att hjälpa mig med översättning, sparar mycket tid och kan slutföra flerspråkig översättning med ett knapptryck.
 
 ## Snabbstart
 
 Förutsättningar:
 
-- [Node.js](https://nodejs.org/) installerat (rekommenderad version 18 eller högre, kommandot `npx` måste finnas)
+- [Node.js](https://nodejs.org/) installerad (rekommenderad version 18 eller senare, måste ha npx-kommandot)
 - Har fått en [OpenAI API-nyckel](https://platform.openai.com/account/api-keys), eller en OPENAI-kompatibel API-nyckel
-- Git installerat (används för att lista Markdown-filer från ett git-arkiv, ignorerar filer som filtreras bort av `.gitignore`-regler)
+- Git installerat (används för att lista Markdown-filer från Git, ignorerar filer filtrerade av .gitignore-regler)
 
 Först, arbeta i en mapp som redan hanteras av git:
 
@@ -54,17 +54,17 @@ export OPENAI_BASE_URL="https://api.openai.com/v1"  # Valfritt, använder OpenAI
 export OPENAI_MODEL="gpt-3.5-turbo"  # Valfritt, använder gpt-3.5-turbo-modellen som standard
 ```
 
-Bygg webbplatsen, stöder flerspråkig översättning. Använder aktuell katalog som källkatalog, skriver ut till katalogen `.zen/dist`.
+Bygg webbplatsen, stöder flerspråkig översättning. Använd aktuell katalog som källkatalog, skicka ut till `.zen/dist`-mappen.
 
-- Du kan ange vilka språkversioner som ska genereras genom att använda parametern `--lang` flera gånger (t.ex. `--lang zh-Hans --lang en-US`).
-- Du kan ange webbplatsens bas-URL-prefix med parametern `--base-url` (t.ex. namnet på ditt GitHub Pages-repo).
-- Ingen konfiguration av källspråk behövs, ZEN upptäcker det automatiskt.
+- Du kan ange språkversioner som behöver genereras genom att använda parametern `--lang` flera gånger (t.ex. `--lang zh-Hans --lang en-US`).
+- Du kan ange webbplatsens bas-URL-prefix med parametern `--base-url` (t.ex. lagringsplatsnamn på GitHub Pages).
+- Ingen konfiguration av källspråk behövs, ZEN upptäcker automatiskt.
 
 ```bash
 npx zengen@latest build --lang zh-Hans --lang en-US
 ```
 
-**Visa fler parametrar eller hjälp**:
+**Se fler parametrar eller hjälp**:
 
 ```bash
 npx zengen@latest

package/.zen/src/sv-SE/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md

@@ -0,0 +1,30 @@
+---
+'title': 'ZEN-dokumentdatumdeklaration användningstips'
+'summary': 'Detta dokument introducerar användningstips för direkt datumdeklaration i brödtexten i ZEN-verktyget, jämfört med traditionellt Markdowns sätt att deklarera datum via YAML Frontmatter. Det betonar ZEN:s automatiska igenkänning och intelligenta bearbetningsfunktioner, vilket förbättrar användarupplevelsen och är lämpligt för innehållstyper som dagbok, blogg och andra som kräver tidslinjer.'
+'tags':
+  - 'ZEN'
+  - 'Datumdeklaration'
+  - 'Markdown'
+  - 'AI-bearbetning'
+  - 'Tidslinje'
+  - 'Användarupplevelse'
+  - 'Dokumenthantering'
+'inferred_date': '2026-01-08'
+'inferred_lang': 'sv-SE'
+---
+
+# Användningstips
+
+## Deklarera datum i brödtexten
+
+I brödtexten kan du använda datumdeklarationer som "Idag är den 8 januari 2026" (formatstil är fri), ZEN kommer automatiskt att känna igen och bearbeta detta.
+
+Traditionella Markdown-dokument deklarerar datum via YAML Frontmatter, vilket kräver att man kommer ihåg motsvarande fält, annars kan datumet inte identifieras korrekt.
+
+ZEN stöder direkt datumdeklaration i brödtexten, vilket undviker problemet med att glömma att fylla i Frontmatter-fält.
+
+AI kommer automatiskt att extrahera och härleda datuminformation från brödtexten och behandla den som dokumentets skapandedatum.
+
+Detta sätt är mer flexibelt och intelligent, vilket förbättrar användarupplevelsen.
+
+För övrigt kan dokument med datum generera tidslinjevyer, vilket underlättar bläddring och hantering. Särskilt lämpligt för innehållstyper som dagbok, blogg och andra som kräver tidslinjer.