zengen 0.2.0 → 0.2.2

package/.zen/src/ko-KR/48eb2ad3e174cd06ed16c959fa58e0381dbc4a4147fa3456b21eea2b3d67c329.md

@@ -0,0 +1,81 @@
+---
+title: ZEN - 마크다운 문서 사이트 빌드 도구
+summary: ZEN은 내용 중심과 극도의 간결함을 강조하는 깔끔한 마크다운 정적 사이트 생성 도구입니다. AI를 활용한 지능형 탐색 및 다국어 번역을 통해 사용자가 복잡한 설정 없이 글쓰기에 집중할 수 있도록 돕습니다.
+tags:
+  - Markdown
+  - 정적 사이트 생성
+  - AI 번역
+  - 다국어
+  - 미니멀리즘
+  - 문서 도구
+  - ZEN
+inferred_lang: ko-KR
+---
+
+# ZEN - 깔끔한 마크다운 문서 사이트 빌드 도구
+
+[简体中文](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) |
+
+왜 또 다른 마크다운 정적 사이트 생성기를 만들었을까요? AI 시대에 문서 도구가 글쓰는 사람에게 어떻게 더 잘 서비스할 수 있을지 다시 생각해보았습니다:
+
+- **내용으로의 회귀**: 최소한의 방해, 글쓰기에 집중
+
+  문서의 본질과 글쓰기의 평온함으로 돌아갑니다.
+
+  첫째, 저는 도서관 사서가 되고 싶지 않습니다. 때로는 내용을 적고 싶지만, 아직 제목을 정하지 못했거나 특별한 체계를 갖추지 못한 경우가 있습니다. LLM이 자동으로 제목을 생성하고, 요약하고, 분류하고, 탐색하는 등의 정리 작업을 해주길 바랍니다.
+
+  둘째, 제 서재는 반드시 깨끗해야 합니다. 복잡한 구성 도구를 설정하거나, 복잡한 문서 구성을 꾸미는 것을 원하지 않으며, 복잡한 구조를 좋아하지 않습니다. Docusaurus, VuePress, Astro 같은 도구들의 설정 파일과 프로젝트 구조를 볼 때마다 머리가 아픕니다. 이제 ZEN은 모든 구성을 `.zen` 디렉토리 안에 숨겨 구석으로 치우기로 선택했습니다. 사용자는 글쓰기 내용에만 집중하면 되며, 나머지는 ZEN이 처리합니다. 다른 디렉토리들은 모두 여러분의 글쓰기 공간이며, 마크다운 파일을 자유롭게 구성할 수 있습니다.
+
+- **모국어로의 회귀**: 모국어로 글쓰고, 부드러운 다국어 버전 빌드
+
+  인생은 짧습니다. 저는 번역하기 귀찮습니다. 사람은 모국어를 사용할 때 가장 깊이 생각할 수 있습니다. 하지만 동시에 세계와 연결을 유지하는 것도 필요하며, 다국어 소통을 포기하고 싶지 않습니다. 그래서 저는 모국어로 글을 쓰면서도 더 많은 사람들이 제 내용을 볼 수 있도록 해주는 도구를 원했습니다. 현재의 i18n은 직접 번역해야 할 뿐만 아니라 내용 업데이트도 직접 관리해야 하니 너무 번거롭습니다. 저는 LLM을 사용하여 번역을 도와주도록 선택했고, 많은 시간을 절약하며 한 번의 클릭으로 여러 국가 언어 번역을 완료할 수 있습니다.
+
+## 기본 기능
+
+1. **정적 사이트 생성**
+   - 마크다운 파일이 포함된 임의의 폴더를 정적 HTML 사이트로 빌드합니다.
+
+2. **지능형 탐색**
+   - 사이트맵과 탐색을 생성합니다. 원본 마크다운 소스 파일의 디렉토리 구조를 유지할 필요가 없으며, 소스 파일을 자유롭게 이동할 수 있습니다.
+
+3. **증분 i18n 번역**
+   - LLM을 사용한 증분 i18n 번역으로, 사용자가 모국어로 마크다운을 작성하지만 다국어 사용자가 될 수 있도록 합니다.
+
+## 디자인 철학
+
+- **미니멀리즘**: 최소한의 구성, 최대의 유연성
+- **내용 우선**: 도구 구성이 아닌 글쓰기에 집중
+- **AI 활용**: AI를 활용한 번역 및 내용 구성
+- **다국어 지원**: 다국어 콘텐츠 제작 및 표시 지원
+
+## 빠른 시작
+
+### 권장 사용 방법
+
+**사용자는 마크다운 파일이 포함된 디렉토리로 전환한 후, 아래 명령어를 직접 사용하여 빌드를 시작하는 것을 권장합니다:**
+
+```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/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/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/zh-Hans/04319611d7cde718d0e82da8e034e04b15fb3bb37c3784d8f7313577c5178b06.md

@@ -0,0 +1,73 @@
+---
+title: ZEN - Markdown 文档站点构建工具
+summary: ZEN 是一个极简的 Markdown 静态站点生成工具，专注于内容写作，利用 AI 处理翻译和导航，支持多语言构建，无需复杂配置。
+tags:
+  - Markdown
+  - 静态站点生成器
+  - AI 翻译
+  - 多语言
+  - 极简主义
+  - 文档工具
+  - ZEN
+inferred_lang: zh-Hans
+---
+
+# ZEN - 简洁的 Markdown 文档站点构建工具
+
+[简体中文](https://zccz14.github.io/ZEN/zh-Hans) | [English](https://zccz14.github.io/ZEN/en-US)
+
+为什么又搞了个 Markdown 静态站点生成器？我重新思考了 AI 时代下，文档工具可以如何更好地服务于写作者：
+
+- 回归内容：最小化打扰，专注写作
+
+  让文档回归本质，让写作回归宁静。
+
+  其一，我不想做图书管理员。我有时想写下一些内容，但我可能还没有想好它的标题，还没有形成特别的组织。我希望 LLM 会自动帮我生成标题、做摘要、分类、导航等整理工作。
+
+  其二，我的书房必须打扫干净。我不想要配置复杂的构建工具，折腾复杂的文档配置，不喜欢复杂的结构。每次我看到 Docusaurus、VuePress、Astro 这些工具的配置文件和项目结构，我就头疼。现在，ZEN 选择将所有的配置都隐藏到 .zen 目录下，扫到角落里，用户只需要专注于写作内容，其他的交给 ZEN 来处理。其他的目录都是您的写作空间，您可以随意组织您的 Markdown 文件。
+
+- 回归母语：用母语写作，丝滑构建多语言版本
+
+  人生苦短，我懒得翻译。人在使用母语时，才是最能发挥自身思考深度的。但同时与世界保持连接又是必要的，我不想放弃多语言的交流。于是我希望有一个工具，能让我用母语写作，同时又能让更多人看到我的内容。现在的 i18n 需要自己翻译不说，还得自己维护内容更新，太麻烦了。我选择使用 LLM 来帮我做翻译，省下了我很多时间，并且可以一键完成多国语言翻译。
+
+## 基本功能
+
+1. **静态站点生成**
+   - 将任意一个包含 Markdown 的文件夹构建成一个静态 HTML 站点
+
+2. **智能导航**
+   - 生成站点地图和导航，不需要保持原始的 Markdown 源文件的目录结构，可以随意移动源文件。
+
+3. **增量 i18n 翻译**
+   - 使用 LLM 进行增量 i18n 翻译，让用户使用母语编写 Markdown，但是用户可以是多语言的
+
+## 设计理念
+
+- **极简主义**: 最少的配置，最大的灵活性
+- **内容优先**: 专注于写作，而不是工具配置
+- **AI 赋能**: 利用 AI 处理翻译和内容组织
+- **跨语言**: 支持多语言内容创作和展示
+
+## 快速开始
+
+### 推荐使用方式
+
+**推荐用户切换到包含 Markdown 文件的目录下，直接使用以下命令开始构建：**
+
+```bash
+# 设置环境变量 (根据您的实际情况修改)
+export OPENAI_API_KEY="sk-xxxxxx"  # 必须：请替换为您的 OpenAI API Key
+export OPENAI_BASE_URL="https://api.openai.com/v1"  # 可选，默认使用 OpenAI 官方 API
+export OPENAI_MODEL="gpt-3.5-turbo"  # 可选，默认使用 gpt-3.5-turbo 模型
+
+# 构建站点，支持多语言翻译
+npx zengen@latest build --lang zh-Hans --lang en-US --verbose
+```
+
+**查看更多参数或帮助**：
+
+```bash
+npx zengen
+```
+
+**注意**：ZEN 强制使用当前目录作为源目录，输出到 `.zen/dist` 目录。不支持指定源目录和输出目录参数。

package/.zen/src/zh-Hans/084ef1f6a0167df8621c673c79211309d4af6c588e7bbe3e043f7c244edd0ac6.md

@@ -0,0 +1,80 @@
+---
+title: ZEN - Markdown 文档站点构建工具
+summary: ZEN 是一个简洁的 Markdown 静态站点生成工具，专注于内容写作，利用 AI 实现智能导航和多语言翻译，无需复杂配置。
+tags:
+  - Markdown
+  - 静态站点生成
+  - AI 翻译
+  - 多语言
+  - 极简主义
+  - 文档工具
+  - ZEN
+inferred_lang: zh-Hans
+---
+
+# 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) |
+[Ruсть](https://zccz14.github.io/ZEN/ru-RU) |
+[Français](https://zccz14.github.io/ZEN/fr-FR) |
+[Deutsch](https://zccz14.github.io/ZEN/de-DE) |
+[日本語](https://zccz14.github.io/ZEN/ja-JP) |
+[한국어](https://zccz14.github.io/ZEN/ko-KR)
+
+为什么又搞了个 Markdown 静态站点生成器？我重新思考了 AI 时代下，文档工具可以如何更好地服务于写作者：
+
+- 回归内容：最小化打扰，专注写作
+
+  让文档回归本质，让写作回归宁静。
+
+  其一，我不想做图书管理员。我有时想写下一些内容，但我可能还没有想好它的标题，还没有形成特别的组织。我希望 LLM 会自动帮我生成标题、做摘要、分类、导航等整理工作。
+
+  其二，我的书房必须打扫干净。我不想要配置复杂的构建工具，折腾复杂的文档配置，不喜欢复杂的结构。每次我看到 Docusaurus、VuePress、Astro 这些工具的配置文件和项目结构，我就头疼。现在，ZEN 选择将所有的配置都隐藏到 .zen 目录下，扫到角落里，用户只需要专注于写作内容，其他的交给 ZEN 来处理。其他的目录都是您的写作空间，您可以随意组织您的 Markdown 文件。
+
+- 回归母语：用母语写作，丝滑构建多语言版本
+
+  人生苦短，我懒得翻译。人在使用母语时，才是最能发挥自身思考深度的。但同时与世界保持连接又是必要的，我不想放弃多语言的交流。于是我希望有一个工具，能让我用母语写作，同时又能让更多人看到我的内容。现在的 i18n 需要自己翻译不说，还得自己维护内容更新，太麻烦了。我选择使用 LLM 来帮我做翻译，省下了我很多时间，并且可以一键完成多国语言翻译。
+
+## 基本功能
+
+1. **静态站点生成**
+   - 将任意一个包含 Markdown 的文件夹构建成一个静态 HTML 站点
+
+2. **智能导航**
+   - 生成站点地图和导航，不需要保持原始的 Markdown 源文件的目录结构，可以随意移动源文件。
+
+3. **增量 i18n 翻译**
+   - 使用 LLM 进行增量 i18n 翻译，让用户使用母语编写 Markdown，但是用户可以是多语言的
+
+## 设计理念
+
+- **极简主义**: 最少的配置，最大的灵活性
+- **内容优先**: 专注于写作，而不是工具配置
+- **AI 赋能**: 利用 AI 处理翻译和内容组织
+- **跨语言**: 支持多语言内容创作和展示
+
+## 快速开始
+
+### 推荐使用方式
+
+**推荐用户切换到包含 Markdown 文件的目录下，直接使用以下命令开始构建：**
+
+```bash
+# 设置环境变量 (根据您的实际情况修改)
+export OPENAI_API_KEY="sk-xxxxxx"  # 必须：请替换为您的 OpenAI API Key
+export OPENAI_BASE_URL="https://api.openai.com/v1"  # 可选，默认使用 OpenAI 官方 API
+export OPENAI_MODEL="gpt-3.5-turbo"  # 可选，默认使用 gpt-3.5-turbo 模型
+
+# 构建站点，支持多语言翻译
+npx zengen@latest build --lang zh-Hans --lang en-US --verbose
+```
+
+**查看更多参数或帮助**：
+
+```bash
+npx zengen
+```
+
+**注意**：ZEN 强制使用当前目录作为源目录，输出到 `.zen/dist` 目录。不支持指定源目录和输出目录参数。

package/.zen/src/zh-Hans/48eb2ad3e174cd06ed16c959fa58e0381dbc4a4147fa3456b21eea2b3d67c329.md

@@ -0,0 +1,81 @@
+---
+title: ZEN - Markdown 文档站点构建工具
+summary: ZEN 是一个简洁的 Markdown 静态站点生成工具，强调内容优先和极简主义，利用 AI 实现智能导航和多语言翻译，帮助用户专注于写作而无需复杂配置。
+tags:
+  - Markdown
+  - 静态站点生成
+  - AI 翻译
+  - 多语言
+  - 极简主义
+  - 文档工具
+  - ZEN
+inferred_lang: zh-Hans
+---
+
+# 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 静态站点生成器？我重新思考了 AI 时代下，文档工具可以如何更好地服务于写作者：
+
+- 回归内容：最小化打扰，专注写作
+
+  让文档回归本质，让写作回归宁静。
+
+  其一，我不想做图书管理员。我有时想写下一些内容，但我可能还没有想好它的标题，还没有形成特别的组织。我希望 LLM 会自动帮我生成标题、做摘要、分类、导航等整理工作。
+
+  其二，我的书房必须打扫干净。我不想要配置复杂的构建工具，折腾复杂的文档配置，不喜欢复杂的结构。每次我看到 Docusaurus、VuePress、Astro 这些工具的配置文件和项目结构，我就头疼。现在，ZEN 选择将所有的配置都隐藏到 .zen 目录下，扫到角落里，用户只需要专注于写作内容，其他的交给 ZEN 来处理。其他的目录都是您的写作空间，您可以随意组织您的 Markdown 文件。
+
+- 回归母语：用母语写作，丝滑构建多语言版本
+
+  人生苦短，我懒得翻译。人在使用母语时，才是最能发挥自身思考深度的。但同时与世界保持连接又是必要的，我不想放弃多语言的交流。于是我希望有一个工具，能让我用母语写作，同时又能让更多人看到我的内容。现在的 i18n 需要自己翻译不说，还得自己维护内容更新，太麻烦了。我选择使用 LLM 来帮我做翻译，省下了我很多时间，并且可以一键完成多国语言翻译。
+
+## 基本功能
+
+1. **静态站点生成**
+   - 将任意一个包含 Markdown 的文件夹构建成一个静态 HTML 站点
+
+2. **智能导航**
+   - 生成站点地图和导航，不需要保持原始的 Markdown 源文件的目录结构，可以随意移动源文件。
+
+3. **增量 i18n 翻译**
+   - 使用 LLM 进行增量 i18n 翻译，让用户使用母语编写 Markdown，但是用户可以是多语言的
+
+## 设计理念
+
+- **极简主义**: 最少的配置，最大的灵活性
+- **内容优先**: 专注于写作，而不是工具配置
+- **AI 赋能**: 利用 AI 处理翻译和内容组织
+- **跨语言**: 支持多语言内容创作和展示
+
+## 快速开始
+
+### 推荐使用方式
+
+**推荐用户切换到包含 Markdown 文件的目录下，直接使用以下命令开始构建：**
+
+```bash
+# 设置环境变量 (根据您的实际情况修改)
+export OPENAI_API_KEY="sk-xxxxxx"  # 必须：请替换为您的 OpenAI API Key
+export OPENAI_BASE_URL="https://api.openai.com/v1"  # 可选，默认使用 OpenAI 官方 API
+export OPENAI_MODEL="gpt-3.5-turbo"  # 可选，默认使用 gpt-3.5-turbo 模型
+
+# 构建站点，支持多语言翻译
+npx zengen@latest build --lang zh-Hans --lang en-US --verbose
+```
+
+**查看更多参数或帮助**：
+
+```bash
+npx zengen
+```
+
+**注意**：ZEN 强制使用当前目录作为源目录，输出到 `.zen/dist` 目录。不支持指定源目录和输出目录参数。

package/.zen/src/zh-Hans/6124ea88edec5bde737b26b21f71ecfeffe4e73151784856edf813ee231a4baa.md

@@ -1 +1,11 @@
+---
+title: 测试文档
+summary: 这是一个测试文档，内容为空，仅包含标题。
+tags:
+  - 测试
+  - 文档
+  - 示例
+inferred_lang: zh-CN
+---
+
 # 测试文档