zengen 0.2.1 → 0.2.3

package/.zen/src/pt-PT/04319611d7cde718d0e82da8e034e04b15fb3bb37c3784d8f7313577c5178b06.md

@@ -0,0 +1,73 @@
+---
+title: ZEN - Ferramenta de Construção de Sites de Documentação em Markdown
+summary: O ZEN é uma ferramenta minimalista de geração de sites estáticos em Markdown, focada na escrita de conteúdo, utilizando IA para processar tradução e navegação, suportando construção multilíngue sem configuração complexa.
+tags:
+  - Markdown
+  - Gerador de Sites Estáticos
+  - Tradução por IA
+  - Multilíngue
+  - Minimalismo
+  - Ferramenta de Documentação
+  - ZEN
+inferred_lang: pt-PT
+---
+
+# ZEN - Ferramenta de Construção de Sites de Documentação em Markdown
+
+[简体中文](https://zccz14.github.io/ZEN/zh-Hans) | [English](https://zccz14.github.io/ZEN/en-US)
+
+Por que criar mais um gerador de sites estáticos em 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. Às vezes quero escrever 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, o meu escritório 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 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 é tratado pelo ZEN. Todos os outros diretórios são o seu espaço de escrita, onde pode organizar os seus ficheiros Markdown como desejar.
+
+- **Regresso à língua materna**: Escrever na língua materna, construir versões multilíngues 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, e não quero abdicar da comunicação multilíngue. 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, a i18n exige que traduzamos e mantenhamos as atualizações de conteúdo, o que é muito trabalhoso. Opto por usar LLM para me ajudar com as traduções, poupando muito tempo e permitindo a tradução para vários idiomas com um único clique.
+
+## Funcionalidades Básicas
+
+1. **Geração de Sites Estáticos**
+   - Constrói um site HTML estático a partir de qualquer pasta que contenha ficheiros Markdown.
+
+2. **Navegação Inteligente**
+   - Gera um mapa do site e navegação, sem necessidade de manter a estrutura de diretórios original dos ficheiros Markdown de origem. Pode mover os ficheiros de origem livremente.
+
+3. **Tradução i18n Incremental**
+   - Utiliza LLM para tradução i18n incremental, permitindo que os utilizadores escrevam Markdown na sua língua materna, mas possam ter conteúdo multilíngue.
+
+## Filosofia de Design
+
+- **Minimalismo**: Configuração mínima, máxima flexibilidade.
+- **Prioridade ao Conteúdo**: Foco na escrita, não na configuração da ferramenta.
+- **Potenciado por IA**: Utiliza IA para processar tradução e organização de conteúdo.
+- **Translinguístico**: Suporta criação e exibição de conteúdo multilíngue.
+
+## Início Rápido
+
+### Modo de Uso Recomendado
+
+**Recomenda-se que os utilizadores mudem para o diretório que contém os ficheiros Markdown e usem diretamente o seguinte comando para começar a construção:**
+
+```bash
+# Definir variáveis de ambiente (modifique conforme a sua situação real)
+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
+
+# Construir o site, com suporte a tradução multilíngue
+npx zengen@latest build --lang pt-PT --lang en-US --verbose
+```
+
+**Ver mais parâmetros ou ajuda**:
+
+```bash
+npx zengen
+```
+
+**Nota**: O ZEN obriga a usar o diretório atual como diretório de origem, com saída para o diretório `.zen/dist`. Não suporta a especificação de parâmetros de diretório de origem ou de saída.

package/.zen/src/pt-PT/48eb2ad3e174cd06ed16c959fa58e0381dbc4a4147fa3456b21eea2b3d67c329.md

@@ -0,0 +1,81 @@
+---
+title: ZEN - Ferramenta de Construção de Sites de Documentação em Markdown
+summary: O ZEN é uma ferramenta de geração de sites estáticos em Markdown, focada na prioridade do conteúdo e no minimalismo. Utiliza IA para navegação inteligente e tradução multilíngue, ajudando os utilizadores a concentrarem-se na escrita sem configurações complexas.
+tags:
+  - Markdown
+  - Geração de Sites Estáticos
+  - Tradução por IA
+  - Multilíngue
+  - Minimalismo
+  - Ferramenta de Documentação
+  - ZEN
+inferred_lang: pt-PT
+---
+
+# ZEN - Ferramenta de Construção de Sites de Documentação em Markdown
+
+[简体中文](https://zccz14.github.io/ZEN/zh-Hans) |
+[English](https://zccz14.github.io/ZEN/en-US) |
+[Español](https://zccz14.github.io/ZEN/es-ES) |
+[Português](https://zccz14.github.io/ZEN/pt-PT) |
+[Русский](https://zccz14.github.io/ZEN/ru-RU) |
+[Français](https://zccz14.github.io/ZEN/fr-FR) |
+[日本語](https://zccz14.github.io/ZEN/ja-JP) |
+[한국어](https://zccz14.github.io/ZEN/ko-KR) |
+[Deutsch](https://zccz14.github.io/ZEN/de-DE) |
+
+Porque criar mais um gerador de sites estáticos em 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, devolver a tranquilidade à escrita.
+
+  Primeiro, não quero ser um bibliotecário. Às vezes quero escrever algo, mas talvez ainda não tenha pensado no título, ou não tenha uma organização específica. Espero que a LLM me ajude automaticamente a gerar títulos, fazer resumos, classificar, 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ções complexas, não gosto de estruturas complicadas. Sempre que vejo os ficheiros 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 utilizador só precisa de se concentrar no conteúdo da escrita, o resto é tratado pelo ZEN. Todos os outros diretórios são o seu espaço de escrita, pode organizar os seus ficheiros Markdown como quiser.
+
+- **Regresso à língua materna**: Escrever na língua materna, construir versões multilíngue 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, ao mesmo tempo, manter a ligação com o mundo é necessário, não quero abdicar da comunicação multilíngue. Por isso, desejo uma ferramenta que me permita escrever na minha língua materna e, ao mesmo tempo, permita que mais pessoas vejam o meu conteúdo. Atualmente, o i18n exige que traduzamos nós próprios e ainda temos de manter as atualizações de conteúdo, é muito 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.
+
+## Funcionalidades Básicas
+
+1. **Geração de Sites Estáticos**
+   - Constrói uma pasta qualquer que contenha ficheiros Markdown num site HTML estático.
+
+2. **Navegação Inteligente**
+   - Gera um mapa do site e navegação. Não é necessário manter a estrutura de diretórios original dos ficheiros Markdown de origem; pode mover os ficheiros de origem livremente.
+
+3. **Tradução i18n Incremental**
+   - Utiliza LLM para tradução i18n incremental, permitindo que os utilizadores escrevam Markdown na sua língua materna, mas possam ter conteúdo multilíngue.
+
+## Filosofia de Design
+
+- **Minimalismo**: Configuração mínima, flexibilidade máxima.
+- **Prioridade ao Conteúdo**: Foco na escrita, não na configuração da ferramenta.
+- **Potenciado por IA**: Utiliza IA para processar tradução e organização de conteúdo.
+- **Translinguístico**: Suporta criação e exibição de conteúdo multilíngue.
+
+## Início Rápido
+
+### Modo de Utilização Recomendado
+
+**Recomenda-se que os utilizadores mudem para o diretório que contém os ficheiros Markdown e utilizem diretamente o seguinte comando para começar a construção:**
+
+```bash
+# Definir variáveis de ambiente (modificar de acordo com a sua situação real)
+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 utiliza a API oficial da OpenAI
+export OPENAI_MODEL="gpt-3.5-turbo"  # Opcional, por padrão utiliza o modelo gpt-3.5-turbo
+
+# Construir o site, suporta tradução multilíngue
+npx zengen@latest build --lang pt-PT --lang en-US --verbose
+```
+
+**Ver mais parâmetros ou ajuda**:
+
+```bash
+npx zengen
+```
+
+**Nota**: O ZEN obriga a utilizar o diretório atual como diretório de origem, com saída para o diretório `.zen/dist`. Não suporta a especificação de parâmetros de diretório de origem e diretório de saída.

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

@@ -0,0 +1,71 @@
+---
+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
+---
+
+# 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 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.
+
+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, devolver a tranquilidade à 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.
+
+  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.
+
+- 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 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.
+
+## Início Rápido
+
+Pré-requisitos:
+
+- Ter o [Node.js](https://nodejs.org/) instalado (versão 18 ou superior recomendada, necessário comando `npx`)
+- 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, 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
+```
+
+Construa o site, suportando tradução multilingue. Usa o diretório atual como origem e gera a saída no 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).
+- 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/ru-RU/04319611d7cde718d0e82da8e034e04b15fb3bb37c3784d8f7313577c5178b06.md

@@ -0,0 +1,73 @@
+---
+title: ZEN - Инструмент для создания сайтов документации на Markdown
+summary: ZEN — это минималистичный генератор статических сайтов на Markdown, ориентированный на написание контента. Использует ИИ для обработки перевода и навигации, поддерживает многоязычную сборку без сложной конфигурации.
+tags:
+  - Markdown
+  - Генератор статических сайтов
+  - ИИ-перевод
+  - Мультиязычность
+  - Минимализм
+  - Инструмент для документации
+  - ZEN
+inferred_lang: ru-RU
+---
+
+# ZEN - Простой инструмент для создания сайтов документации на Markdown
+
+[简体中文](https://zccz14.github.io/ZEN/zh-Hans) | [English](https://zccz14.github.io/ZEN/en-US)
+
+Зачем ещё один генератор статических сайтов на Markdown? Я заново обдумал, как инструменты для документации в эпоху ИИ могут лучше служить авторам:
+
+- **Возвращение к содержанию**: Минимизация отвлечений, концентрация на письме
+
+  Вернуть документации её суть, а письму — спокойствие.
+
+  Во-первых, я не хочу быть библиотекарем. Иногда я хочу что-то записать, но, возможно, ещё не придумал заголовок или не сформировал чёткую структуру. Я хочу, чтобы LLM автоматически генерировала для меня заголовки, делала резюме, классифицировала, создавала навигацию и другую организационную работу.
+
+  Во-вторых, мой кабинет должен быть чистым. Мне не нужны инструменты сборки со сложной конфигурацией, возня со сложными настройками документации, не нравятся сложные структуры. Каждый раз, когда я вижу конфигурационные файлы и структуру проектов таких инструментов, как Docusaurus, VuePress, Astro, у меня начинает болеть голова. Теперь ZEN прячет всю конфигурацию в каталог `.zen`, сметает её в угол. Пользователю нужно сосредоточиться только на написании контента, всё остальное ZEN берёт на себя. Все остальные каталоги — это ваше рабочее пространство, вы можете организовывать свои Markdown-файлы как угодно.
+
+- **Возвращение к родному языку**: Пишите на родном языке, плавно создавайте многоязычные версии
+
+  Жизнь коротка, мне лень переводить. Человек наиболее полно раскрывает глубину своего мышления, используя родной язык. Но при этом оставаться на связи с миром необходимо, я не хочу отказываться от многоязычного общения. Поэтому мне хотелось бы иметь инструмент, который позволил бы мне писать на родном языке и одновременно сделать мой контент доступным для большего числа людей. Современные решения i18n требуют не только самостоятельного перевода, но и поддержания актуальности контента, что слишком хлопотно. Я выбираю использование LLM для перевода, что экономит мне массу времени и позволяет выполнить перевод на множество языков одним нажатием.
+
+## Основные возможности
+
+1. **Генерация статического сайта**
+   - Преобразует любую папку с Markdown-файлами в статический HTML-сайт.
+
+2. **Интеллектуальная навигация**
+   - Генерирует карту сайта и навигацию. Не требуется сохранять исходную структуру каталогов Markdown-файлов, исходные файлы можно свободно перемещать.
+
+3. **Инкрементный i18n-перевод**
+   - Использует LLM для инкрементного i18n-перевода, позволяя пользователю писать Markdown на родном языке, но при этом быть многоязычным.
+
+## Философия дизайна
+
+- **Минимализм**: Минимум конфигурации, максимум гибкости.
+- **Приоритет контента**: Сосредоточьтесь на письме, а не на настройке инструментов.
+- **Расширение возможностей с помощью ИИ**: Использование ИИ для обработки перевода и организации контента.
+- **Кросс-язычность**: Поддержка создания и отображения многоязычного контента.
+
+## Быстрый старт
+
+### Рекомендуемый способ использования
+
+**Рекомендуется перейти в каталог, содержащий Markdown-файлы, и сразу использовать следующую команду для начала сборки:**
+
+```bash
+# Установите переменные окружения (измените в соответствии с вашей ситуацией)
+export OPENAI_API_KEY="sk-xxxxxx"  # Обязательно: замените на ваш OpenAI API Key
+export OPENAI_BASE_URL="https://api.openai.com/v1"  # Опционально, по умолчанию используется официальный OpenAI API
+export OPENAI_MODEL="gpt-3.5-turbo"  # Опционально, по умолчанию используется модель gpt-3.5-turbo
+
+# Собрать сайт с поддержкой многоязычного перевода
+npx zengen@latest build --lang zh-Hans --lang en-US --verbose
+```
+
+**Посмотреть больше параметров или справку**:
+
+```bash
+npx zengen
+```
+
+**Примечание**: ZEN принудительно использует текущий каталог в качестве исходного, вывод осуществляется в каталог `.zen/dist`. Параметры для указания исходного и выходного каталогов не поддерживаются.

package/.zen/src/ru-RU/48eb2ad3e174cd06ed16c959fa58e0381dbc4a4147fa3456b21eea2b3d67c329.md

@@ -0,0 +1,81 @@
+---
+title: ZEN - Инструмент для создания сайтов документации на Markdown
+summary: ZEN — это простой генератор статических сайтов на Markdown, ориентированный на контент и минимализм. Использует ИИ для интеллектуальной навигации и многоязычного перевода, помогая пользователям сосредоточиться на написании текстов без сложных настроек.
+tags:
+  - Markdown
+  - Генератор статических сайтов
+  - ИИ-перевод
+  - Многоязычность
+  - Минимализм
+  - Инструмент для документации
+  - ZEN
+inferred_lang: ru-RU
+---
+
+# ZEN - Простой инструмент для создания сайтов документации на Markdown
+
+[简体中文](https://zccz14.github.io/ZEN/zh-Hans) |
+[English](https://zccz14.github.io/ZEN/en-US) |
+[Español](https://zccz14.github.io/ZEN/es-ES) |
+[Português](https://zccz14.github.io/ZEN/pt-PT) |
+[Русский](https://zccz14.github.io/ZEN/ru-RU) |
+[Français](https://zccz14.github.io/ZEN/fr-FR) |
+[日本語](https://zccz14.github.io/ZEN/ja-JP) |
+[한국어](https://zccz14.github.io/ZEN/ko-KR) |
+[Deutsch](https://zccz14.github.io/ZEN/de-DE) |
+
+Зачем создавать ещё один генератор статических сайтов на Markdown? Я задумался о том, как инструменты для документации могут лучше служить авторам в эпоху ИИ:
+
+- **Возвращение к контенту**: Минимизация отвлекающих факторов, фокус на написании
+
+  Вернуть документации её суть, а написанию — спокойствие.
+
+  Во-первых, я не хочу быть библиотекарем. Иногда я хочу что-то записать, но, возможно, ещё не придумал заголовок или не организовал это должным образом. Я хочу, чтобы LLM автоматически генерировала заголовки, делала резюме, классифицировала, создавала навигацию и выполняла другую организационную работу.
+
+  Во-вторых, мой рабочий кабинет должен быть чистым. Мне не нужны сложные инструменты сборки с запутанными конфигурациями, не нравятся сложные структуры. Каждый раз, когда я вижу конфигурационные файлы и структуру проектов таких инструментов, как Docusaurus, VuePress, Astro, у меня начинает болеть голова. Теперь ZEN прячет все настройки в каталог `.zen`, сметает их в угол. Пользователю нужно сосредоточиться только на содержании, а всё остальное ZEN берёт на себя. Все остальные каталоги — это ваше рабочее пространство, вы можете свободно организовывать свои Markdown-файлы.
+
+- **Возвращение к родному языку**: Пишите на родном языке, плавно создавайте многоязычные версии
+
+  Жизнь коротка, мне лень переводить. Человек наиболее полно раскрывает глубину своего мышления, используя родной язык. Но при этом оставаться на связи с миром необходимо, и я не хочу отказываться от многоязычного общения. Поэтому мне хотелось бы иметь инструмент, который позволил бы мне писать на родном языке, но при этом сделать мой контент доступным для большего числа людей. Текущие решения i18n требуют не только самостоятельного перевода, но и поддержания актуальности контента, что слишком хлопотно. Я выбрал использование LLM для перевода, что экономит мне много времени и позволяет выполнить перевод на множество языков одним нажатием кнопки.
+
+## Основные возможности
+
+1.  **Генерация статического сайта**
+    - Преобразует любую папку с Markdown-файлами в статический HTML-сайт.
+
+2.  **Интеллектуальная навигация**
+    - Генерирует карту сайта и навигацию. Не требуется сохранять исходную структуру каталогов Markdown-файлов, исходные файлы можно свободно перемещать.
+
+3.  **Инкрементный i18n-перевод**
+    - Использует LLM для инкрементного i18n-перевода, позволяя пользователям писать Markdown на родном языке, но при этом создавать многоязычный контент.
+
+## Философия дизайна
+
+- **Минимализм**: Минимум настроек, максимум гибкости.
+- **Приоритет контента**: Фокус на написании, а не на настройке инструментов.
+- **ИИ-возможности**: Использование ИИ для обработки перевода и организации контента.
+- **Кросс-язычность**: Поддержка создания и отображения многоязычного контента.
+
+## Быстрый старт
+
+### Рекомендуемый способ использования
+
+**Рекомендуется перейти в каталог, содержащий Markdown-файлы, и сразу начать сборку с помощью следующей команды:**
+
+```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
+
+# Собрать сайт с поддержкой многоязычного перевода
+npx zengen@latest build --lang zh-Hans --lang en-US --verbose
+```
+
+**Посмотреть больше параметров или справку**:
+
+```bash
+npx zengen
+```
+
+**Примечание**: ZEN принудительно использует текущий каталог в качестве исходного, а вывод помещает в каталог `.zen/dist`. Не поддерживается указание параметров исходного и выходного каталогов.

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

@@ -0,0 +1,71 @@
+---
+title: ZEN - Минималистичный генератор статических сайтов на Markdown + AI
+summary: ZEN — это генератор статических сайтов с интеграцией AI, поддерживающий интеллектуальную навигацию по категориям и автоматический инкрементный перевод, позволяя пользователям сосредоточиться на написании на родном языке и упрощая процесс настройки и сборки.
+tags:
+  - Генератор статических сайтов
+  - Markdown
+  - Искусственный интеллект
+  - Многоязычный перевод
+  - Минимализм
+  - Инструменты для документации
+  - Node.js
+inferred_lang: 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-ключ
+- Установлен 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 --lang en-US`).
+- Можно указать базовый URL-префикс сайта с помощью параметра `--base-url` (например, имя репозитория на GitHub Pages).
+- Исходный язык указывать не нужно, ZEN определит его автоматически.
+
+```bash
+npx zengen@latest build --lang ru --lang en-US
+```
+
+**Просмотреть больше параметров или справку:**
+
+```bash
+npx zengen@latest
+```

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

@@ -0,0 +1,71 @@
+---
+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
+---
+
+# ZEN - Minimalistisk Markdown + AI Static Site Builder
+
+[> 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.
+
+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:
+
+- **Å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.
+
+  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 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.
+
+- **Återgå till modersmålet**: Skriv på ditt modersmål, bygg sömlöst 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.
+
+## Snabbstart
+
+Förutsättningar:
+
+- [Node.js](https://nodejs.org/) installerat (rekommenderad version 18 eller högre, kommandot `npx` måste finnas)
+- 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)
+
+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 katalogen `.zen/dist`.
+
+- 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.
+
+```bash
+npx zengen@latest build --lang zh-Hans --lang en-US
+```
+
+**Visa fler parametrar eller hjälp**:
+
+```bash
+npx zengen@latest
+```

package/.zen/src/th-TH/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md

@@ -0,0 +1,71 @@
+---
+title: ZEN - เครื่องมือสร้างเว็บไซต์แบบสแตติกที่เรียบง่าย Markdown + AI
+summary: ZEN เป็นเครื่องมือสร้างเว็บไซต์แบบสแตติกที่ผสาน AI รองรับการนำทางแบบจัดประเภทอัจฉริยะและการแปลแบบเพิ่มอัตโนมัติ ช่วยให้ผู้ใช้สามารถมุ่งเน้นการเขียนด้วยภาษาแม่ และลดความซับซ้อนของกระบวนการกำหนดค่าและการสร้าง
+tags:
+  - เครื่องมือสร้างเว็บไซต์แบบสแตติก
+  - Markdown
+  - AI
+  - การแปลหลายภาษา
+  - เรียบง่าย
+  - เครื่องมือเอกสาร
+  - Node.js
+inferred_lang: th-TH
+---
+
+# 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"  # ไม่บังคับ ค่าเริ่มต้นใช้ OpenAI API ทางการ
+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
+```