czon 0.1.0 → 0.1.1

package/.zen/src/ja-JP/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md

@@ -0,0 +1,71 @@
+---
+'title': 'ZEN - 極簡主義 Markdown + AI 静的サイトビルダー'
+'summary': 'ZENはAI機能を統合した静的サイトジェネレーターで、Markdown文書専用に設計されています。Gitで管理されたMarkdownファイルを含むフォルダを、複雑な設定なしに静的HTMLサイトへ変換でき、全ての設定は.zenディレクトリ内に隠蔽されます。中核機能には、インテリジェントな分類ナビゲーション（AIによるコンテンツ分析を用いたサイトマップ生成）、自動インクリメンタル翻訳（多言語バージョンをサポート。ユーザーは母国語で執筆し、AIが翻訳を処理）、そして最小限の邪魔で執筆に集中できる体験が含まれます。クイックスタートガイドでは、Node.jsのインストール、OpenAI APIキーの取得、Gitの準備が必要で、コマンドラインからサイトを構築し、言語とベースURLの指定をサポートします。'
+'tags':
+  - '静的サイトジェネレーター'
+  - 'Markdown'
+  - 'AI'
+  - '多言語翻訳'
+  - '極簡主義'
+  - '文書ツール'
+  - 'Git'
+'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 Key を所持
+- Git がインストール済み（GitからMarkdownファイルをリストアップし、.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`）。
+- `--base-url` パラメータで、サイトのベースURLプレフィックスを指定できます（例：GitHub Pages上のリポジトリ名）。
+- ソース言語の設定は不要です。ZENが自動的に検出します。
+
+```bash
+npx zengen@latest build --lang zh-Hans --lang en-US
+```
+
+**その他のパラメータやヘルプを表示する**：
+
+```bash
+npx zengen@latest
+```

package/.zen/src/ja-JP/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md

@@ -0,0 +1,30 @@
+---
+'title': 'ZENドキュメントにおける日付宣言の使用テクニック'
+'summary': 'このドキュメントでは、ZENツールにおいて本文中で直接日付を宣言する使用テクニックを紹介します。従来のMarkdownがYAML Frontmatterを通じて日付を宣言する方法と比較し、ZENの自動認識とインテリジェントな処理機能を強調します。これによりユーザー体験が向上し、日記、ブログなどタイムラインが必要なコンテンツタイプに適しています。'
+'tags':
+  - 'ZEN'
+  - '日付宣言'
+  - 'Markdown'
+  - 'AI処理'
+  - 'タイムライン'
+  - 'ユーザー体験'
+  - 'ドキュメント管理'
+'inferred_date': '2026-01-08'
+'inferred_lang': 'zh-Hans'
+---
+
+# 使用テクニック
+
+## 本文中での日付宣言
+
+本文中では「今日は2026年1月8日です」といった日付宣言（形式は自由）を使用することができ、ZENが自動的に認識・処理します。
+
+従来のMarkdownドキュメントでは、YAML Frontmatterを通じて日付を宣言する必要があり、対応するフィールドを覚えておかなければ、日付が正しく認識されない可能性がありました。
+
+ZENは本文中での直接的な日付宣言をサポートしており、Frontmatterフィールドの記入忘れという問題を回避できます。
+
+AIが本文中の日付情報を自動的に抽出・推論し、それをドキュメントの作成日として処理します。
+
+この方法はより柔軟でインテリジェントであり、ユーザー体験を向上させます。
+
+付言すると、日付を持つドキュメントは、タイムラインビューを生成することができ、閲覧や管理が容易になります。特に日記、ブログなどタイムラインが必要なコンテンツタイプに適しています。

package/.zen/src/ko-KR/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md

@@ -0,0 +1,121 @@
+---
+'title': 'Mermaid 차트 테스트 문서'
+'summary': '이 문서는 ZEN에서의 Mermaid 차트 렌더링 기능을 검증하기 위한 테스트 파일입니다. 플로우차트, 시퀀스 다이어그램, 간트 차트, 클래스 다이어그램, 상태 다이어그램, 파이 차트 등 다양한 Mermaid 차트 유형의 예시를 포함하며, 오류 메시지 표시를 확인하기 위한 잘못된 구문 테스트도 포함되어 있습니다. 이 문서는 ZEN에서 Mermaid 통합이 정상적으로 작동하는 상태를 보여주기 위한 목적을 가지고 있습니다.'
+'tags':
+  - 'Mermaid'
+  - '차트 테스트'
+  - 'ZEN'
+  - '플로우차트'
+  - '시퀀스 다이어그램'
+  - '간트 차트'
+  - '클래스 다이어그램'
+  - '상태 다이어그램'
+'inferred_date': '2024-01-01'
+'inferred_lang': 'ko-KR'
+---
+
+# Mermaid 차트 테스트
+
+이 파일은 ZEN에서의 Mermaid 차트 렌더링 기능을 검증하기 위한 테스트 파일입니다.
+
+## 플로우차트 예시
+
+```mermaid
+graph TD
+    A[시작] --> B{계속할까요?}
+    B -->|예| C[작업 실행]
+    B -->|아니오| D[종료]
+    C --> E[결과 확인]
+    E --> F{성공했나요?}
+    F -->|예| G[완료]
+    F -->|아니오| H[재시도]
+    H --> C
+    G --> D
+```
+
+## 시퀀스 다이어그램 예시
+
+```mermaid
+sequenceDiagram
+    participant User
+    participant System
+    participant Database
+
+    User->>System: 요청 제출
+    System->>Database: 데이터 조회
+    Database-->>System: 결과 반환
+    System-->>User: 결과 표시
+```
+
+## 간트 차트 예시
+
+```mermaid
+gantt
+    title 프로젝트 일정
+    dateFormat  YYYY-MM-DD
+    section 설계
+    요구사항 분석     :done,    des1, 2024-01-01, 7d
+    프로토타입 설계     :active,  des2, 2024-01-08, 5d
+    상세 설계     :         des3, after des2, 5d
+    section 개발
+    프론트엔드 개발     :         dev1, after des3, 10d
+    백엔드 개발     :         dev2, after des3, 15d
+    section 테스트
+    단위 테스트     :         test1, after dev1, 5d
+    통합 테스트     :         test2, after dev2, 5d
+```
+
+## 클래스 다이어그램 예시
+
+```mermaid
+classDiagram
+    class Animal {
+        +String name
+        +int age
+        +void eat()
+        +void sleep()
+    }
+    class Dog {
+        +void bark()
+    }
+    class Cat {
+        +void meow()
+    }
+
+    Animal <|-- Dog
+    Animal <|-- Cat
+```
+
+## 상태 다이어그램 예시
+
+```mermaid
+stateDiagram-v2
+    [*] --> Idle
+    Idle --> Processing : 처리 시작
+    Processing --> Success : 처리 성공
+    Processing --> Error : 처리 실패
+    Success --> [*]
+    Error --> [*]
+```
+
+## 파이 차트 예시
+
+```mermaid
+pie title 브라우저 사용률
+    "Chrome" : 65.2
+    "Firefox" : 15.3
+    "Safari" : 12.5
+    "Edge" : 5.2
+    "기타" : 1.8
+```
+
+## 잘못된 구문 테스트 (오류 메시지가 표시되어야 함)
+
+```mermaid
+graph TD
+    A --> B
+    // 여기에 화살표 정의가 누락됨
+    C --> D
+```
+
+이 테스트 파일은 ZEN의 Mermaid 통합이 정상적으로 작동하는지 검증하기 위해 다양한 Mermaid 차트 유형을 포함하고 있습니다.

package/.zen/src/ko-KR/579c3a203225b8b7aead541f42381de0619d8bc1d451d0d9c3267dbc74205503.md

@@ -0,0 +1,79 @@
+---
+'title': 'KaTeX 수식 표시 효과 테스트'
+'summary': '이 문서는 KaTeX 수식 표시 효과를 테스트하기 위한 예시로, E=mc^2, 적분, 도함수, 급수, 분절 함수, 표, 행렬 등 여러 인라인 및 블록 수준 수학 수식을 포함하며, 수식의 올바른 렌더링을 검증하기 위한 목적을 가집니다.'
+'tags':
+  - 'KaTeX'
+  - '수식 테스트'
+  - '수학 수식'
+  - 'LaTeX'
+  - '표시 효과'
+  - '문서 예시'
+'inferred_lang': 'ko-KR'
+---
+
+# KaTeX 수식 표시 효과 테스트
+
+이것은 인라인 수식 테스트입니다: $ E = mc^2 $.
+
+이것은 블록 수준 수식 테스트입니다:
+
+$$
+\int_a^b f(x) \, dx = F(b) - F(a)
+$$
+
+이것은 또 다른 블록 수준 수식 테스트입니다:
+
+$$
+\frac{d}{dx}e^x = e^x
+$$
+
+이것은 복잡한 수식 테스트입니다:
+
+$$
+\sum_{n=1}^{\infty} \frac{1}{n^2} = \frac{\pi^2}{6}
+$$
+
+cases를 포함한 수식 테스트:
+
+$$
+f(x) =
+\begin{cases}
+x^2 & \text{if } x \geq 0 \\
+-x & \text{if } x < 0
+\end{cases}
+$$
+
+표 수식:
+
+$$
+\begin{array}{c|c|c}
+a & b & c \\
+\hline
+1 & 2 & 3 \\
+4 & 5 & 6 \\
+\end{array}
+$$
+
+행렬 수식:
+
+$$
+\begin{pmatrix}
+1 & 2 \\
+3 & 4
+\end{pmatrix}
+$$
+
+text를 포함한 수식 테스트:
+
+$$
+E = mc^2 \quad \text{where } m \text{ is mass and
+    } c \text{ is the speed of light}
+$$
+
+일반화된 켈리 공식:
+
+$$
+f^* = \argmax_f \sum_{i \in X} P_i \ln (1 + f \cdot R_i)
+$$
+
+위의 모든 수식이 올바르게 표시되는지 확인해 주세요.

package/.zen/src/ko-KR/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md

@@ -0,0 +1,70 @@
+---
+'title': 'ZEN - 미니멀리즘 Markdown + AI 정적 사이트 빌더'
+'summary': 'ZEN은 AI를 결합한 정적 사이트 생성기로, 문서 작성과 빌드 과정을 단순화하는 데 중점을 둡니다. 사용자가 복잡한 설정 없이 git으로 관리되는 폴더에서 Markdown을 사용해 정적 HTML 사이트를 생성할 수 있으며, 모든 설정은 .zen 디렉토리 아래에 숨겨져 있습니다. 핵심 기능으로는 지능형 분류 네비게이션(AI가 내용을 분석해 사이트맵 생성), 자동 증분 번역(다국어 버전 지원, 사용자는 모국어로 작성하고 AI가 번역 처리), 그리고 최소한의 방해로 글쓰기 경험이 포함됩니다. 이 도구는 Node.js, OpenAI API 키, Git에 의존하며, 명령줄을 통해 빠르게 빌드할 수 있고 zh-Hans 및 en-US와 같은 언어 매개변수를 지정할 수 있습니다.'
+'tags':
+  - '정적 사이트 생성기'
+  - 'Markdown'
+  - 'AI'
+  - '다국어 번역'
+  - '미니멀리즘'
+  - '문서 도구'
+  - 'ZEN'
+'inferred_lang': 'ko-KR'
+---
+
+# 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 Key
+- Git 설치됨 (Git에서 Markdown 파일을 나열하고, .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`).
+- 소스 언어를 구성할 필요 없으며, ZEN이 자동으로 감지합니다.
+
+```bash
+npx zengen@latest build --lang zh-Hans --lang en-US
+```
+
+**더 많은 매개변수 또는 도움말 보기**:
+
+```bash
+npx zengen@latest
+```

package/.zen/src/ko-KR/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md

@@ -0,0 +1,71 @@
+---
+'title': 'ZEN - 미니멀리즘 Markdown + AI 정적 사이트 빌더'
+'summary': 'ZEN은 AI 기능을 결합한 정적 사이트 생성기로, 문서 작성과 사이트 구축 과정을 단순화하는 데 목적을 둡니다. 사용자가 모국어로 Markdown 콘텐츠 작성에 집중할 수 있도록 하며, 제목 생성, 카테고리 내비게이션, 증분 번역을 자동으로 처리하고 복잡한 설정 없이 다국어 버전을 지원합니다. 이 도구는 Node.js와 OpenAI API를 기반으로 하며, 명령줄을 통해 신속하게 사이트를 구축할 수 있어 효율성과 간결함을 추구하는 작가에게 적합합니다.'
+'tags':
+  - '정적 사이트 생성기'
+  - 'Markdown'
+  - 'AI'
+  - '미니멀리즘'
+  - '다국어 번역'
+  - 'Node.js'
+  - 'OpenAI'
+'inferred_lang': 'ko-KR'
+---
+
+# ZEN - 미니멀리즘 Markdown + AI 정적 사이트 빌더
+
+[> 웹사이트 데모](https://zccz14.github.io/ZEN/)
+
+## 기본 기능
+
+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 Key
+- Git 설치됨 (Git에서 Markdown 파일을 나열하고, .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`).
+- `--base-url` 매개변수로 사이트의 기본 URL 접두사를 지정할 수 있습니다 (예: GitHub Pages의 저장소 이름).
+- 소스 언어를 구성할 필요가 없으며, ZEN이 자동으로 감지합니다.
+
+```bash
+npx zengen@latest build --lang zh-Hans --lang en-US
+```
+
+**더 많은 매개변수 또는 도움말 보기**:
+
+```bash
+npx zengen@latest
+```

package/.zen/src/ko-KR/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md

@@ -0,0 +1,71 @@
+---
+'title': 'ZEN - 미니멀리스트 Markdown + AI 정적 사이트 빌더'
+'summary': 'ZEN은 AI 기능을 결합한 정적 사이트 생성기로, Markdown 문서를 위해 설계되었습니다. 사용자가 Markdown 파일을 포함하는 Git 폴더를 복잡한 설정 없이 정적 HTML 사이트로 변환할 수 있도록 하며, 모든 설정은 .zen 디렉토리에 숨겨져 있습니다. 핵심 기능으로는 지능형 분류 네비게이션(AI를 사용해 콘텐츠를 분석하여 사이트맵 생성), 자동 증분 번역(다국어 버전 지원, 사용자는 모국어로 작성하고 AI가 번역 처리), 그리고 최소한의 방해로 글쓰기 경험을 제공합니다. 빠른 시작 가이드는 Node.js 설치, OpenAI API Key 및 Git 획득을 요구하며, 명령줄을 통해 사이트를 구축하고 언어와 기본 URL을 지정할 수 있습니다.'
+'tags':
+  - '정적 사이트 생성기'
+  - 'Markdown'
+  - 'AI'
+  - '다국어 번역'
+  - '미니멀리즘'
+  - '문서 도구'
+  - 'Git'
+'inferred_lang': 'ko-KR'
+---
+
+# 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 Key
+- Git 설치됨 (Git에서 Markdown 파일을 나열하고, .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 ko-KR --lang en-US`).
+- `--base-url` 매개변수로 사이트의 기본 URL 접두사를 지정할 수 있습니다 (예: GitHub Pages의 저장소 이름).
+- 소스 언어를 구성할 필요가 없으며, ZEN이 자동으로 감지합니다.
+
+```bash
+npx zengen@latest build --lang ko-KR --lang en-US
+```
+
+**더 많은 매개변수 또는 도움말 보기**:
+
+```bash
+npx zengen@latest
+```

package/.zen/src/ko-KR/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md

@@ -0,0 +1,30 @@
+---
+'title': 'ZEN 문서 날짜 선언 사용 팁'
+'summary': '이 문서는 ZEN 도구에서 본문에 직접 날짜를 선언하는 사용 팁을 소개하며, 전통적인 Markdown의 YAML Frontmatter를 통한 날짜 선언 방식과 대비하여 ZEN의 자동 인식 및 지능형 처리 기능을 강조합니다. 이를 통해 사용자 경험을 향상시키며, 일기, 블로그 등 타임라인이 필요한 콘텐츠 유형에 적합합니다.'
+'tags':
+  - 'ZEN'
+  - '날짜 선언'
+  - 'Markdown'
+  - 'AI 처리'
+  - '타임라인'
+  - '사용자 경험'
+  - '문서 관리'
+'inferred_date': '2026-01-08'
+'inferred_lang': 'ko-KR'
+---
+
+# 사용 팁
+
+## 본문에서 날짜 선언하기
+
+본문에서 "오늘은 2026년 1월 8일입니다"와 같은 날짜 선언을 사용할 수 있습니다(형식 스타일은 자유롭습니다). ZEN이 자동으로 인식하고 처리합니다.
+
+전통적인 Markdown 문서는 YAML Frontmatter를 통해 날짜를 선언하며, 해당 필드를 기억해야 합니다. 그렇지 않으면 날짜가 올바르게 인식되지 않을 수 있습니다.
+
+ZEN은 본문에 직접 날짜를 선언하는 것을 지원하여 Frontmatter 필드 작성을 잊어버리는 문제를 방지합니다.
+
+AI는 본문의 날짜 정보를 자동으로 추출 및 추론하여 문서의 생성 날짜로 처리합니다.
+
+이 방식은 더 유연하고 지능적이며, 사용자 경험을 향상시킵니다.
+
+덧붙여, 날짜가 있는 문서는 타임라인 뷰를 생성하여 탐색 및 관리가 용이합니다. 특히 일기, 블로그 등 타임라인이 필요한 콘텐츠 유형에 적합합니다.