czon 0.1.0 → 0.1.1

package/.zen/src/pt-PT/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md

@@ -0,0 +1,70 @@
+---
+'title': 'ZEN - Construtor de Sites Estáticos Minimalista com Markdown + IA'
+'summary': 'O ZEN é um gerador de sites estáticos com IA, focado em simplificar a escrita e construção de documentação. Permite aos utilizadores criar sites HTML estáticos em pastas geridas por git usando Markdown, sem configuração complexa, com todas as definições ocultas no diretório .zen. As funcionalidades principais incluem navegação inteligente por categorias (geração de mapa do site através de análise de conteúdo por IA), tradução automática incremental (suporte a versões multilingues, permitindo escrita na língua materna com tradução processada por IA) e uma experiência de escrita com distrações minimizadas. A ferramenta depende do Node.js, de uma chave da API OpenAI e do Git, construindo rapidamente através da linha de comandos e suportando parâmetros de idioma como zh-Hans e en-US.'
+'tags':
+  - 'Gerador de Sites Estáticos'
+  - 'Markdown'
+  - 'IA'
+  - 'Tradução Multilingue'
+  - 'Minimalismo'
+  - 'Ferramenta de Documentação'
+  - 'ZEN'
+'inferred_lang': 'zh-Hans'
+---
+
+# ZEN - Construtor de Sites Estáticos Minimalista com Markdown + IA
+
+[> Demonstração do Website](https://zen.zccz14.com/)
+
+## Funcionalidades Básicas
+
+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, sem depender da localização dos ficheiros de origem.
+3. 🌍 **Tradução Automática Incremental**: Utiliza IA para tradução incremental, permitindo que os utilizadores escrevam 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
+
+  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 organização. Desejo que a LLM me ajude automaticamente a gerar títulos, resumos, categorias, navegação e outras tarefas de organização.
+
+  Segundo, o meu espaço de trabalho deve estar arrumado. Não quero ferramentas de construção com configuração complexa, 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 ocultar toda a configuração no diretório .zen, escondendo-a num canto, para que o utilizador se concentre apenas no conteúdo da escrita, deixando o resto para o ZEN tratar. 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
+
+  A vida é curta, não tenho paciência para traduzir. É na língua materna que conseguimos explorar melhor a profundidade do nosso pensamento. Mas manter a ligação com o mundo é essencial, e 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 a LLM para me ajudar com as traduções, poupando 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 (recomenda-se versão 18 ou superior, com comando npx disponível)
+- Obter uma [Chave da API 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 do Git, ignorando ficheiros filtrados pelas regras .gitignore)
+
+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 da API OpenAI
+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, com suporte a tradução multilingue. Utiliza o diretório atual como origem e gera a saída para o diretório `.zen/dist`.
+
+- Pode especificar as versões de idioma a gerar usando várias vezes o parâmetro `--lang` (por exemplo, `--lang zh-Hans --lang en-US`).
+- Não é necessário configurar o idioma de origem, o ZEN deteta-o automaticamente.
+
+```bash
+npx zengen@latest build --lang zh-Hans --lang en-US
+```
+
+**Ver mais parâmetros ou ajuda**:
+
+```bash
+npx zengen@latest
+```

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

@@ -0,0 +1,71 @@
+---
+'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
+
+[> Demonstração do Website](https://zccz14.github.io/ZEN/)
+
+## Funcionalidades Básicas
+
+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
+
+  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 gere automaticamente títulos, resumos, categorias, navegação e outras tarefas de organização.
+
+  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, construindo versões multilingues de forma fluida
+
+  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 (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)
+
+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, 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, 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 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
+npx zengen@latest build --lang pt-PT --lang en-US
+```
+
+**Ver mais parâmetros ou ajuda**:
+
+```bash
+npx zengen@latest
+```

package/.zen/src/pt-PT/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md

@@ -0,0 +1,71 @@
+---
+'title': 'ZEN - Construtor de Sites Estáticos Minimalista com Markdown + IA'
+'summary': 'O ZEN é um gerador de sites estáticos com funcionalidades de IA, projetado especificamente para documentos Markdown. Permite aos utilizadores converter uma pasta Git contendo ficheiros Markdown num site HTML estático, sem configuração complexa, com todas as definições ocultas no diretório .zen. As funcionalidades principais incluem navegação por categorização inteligente (usando IA para analisar conteúdo e gerar um mapa do site), tradução automática incremental (suporta versões multilingues, os utilizadores podem escrever na sua língua materna e a IA processa a tradução) e uma experiência de escrita com perturbações mínimas. O guia de início rápido requer a instalação do Node.js, obtenção de uma chave de API OpenAI e Git, construção do site através da linha de comandos, com suporte para especificar idioma e URL base.'
+'tags':
+  - 'Gerador de Sites Estáticos'
+  - 'Markdown'
+  - 'IA'
+  - 'Tradução Multilingue'
+  - 'Minimalismo'
+  - 'Ferramenta de Documentação'
+  - 'Git'
+'inferred_lang': 'zh-Hans'
+---
+
+# ZEN - Construtor de Sites Estáticos Minimalista com Markdown + IA
+
+[> Demonstração do Website](https://zen.zccz14.com/)
+
+## Funcionalidades Básicas
+
+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 por Categorização Inteligente**: 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 Markdown na sua língua materna, mas o conteúdo final pode ser multilingue.
+
+Porque é que criei mais um gerador de sites estáticos para Markdown? Refliti sobre como as ferramentas de documentação podem servir melhor os escritores na era da IA:
+
+- **Regresso ao Conteúdo: Perturbação mínima, foco na 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 posso ainda não ter pensado no título ou numa organização específica. Desejo que um LLM me ajude automaticamente a gerar títulos, fazer resumos, categorizar, navegar e outras tarefas de organização.
+
+  Segundo, o meu escritório tem de estar arrumado. Não quero ferramentas de construção com configuração complexa, nem complicar-me com configurações de documentos ou estruturas intrincadas. Sempre que vejo os ficheiros de configuração e estruturas de projeto de ferramentas como Docusaurus, VuePress ou Astro, fico com dor de cabeça. Agora, o ZEN opta por ocultar toda a configuração no diretório `.zen`, varrendo-a para um canto. O utilizador só precisa de se concentrar em escrever o conteúdo, 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.
+
+- **Regresso à Língua Materna: Escrever na língua materna, construir versões multilingues de forma fluida**
+
+  A vida é curta, não tenho paciência para traduzir. É na nossa língua materna que conseguimos explorar melhor a profundidade do nosso pensamento. No entanto, manter uma ligação com o mundo é necessário, e não quero abdicar da comunicação multilingue. Por isso, desejei uma ferramenta que me permitisse 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 nós próprios e que mantenhamos as atualizações de conteúdo, o que é demasiado trabalhoso. Optei por usar um LLM para me ajudar com as traduções, poupando-me muito tempo e permitindo concluir traduções para vários idiomas com um único comando.
+
+## Início Rápido
+
+Pré-requisitos:
+
+- Ter o [Node.js](https://nodejs.org/) instalado (recomenda-se versão 18 ou superior, necessita do comando `npx`)
+- Ter obtido uma [Chave de API 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`)
+
+Primeiro, trabalhe numa pasta que já esteja a ser gerida pelo Git:
+
+Configure as variáveis de ambiente
+
+```bash
+export OPENAI_API_KEY="sk-xxxxxx"  # Obrigatório: Substitua pela sua Chave de API OpenAI
+export OPENAI_BASE_URL="https://api.openai.com/v1"  # Opcional, por predefinição usa a API oficial da OpenAI
+export OPENAI_MODEL="gpt-3.5-turbo"  # Opcional, por predefinição usa o modelo gpt-3.5-turbo
+```
+
+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 várias vezes o parâmetro `--lang` (por exemplo, `--lang zh-Hans --lang en-US`).
+- Pode especificar o prefixo do URL base do site usando 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
+npx zengen@latest build --lang zh-Hans --lang en-US
+```
+
+**Para ver mais parâmetros ou obter ajuda**:
+
+```bash
+npx zengen@latest
+```

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/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md

@@ -0,0 +1,121 @@
+---
+'title': 'Тестовый документ с диаграммами Mermaid'
+'summary': 'Этот документ является тестовым файлом для проверки функциональности рендеринга диаграмм Mermaid в ZEN. Он содержит примеры различных типов диаграмм Mermaid, таких как блок-схемы, диаграммы последовательностей, диаграммы Ганта, диаграммы классов, диаграммы состояний и круговые диаграммы, а также включает тест с ошибочным синтаксисом для проверки отображения сообщений об ошибках. Документ предназначен для демонстрации корректной работы интеграции Mermaid в ZEN.'
+'tags':
+  - 'Mermaid'
+  - 'Тестирование диаграмм'
+  - 'ZEN'
+  - 'Блок-схемы'
+  - 'Диаграммы последовательностей'
+  - 'Диаграммы Ганта'
+  - 'Диаграммы классов'
+  - 'Диаграммы состояний'
+'inferred_date': '2024-01-01'
+'inferred_lang': 'ru-RU'
+---
+
+# Тестирование диаграмм Mermaid
+
+Это тестовый файл для проверки функциональности рендеринга диаграмм Mermaid в ZEN.
+
+## Пример блок-схемы
+
+```mermaid
+graph TD
+    A[Начало] --> B{Продолжить?}
+    B -->|Да| C[Выполнить действие]
+    B -->|Нет| D[Конец]
+    C --> E[Проверить результат]
+    E --> F{Успешно?}
+    F -->|Да| G[Завершено]
+    F -->|Нет| H[Повторить]
+    H --> C
+    G --> D
+```
+
+## Пример диаграммы последовательностей
+
+```mermaid
+sequenceDiagram
+    participant Пользователь
+    participant Система
+    participant БазаДанных
+
+    Пользователь->>Система: Отправить запрос
+    Система->>БазаДанных: Запросить данные
+    БазаДанных-->>Система: Вернуть результат
+    Система-->>Пользователь: Показать результат
+```
+
+## Пример диаграммы Ганта
+
+```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
+```
+
+## Пример диаграммы классов
+
+```mermaid
+classDiagram
+    class Animal {
+        +String name
+        +int age
+        +void eat()
+        +void sleep()
+    }
+    class Dog {
+        +void bark()
+    }
+    class Cat {
+        +void meow()
+    }
+
+    Animal <|-- Dog
+    Animal <|-- Cat
+```
+
+## Пример диаграммы состояний
+
+```mermaid
+stateDiagram-v2
+    [*] --> Ожидание
+    Ожидание --> Обработка : Начать обработку
+    Обработка --> Успех : Обработка успешна
+    Обработка --> Ошибка : Обработка не удалась
+    Успех --> [*]
+    Ошибка --> [*]
+```
+
+## Пример круговой диаграммы
+
+```mermaid
+pie title Доля использования браузеров
+    "Chrome" : 65.2
+    "Firefox" : 15.3
+    "Safari" : 12.5
+    "Edge" : 5.2
+    "Другие" : 1.8
+```
+
+## Тест ошибочного синтаксиса (должно отображать сообщение об ошибке)
+
+```mermaid
+graph TD
+    A --> B
+    // Здесь отсутствует определение стрелки
+    C --> D
+```
+
+Этот тестовый файл содержит различные типы диаграмм Mermaid для проверки корректной работы интеграции Mermaid в ZEN.

package/.zen/src/ru-RU/579c3a203225b8b7aead541f42381de0619d8bc1d451d0d9c3267dbc74205503.md

@@ -0,0 +1,78 @@
+---
+'title': 'Тестирование отображения формул KaTeX'
+'summary': 'Этот документ представляет собой пример для тестирования отображения формул KaTeX, содержащий несколько встроенных и блочных математических формул, таких как E=mc^2, интегралы, производные, ряды, кусочные функции, таблицы, матрицы и т.д., с целью проверки корректного рендеринга формул.'
+'tags':
+  - 'KaTeX'
+  - 'тестирование формул'
+  - 'математические формулы'
+  - 'LaTeX'
+  - 'отображение'
+  - 'пример документа'
+'inferred_lang': 'ru-RU'
+---
+
+# Тестирование отображения формул KaTeX
+
+Это тест встроенной формулы: $ E = mc^2 $.
+
+Это тест блочной формулы:
+
+$$
+\int_a^b f(x) \, dx = F(b) - F(a)
+$$
+
+Это ещё один тест блочной формулы:
+
+$$
+\frac{d}{dx}e^x = e^x
+$$
+
+Это тест сложной формулы:
+
+$$
+\sum_{n=1}^{\infty} \frac{1}{n^2} = \frac{\pi^2}{6}
+$$
+
+Тест формулы с конструкцией cases:
+
+$$
+f(x) =
+\begin{cases}
+x^2 & \text{if } x \geq 0 \\
+-x & \text{if } x < 0
+\end{cases}
+$$
+
+Формула с таблицей:
+
+$$
+\begin{array}{c|c|c}
+a & b & c \\
+\hline
+1 & 2 & 3 \\
+4 & 5 & 6 \\
+\end{array}
+$$
+
+Формула с матрицей:
+
+$$
+\begin{pmatrix}
+1 & 2 \\
+3 & 4
+\end{pmatrix}
+$$
+
+Тест формулы с текстом:
+
+$$
+E = mc^2 \quad \text{где } m \text{ — масса, а } c \text{ — скорость света}
+$$
+
+Обобщённая формула Келли:
+
+$$
+f^* = \argmax_f \sum_{i \in X} P_i \ln (1 + f \cdot R_i)
+$$
+
+Пожалуйста, убедитесь, что все вышеприведённые формулы отображаются корректно.

package/.zen/src/ru-RU/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md

@@ -0,0 +1,70 @@
+---
+'title': 'ZEN - минималистичный Markdown + AI генератор статических сайтов'
+'summary': 'ZEN — это генератор статических сайтов с интеграцией AI, ориентированный на упрощение написания документации и процесса сборки. Он позволяет пользователям создавать статические HTML-сайты в папках под управлением git с использованием Markdown, без сложных конфигураций — все настройки скрыты в каталоге .zen. Ключевые функции включают интеллектуальную навигацию по категориям (генерация карты сайта через анализ контента с помощью AI), автоматический инкрементный перевод (поддержка многоязычных версий, пользователи могут писать на родном языке, а AI обрабатывает перевод) и минималистичный опыт написания. Инструмент зависит от Node.js, ключа OpenAI API и Git, быстро собирается через командную строку и поддерживает указание языковых параметров, таких как zh-Hans и en-US.'
+'tags':
+  - 'генератор статических сайтов'
+  - 'Markdown'
+  - 'AI'
+  - 'многоязычный перевод'
+  - 'минимализм'
+  - 'инструмент для документации'
+  - 'ZEN'
+'inferred_lang': 'zh-Hans'
+---
+
+# ZEN - минималистичный Markdown + AI генератор статических сайтов
+
+[> Демо сайта](https://zen.zccz14.com/)
+
+## Основные функции
+
+1. 📃 **Генерация статических сайтов**: Преобразует любую папку с Markdown-файлами под управлением git в статический HTML-сайт.
+2. 🧭 **Интеллектуальная навигация по категориям**: Использует AI для анализа контента, генерации карты сайта и навигации, независимо от расположения исходных файлов.
+3. 🌍 **Автоматический инкрементный перевод**: Использует AI для инкрементного перевода, позволяя пользователям писать Markdown на родном языке, но при этом поддерживать многоязычность.
+
+Зачем ещё один генератор статических сайтов на Markdown? Я переосмыслил, как инструменты для документации могут лучше служить авторам в эпоху AI:
+
+- Возвращение к содержанию: Минимизация отвлечений, фокус на написании
+
+  Вернуть документации её суть, а написанию — спокойствие.
+
+  Во-первых, я не хочу быть библиотекарем. Иногда я хочу записать что-то, но ещё не придумал заголовок или не организовал это должным образом. Я хочу, чтобы LLM автоматически генерировала заголовки, делала выжимки, классифицировала и организовывала навигацию.
+
+  Во-вторых, мой рабочий кабинет должен быть чистым. Мне не нужны сложные инструменты сборки с запутанными конфигурациями, сложные структуры документов. Каждый раз, когда я вижу конфигурационные файлы и структуры проектов таких инструментов, как Docusaurus, VuePress, Astro, у меня начинает болеть голова. Теперь ZEN прячет все настройки в каталог .zen, сметая их в угол, чтобы пользователь мог сосредоточиться на содержании, а всё остальное ZEN берёт на себя. Все остальные каталоги — ваше пространство для письма, вы можете свободно организовывать свои Markdown-файлы.
+
+- Возвращение к родному языку: Пишите на родном языке, плавно создавайте многоязычные версии
+
+  Жизнь коротка, мне лень переводить. Человек наиболее полно раскрывает глубину своего мышления, когда использует родной язык. Но при этом оставаться на связи с миром необходимо, и я не хочу отказываться от многоязычного общения. Поэтому мне нужен инструмент, который позволит мне писать на родном языке, но при этом сделать мой контент доступным для большего числа людей. Текущие решения 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)
+
+Сначала работайте в папке, которая уже находится под управлением 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
+```
+
+Соберите сайт с поддержкой многоязычного перевода. Использует текущий каталог как исходный, вывод в каталог `.zen/dist`.
+
+- Можно несколько раз использовать параметр `--lang` для указания нужных языковых версий (например, `--lang zh-Hans --lang en-US`).
+- Исходный язык указывать не нужно, ZEN определит его автоматически.
+
+```bash
+npx zengen@latest build --lang zh-Hans --lang en-US
+```
+
+**Просмотреть больше параметров или справку**:
+
+```bash
+npx zengen@latest
+```

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

@@ -0,0 +1,71 @@
+---
+'title': 'ZEN - минималистичный Markdown + AI генератор статических сайтов'
+'summary': 'ZEN — это генератор статических сайтов с функциями искусственного интеллекта, предназначенный для упрощения написания документации и процесса создания сайтов. Он позволяет пользователям сосредоточиться на написании контента на Markdown на родном языке, автоматически обрабатывая генерацию заголовков, навигацию по категориям и инкрементный перевод, поддерживает многоязычные версии без сложных настроек. Инструмент основан на Node.js и OpenAI API, позволяет быстро создавать сайты через командную строку и подходит для авторов, стремящихся к эффективности и простоте.'
+'tags':
+  - 'генератор статических сайтов'
+  - 'Markdown'
+  - 'AI'
+  - 'минимализм'
+  - 'многоязычный перевод'
+  - 'Node.js'
+  - 'OpenAI'
+'inferred_lang': 'ru-RU'
+---
+
+# ZEN - минималистичный Markdown + AI генератор статических сайтов
+
+[> Демо сайта](https://zccz14.github.io/ZEN/)
+
+## Основные функции
+
+1. 📃 **Генерация статических сайтов**: Преобразует любую папку Git, содержащую Markdown, в статический HTML-сайт.
+2. 🧭 **Интеллектуальная навигация по категориям**: Использует AI для анализа контента, создания карты сайта и навигации, не зависит от расположения исходных файлов.
+3. 🌍 **Автоматический инкрементный перевод**: Использует AI для инкрементного перевода, позволяя пользователям писать на Markdown на родном языке, но поддерживая многоязычность.
+
+Зачем ещё один генератор статических сайтов на Markdown? Я задумался о том, как инструменты для документации в эпоху AI могут лучше служить авторам:
+
+- Возвращение к содержанию: Минимизация отвлечений, фокус на написании
+
+  Вернуть документации её суть, а написанию — спокойствие.
+
+  Во-первых, я не хочу быть библиотекарем. Иногда я хочу записать что-то, но, возможно, ещё не придумал заголовок или не организовал это должным образом. Я хочу, чтобы LLM автоматически генерировала заголовки, делала резюме, классифицировала, создавала навигацию и другую организационную работу.
+
+  Во-вторых, мой рабочий кабинет должен быть чистым. Мне не нужны сложные инструменты сборки с запутанными конфигурациями, сложные настройки документации или громоздкие структуры. Каждый раз, когда я вижу конфигурационные файлы и структуру проектов таких инструментов, как Docusaurus, VuePress, Astro, у меня начинает болеть голова. Теперь ZEN скрывает все настройки в каталоге `.zen`, убирая их с глаз долой. Пользователю нужно только сосредоточиться на написании контента, а всё остальное ZEN берёт на себя. Все остальные каталоги — это ваше пространство для письма, вы можете свободно организовывать свои Markdown-файлы.
+
+- Возвращение к родному языку: Пишите на родном языке, плавно создавайте многоязычные версии
+
+  Жизнь коротка, мне лень переводить. Человек наиболее полно раскрывает глубину своего мышления, когда использует родной язык. Но при этом оставаться на связи с миром необходимо, и я не хочу отказываться от многоязычного общения. Поэтому мне нужен инструмент, который позволит мне писать на родном языке, но при этом сделать мой контент доступным для большего числа людей. Текущие решения i18n требуют не только самостоятельного перевода, но и поддержки обновлений контента, что слишком хлопотно. Я выбрал использование LLM для перевода, что экономит мне много времени и позволяет выполнить перевод на несколько языков одним нажатием.
+
+## Быстрый старт
+
+Предварительные требования:
+
+- Установлен [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:
+
+Настройте переменные окружения
+
+```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
+```
+
+Соберите сайт с поддержкой многоязычного перевода. Используйте текущий каталог как исходный, вывод в каталог `.zen/dist`.
+
+- Можно указать нужные языковые версии, несколько раз используя параметр `--lang` (например, `--lang zh-Hans --lang en-US`).
+- Можно указать базовый префикс URL сайта с помощью параметра `--base-url` (например, имя репозитория на GitHub Pages).
+- Исходный язык настраивать не нужно, ZEN определит его автоматически.
+
+```bash
+npx zengen@latest build --lang zh-Hans --lang en-US
+```
+
+**Посмотреть больше параметров или справку**:
+
+```bash
+npx zengen@latest
+```