zengen 0.3.0 → 0.3.1

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

@@ -0,0 +1,70 @@
+---
+'title': 'ZEN - Construtor de Site Estático Minimalista Markdown + IA'
+'summary': 'ZEN é um gerador de sites estáticos com integração de IA, focado em simplificar a escrita e construção de documentação. Permite que usuários criem sites HTML estáticos a partir de pastas gerenciadas por git usando Markdown, sem configuração complexa - todas as configurações ficam ocultas no diretório .zen. Funcionalidades principais incluem navegação inteligente por categorias (geração de mapa do site via análise de conteúdo por IA), tradução incremental automática (suporte a versões multilíngues, permitindo escrita no idioma nativo com tradução processada por IA) e experiência de escrita com distrações minimizadas. A ferramenta depende de Node.js, chave da API OpenAI e Git, com construção rápida via linha de comando, suportando parâmetros de idioma como zh-Hans e en-US.'
+'tags':
+  - 'Gerador de Sites Estáticos'
+  - 'Markdown'
+  - 'IA'
+  - 'Tradução Multilíngue'
+  - 'Minimalismo'
+  - 'Ferramenta de Documentação'
+  - 'ZEN'
+'inferred_lang': 'zh-Hans'
+---
+
+# ZEN - Construtor de Site Estático Minimalista Markdown + IA
+
+[> Demonstração do Site](https://zen.zccz14.com/)
+
+## Funcionalidades Básicas
+
+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 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 usuários escrevam Markdown em seu idioma nativo, mas com suporte multilíngue.
+
+Por que criar mais um gerador de sites estáticos com Markdown? Reflito sobre como ferramentas de documentação podem servir melhor aos escritores na era da IA:
+
+- Retorno ao conteúdo: Distrações minimizadas, foco na escrita
+
+  Devolver a documentação à sua essência, devolver a tranquilidade à escrita.
+
+  Primeiro, não quero ser um bibliotecário. Às vezes quero anotar algum conteúdo, mas talvez ainda não tenha pensado em um título, nem organizado adequadamente. Desejo que o 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 ferramentas de construção com configuração complexa, nem me preocupar com estruturas complicadas. Sempre que vejo os arquivos de configuração e estruturas 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, para que o usuário foque apenas no conteúdo da escrita, deixando o resto para o ZEN cuidar. Os outros diretórios são seu espaço de escrita, você pode organizar seus arquivos Markdown livremente.
+
+- Retorno ao idioma nativo: Escreva em sua língua materna, construa versões multilíngues suavemente
+
+  A vida é curta, não tenho paciência para traduzir. As pessoas atingem sua máxima profundidade de pensamento quando usam seu idioma nativo. Mas manter conexão com o mundo também é necessário, não quero abrir mão da comunicação multilíngue. Por isso, desejo uma ferramenta que me permita escrever em meu idioma nativo, enquanto permite que mais pessoas vejam meu conteúdo. Atualmente, o i18n exige que você mesmo faça a tradução e mantenha as atualizações de conteúdo, o que é muito trabalhoso. Escolhi usar LLM para fazer a tradução por mim, economizando muito tempo e permitindo a tradução para múltiplos idiomas com um clique.
+
+## Início Rápido
+
+Pré-requisitos:
+
+- [Node.js](https://nodejs.org/) instalado (versão 18 ou superior recomendada, necessário comando npx)
+- Chave da [API OpenAI](https://platform.openai.com/account/api-keys) obtida, ou chave de API compatível com OpenAI
+- Git instalado (para listar arquivos Markdown do Git, ignorando arquivos filtrados pelas regras .gitignore)
+
+Primeiro, trabalhe em uma pasta já gerenciada 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, 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, saída no diretório `.zen/dist`.
+
+- É possível especificar versões de idioma usando múltiplas vezes o parâmetro `--lang` (exemplo: `--lang zh-Hans --lang en-US`).
+- Não é necessário configurar o idioma fonte, o ZEN detecta automaticamente.
+
+```bash
+npx zengen@latest build --lang zh-Hans --lang en-US
+```
+
+**Veja mais parâmetros ou ajuda**:
+
+```bash
+npx zengen@latest
+```

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

@@ -0,0 +1,71 @@
+---
+'title': 'ZEN - Construtor de Site Estático Minimalista com Markdown + IA'
+'summary': 'ZEN é um gerador de sites estáticos com funcionalidades de IA, projetado especificamente para documentos Markdown. Ele permite que os usuários convertam uma pasta Git contendo arquivos Markdown em um site HTML estático, sem configurações complexas — todas as configurações ficam ocultas no diretório .zen. As funcionalidades principais incluem navegação por categorização inteligente (usando IA para analisar o conteúdo e gerar um mapa do site), tradução incremental automática (suporte a versões multilíngues, permitindo que os usuários escrevam em sua língua nativa enquanto a IA cuida da tradução) e uma experiência de escrita com distrações mínimas. O guia de início rápido requer a instalação do Node.js, obtenção de uma chave de API da OpenAI e Git, construção do site via linha de comando, com suporte para especificação de idioma e URL base.'
+'tags':
+  - 'Gerador de Site Estático'
+  - 'Markdown'
+  - 'IA'
+  - 'Tradução Multilíngue'
+  - 'Minimalismo'
+  - 'Ferramenta de Documentação'
+  - 'Git'
+'inferred_lang': 'pt-BR'
+---
+
+# ZEN - Construtor de Site Estático Minimalista com Markdown + IA
+
+[> Demonstração do Site](https://zen.zccz14.com/)
+
+## Funcionalidades Básicas
+
+1.  📃 **Geração de Site Estático**: Transforma qualquer pasta git contendo Markdown em um site HTML estático.
+2.  🧭 **Navegação por Categorização Inteligente**: Usa IA para analisar o conteúdo, gerando um mapa do site e navegação, independente da localização dos arquivos fonte.
+3.  🌍 **Tradução Incremental Automática**: Usa IA para realizar traduções incrementais, permitindo que o usuário escreva Markdown em sua língua nativa, mas o conteúdo final pode ser multilíngue.
+
+Por que criar mais um gerador de site estático para Markdown? Reflito sobre como as ferramentas de documentação podem servir melhor aos escritores na era da IA:
+
+- **Retorno ao Conteúdo: Distrações Mínimas, Foco na Escrita**
+
+  Traga a documentação de volta à sua essência e a escrita de volta à tranquilidade.
+
+  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 organizado as ideias. Quero que um LLM (Large Language Model) gere automaticamente títulos, resumos, categorias, navegação e outras tarefas de organização.
+
+  Segundo, meu espaço de trabalho precisa estar arrumado. Não quero ferramentas de construção com configurações complexas, me preocupar com configurações intrincadas de documentos ou 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 opta por esconder todas as configurações no diretório `.zen`, varrendo-as para um canto. O usuário só precisa focar no conteúdo da escrita; o resto fica por conta do ZEN. Todos 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 nativa, construa versões multilíngues sem esforço**
+
+  A vida é curta, não tenho paciência para traduzir. As pessoas atingem sua máxima profundidade de pensamento ao usar sua língua materna. No entanto, manter-se conectado ao mundo é necessário, e não quero abrir mão da comunicação multilíngue. Por isso, desejo uma ferramenta que me permita escrever em minha língua nativa e, ao mesmo tempo, tornar meu conteúdo acessível a mais pessoas. Atualmente, a internacionalização (i18n) exige que você mesmo faça a tradução e mantenha as atualizações de conteúdo, o que é muito trabalhoso. Escolhi usar LLM para fazer a tradução por mim, economizando muito tempo e permitindo a tradução para vários idiomas com um único comando.
+
+## 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 obtido 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 (usado para listar arquivos Markdown a partir do Git, ignorando arquivos filtrados pelas regras do `.gitignore`)
+
+Primeiro, trabalhe em uma pasta que já esteja sob controle do 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, 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`.
+
+- É possível especificar os idiomas para gerar 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.: o nome do repositório no GitHub Pages).
+- Não é necessário configurar o idioma de origem; o ZEN detecta automaticamente.
+
+```bash
+npx zengen@latest build --lang pt-BR --lang en-US
+```
+
+**Veja mais parâmetros ou obtenha ajuda**:
+
+```bash
+npx zengen@latest
+```

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/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/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/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md

@@ -0,0 +1,71 @@
+---
+'title': 'ZEN - минималистичный Markdown + AI генератор статических сайтов'
+'summary': 'ZEN — это генератор статических сайтов с функциями искусственного интеллекта, разработанный специально для документов Markdown. Он позволяет пользователям преобразовывать Git-папки с файлами Markdown в статические HTML-сайты без сложных настроек — все конфигурации скрыты в каталоге .zen. Ключевые функции включают интеллектуальную навигацию по категориям (с использованием AI для анализа содержимого и создания карты сайта), автоматический инкрементный перевод (поддержка многоязычных версий, позволяющая пользователям писать на родном языке, а AI обрабатывает перевод) и минималистичный опыт написания. Руководство по быстрому старту требует установки Node.js, получения OpenAI API Key и Git, сборки сайта через командную строку с поддержкой указания языка и базового URL.'
+'tags':
+  - 'генератор статических сайтов'
+  - 'Markdown'
+  - 'AI'
+  - 'многоязычный перевод'
+  - 'минимализм'
+  - 'инструмент для документов'
+  - 'Git'
+'inferred_lang': 'ru-RU'
+---
+
+# ZEN - минималистичный Markdown + AI генератор статических сайтов
+
+[> Демо сайта](https://zen.zccz14.com/)
+
+## Основные функции
+
+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 ru-RU --lang en-US`).
+- Можно указать базовый префикс URL сайта с помощью параметра `--base-url` (например, имя репозитория на GitHub Pages).
+- Исходный язык указывать не нужно, ZEN определит его автоматически.
+
+```bash
+npx zengen@latest build --lang ru-RU --lang en-US
+```
+
+**Посмотреть больше параметров или справку**:
+
+```bash
+npx zengen@latest
+```

package/.zen/src/sv-SE/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md

@@ -0,0 +1,70 @@
+---
+'title': 'ZEN - Minimalistisk Markdown + AI Static Site Builder'
+'summary': 'ZEN är en AI-integrerad statisk webbplatsgenerator som fokuserar på att förenkla dokumentationsskrivande och byggprocessen. Den låter användare skapa statiska HTML-webbplatser från git-hanterade mappar med Markdown, utan komplex konfiguration – alla inställningar är dolda i .zen-katalogen. Kärnfunktioner inkluderar intelligent kategorinavigering (genererar webbplatskarta via AI-innehållsanalys), automatisk inkrementell översättning (stödjer flerspråkiga versioner, användare kan skriva på modersmålet medan AI hanterar översättningar) och en skrivupplevelse med minimal störning. Verktyget kräver Node.js, OpenAI API-nyckel och Git, byggs snabbt via kommandoraden och stöder språkparametrar som zh-Hans och en-US.'
+'tags':
+  - 'Statisk webbplatsgenerator'
+  - 'Markdown'
+  - 'AI'
+  - 'Flerspråkig översättning'
+  - 'Minimalism'
+  - 'Dokumentationsverktyg'
+  - 'ZEN'
+'inferred_lang': 'zh-Hans'
+---
+
+# ZEN - Minimalistisk Markdown + AI Static Site Builder
+
+[> Webbplatsdemo](https://zen.zccz14.com/)
+
+## Grundläggande funktioner
+
+1. 📃 **Statisk webbplatsgenerering**: Bygg en statisk HTML-webbplats från valfri git-hanterad mapp som innehåller Markdown.
+2. 🧭 **Intelligent kategorinavigering**: Använder AI för innehållsanalys, genererar webbplatskarta och navigation – känslighet för källfilens placering elimineras.
+3. 🌍 **Automatisk inkrementell översättning**: Använder AI för inkrementell översättning, låter användare skriva Markdown på modersmålet samtidigt som webbplatsen blir flerspråkig.
+
+Varför ännu en Markdown-statisk-webbplatsgenerator? Jag har tänkt på hur dokumentationsverktyg i AI-eran bättre kan tjäna författare:
+
+- Återgå till innehållet: Minimal störning, fokus på skrivande
+
+  Låt dokumentationen återgå till sin essens, låt skrivandet återvända till lugn och ro.
+
+  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 format ännu. Jag vill att LLM automatiskt genererar titlar, sammanfattningar, kategoriseringar, navigering och annan organisering.
+
+  För det andra måste mitt skrivbord hållas rent. Jag vill inte ha komplexa byggverktyg, krångla med komplicerade dokumentationskonfigurationer eller invecklade strukturer. Varje gång jag ser konfigurationsfiler och projektstrukturer för verktyg som Docusaurus, VuePress eller Astro får jag huvudvärk. Nu har ZEN valt att gömma all konfiguration i .zen-katalogen – sopa undan den i ett hörn. Användaren behöver bara fokusera på innehållet, resten hanterar ZEN. Alla andra kataloger är ditt skrivutrymme, du kan organisera dina Markdown-filer hur du vill.
+
+- Återgå till modersmålet: Skriv på modersmålet, bygg smidiga flerspråkiga versioner
+
+  Livet är för kort för att översätta. När man använder sitt modersmål kan man uttrycka sina tankar på djupast sätt. 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å modersmålet samtidigt som fler kan se mitt innehåll. Nuvarande i18n-lösningar kräver inte bara egenöversättning utan även egen underhåll av innehållsuppdateringar – för besvärligt. Jag väljer att använda LLM för översättningar, sparar massor av tid och kan skapa flerspråkiga versioner med ett knapptryck.
+
+## Snabbstart
+
+Förutsättningar:
+
+- [Node.js](https://nodejs.org/) installerad (rekommenderas version 18 eller senare, npx-kommando krävs)
+- [OpenAI API-nyckel](https://platform.openai.com/account/api-keys) erhållen, eller OpenAI-kompatibel API-nyckel
+- Git installerad (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:
+
+Konfigurera miljövariabler
+
+```bash
+export OPENAI_API_KEY="sk-xxxxxx"  # Obligatoriskt: Ersätt med din OpenAI API-nyckel
+export OPENAI_BASE_URL="https://api.openai.com/v1"  # Valfritt, använder OpenAIs officiella API som standard
+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 `.zen/dist`-katalogen.
+
+- Du kan ange språkversioner som ska genereras genom att använda `--lang`-parametern flera gånger (t.ex. `--lang zh-Hans --lang en-US`).
+- Ingen källspråkskonfiguration behövs, ZEN upptäcker automatiskt.
+
+```bash
+npx zengen@latest build --lang zh-Hans --lang en-US
+```
+
+**Visa fler parametrar eller hjälp**:
+
+```bash
+npx zengen@latest
+```

package/.zen/src/sv-SE/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md

@@ -0,0 +1,71 @@
+---
+'title': 'ZEN - Minimalistisk Markdown + AI-statisk webbplatsbyggare'
+'summary': 'ZEN är en statisk webbplatsbyggare med AI-funktioner, speciellt utformad för Markdown-dokument. Den låter användare omvandla en Git-mapp med Markdown-filer till en statisk HTML-webbplats utan krånglig konfiguration – alla inställningar är dolda i .zen-katalogen. Kärnfunktioner inkluderar intelligent kategorinavigering (använder AI för att analysera innehåll och generera en webbplatskarta), automatisk inkrementell översättning (stödjer flerspråkiga versioner, användare kan skriva på sitt modersmål medan AI hanterar översättningen) och en skrivupplevelse med minimal störning. Snabbstartsguiden kräver installation av Node.js, hämtning av en OpenAI API-nyckel och Git, byggande av webbplatsen via kommandoraden, med stöd för att specificera språk och bas-URL.'
+'tags':
+  - 'Statisk webbplatsbyggare'
+  - 'Markdown'
+  - 'AI'
+  - 'Flerspråkig översättning'
+  - 'Minimalism'
+  - 'Dokumentationsverktyg'
+  - 'Git'
+'inferred_lang': 'zh-Hans'
+---
+
+# ZEN - Minimalistisk Markdown + AI-statisk webbplatsbyggare
+
+[> Webbplatsdemo](https://zen.zccz14.com/)
+
+## Grundläggande funktioner
+
+1. 📃 **Statisk webbplatsbyggnad**: Bygg en statisk HTML-webbplats från valfri git-mapp som innehåller Markdown.
+2. 🧭 **Intelligent kategorinavigering**: Använder AI för innehållsanalys, genererar webbplatskarta och navigering, känslighet för källfilernas placering är låg.
+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 ännu en Markdown-statisk webbplatsbyggare? Jag har tänkt om hur dokumentationsverktyg i AI-eran bättre kan tjäna författare:
+
+- Återgå till innehållet: Minimera störningar, fokusera på skrivandet
+
+  Låt dokumentationen återgå till sin kärna, låt skrivandet återvända till lugn och ro.
+
+  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 ännu eller format en tydlig struktur. Jag vill att LLM automatiskt ska generera titlar, göra sammanfattningar, kategorisera, skapa navigering och andra organisatoriska uppgifter.
+
+  För det andra måste mitt skrivbord hållas rent. Jag vill inte ha krångliga byggverktyg, krångla med komplex dokumentationskonfiguration eller gilla invecklade 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 .zen-katalogen, sopa undan den i ett hörn, så att användaren bara kan fokusera på att skriva innehåll – resten hanterar ZEN. Alla andra kataloger är ditt skrivutrymme, du kan organisera dina Markdown-filer hur du vill.
+
+- Återgå till modersmålet: Skriv på ditt modersmål, bygg smidigt flerspråkiga versioner
+
+  Livet är kort, jag har inte tid att översätta. När man använder sitt modersmål kan man uttrycka sina tankar på djupast sätt. 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 det gör mitt innehåll tillgängligt för fler. Nuvarande i18n kräver inte bara att man översätter själv, utan också att man underhåller innehållsuppdateringar – för besvärligt. Jag väljer att använda LLM för att hjälpa mig med översättningar, vilket sparar mycket tid och gör det möjligt att slutföra flerspråkiga översättningar med ett knapptryck.
+
+## Snabbstart
+
+Förutsättningar:
+
+- [Node.js](https://nodejs.org/) installerad (rekommenderad version 18 eller senare, npx-kommandot måste finnas)
+- [OpenAI API-nyckel](https://platform.openai.com/account/api-keys) hämtad, eller en OPENAI-kompatibel API-nyckel
+- Git installerat (används för att lista Markdown-filer från Git, ignorerar filer som filtreras bort av .gitignore-regler)
+
+Först, arbeta i en mapp som redan hanteras av git:
+
+Konfigurera miljövariabler
+
+```bash
+export OPENAI_API_KEY="sk-xxxxxx"  # Obligatoriskt: Ersätt med din OpenAI API-nyckel
+export OPENAI_BASE_URL="https://api.openai.com/v1"  # Valfritt, använder OpenAIs officiella API som standard
+export OPENAI_MODEL="gpt-3.5-turbo"  # Valfritt, använder gpt-3.5-turbo-modellen som standard
+```
+
+Bygg webbplatsen, stödjer flerspråkig översättning. Använd aktuell katalog som källkatalog, skicka utdata till `.zen/dist`-katalogen.
+
+- Du kan ange språkversioner som behöver genereras genom att använda `--lang`-parametern flera gånger (t.ex. `--lang zh-Hans --lang en-US`).
+- Du kan ange webbplatsens bas-URL-prefix med `--base-url`-parametern (t.ex. ett reponamn på GitHub Pages).
+- Ingen konfiguration av källspråk behövs, ZEN upptäcker det automatiskt.
+
+```bash
+npx zengen@latest build --lang zh-Hans --lang en-US
+```
+
+**Visa fler parametrar eller hjälp**:
+
+```bash
+npx zengen@latest
+```