zengen 0.2.6 → 0.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (101) hide show
  1. package/.zen/meta.json +24 -7
  2. package/.zen/src/ar-SA/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md +121 -0
  3. package/.zen/src/ar-SA/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
  4. package/.zen/src/ar-SA/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
  5. package/.zen/src/da-DK/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md +121 -0
  6. package/.zen/src/da-DK/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
  7. package/.zen/src/da-DK/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
  8. package/.zen/src/de-DE/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md +121 -0
  9. package/.zen/src/de-DE/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
  10. package/.zen/src/de-DE/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
  11. package/.zen/src/en-US/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md +121 -0
  12. package/.zen/src/en-US/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
  13. package/.zen/src/en-US/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
  14. package/.zen/src/es-ES/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md +121 -0
  15. package/.zen/src/es-ES/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
  16. package/.zen/src/es-ES/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
  17. package/.zen/src/es-MX/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md +121 -0
  18. package/.zen/src/es-MX/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
  19. package/.zen/src/es-MX/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
  20. package/.zen/src/fi-FI/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md +121 -0
  21. package/.zen/src/fi-FI/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
  22. package/.zen/src/fi-FI/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
  23. package/.zen/src/fr-FR/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md +121 -0
  24. package/.zen/src/fr-FR/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
  25. package/.zen/src/fr-FR/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
  26. package/.zen/src/hi-IN/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md +121 -0
  27. package/.zen/src/hi-IN/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
  28. package/.zen/src/hi-IN/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
  29. package/.zen/src/id-ID/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md +121 -0
  30. package/.zen/src/id-ID/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
  31. package/.zen/src/id-ID/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
  32. package/.zen/src/it-IT/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md +121 -0
  33. package/.zen/src/it-IT/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
  34. package/.zen/src/it-IT/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
  35. package/.zen/src/ja-JP/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md +121 -0
  36. package/.zen/src/ja-JP/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
  37. package/.zen/src/ja-JP/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
  38. package/.zen/src/ko-KR/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md +121 -0
  39. package/.zen/src/ko-KR/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
  40. package/.zen/src/ko-KR/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
  41. package/.zen/src/nl-NL/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md +121 -0
  42. package/.zen/src/nl-NL/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
  43. package/.zen/src/nl-NL/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
  44. package/.zen/src/no-NO/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md +121 -0
  45. package/.zen/src/no-NO/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
  46. package/.zen/src/no-NO/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
  47. package/.zen/src/pl-PL/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md +121 -0
  48. package/.zen/src/pl-PL/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
  49. package/.zen/src/pl-PL/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
  50. package/.zen/src/pt-BR/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md +121 -0
  51. package/.zen/src/pt-BR/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
  52. package/.zen/src/pt-BR/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
  53. package/.zen/src/pt-PT/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md +121 -0
  54. package/.zen/src/pt-PT/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
  55. package/.zen/src/pt-PT/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
  56. package/.zen/src/ru-RU/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md +121 -0
  57. package/.zen/src/ru-RU/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
  58. package/.zen/src/ru-RU/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
  59. package/.zen/src/sv-SE/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md +121 -0
  60. package/.zen/src/sv-SE/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
  61. package/.zen/src/sv-SE/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
  62. package/.zen/src/th-TH/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md +121 -0
  63. package/.zen/src/th-TH/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
  64. package/.zen/src/th-TH/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
  65. package/.zen/src/tr-TR/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md +121 -0
  66. package/.zen/src/tr-TR/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
  67. package/.zen/src/tr-TR/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
  68. package/.zen/src/uk-UA/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md +121 -0
  69. package/.zen/src/uk-UA/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
  70. package/.zen/src/uk-UA/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
  71. package/.zen/src/vi-VN/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md +121 -0
  72. package/.zen/src/vi-VN/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
  73. package/.zen/src/vi-VN/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
  74. package/.zen/src/zh-Hans/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md +123 -0
  75. package/.zen/src/zh-Hans/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +74 -0
  76. package/.zen/src/zh-Hans/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +75 -0
  77. package/.zen/src/zh-Hant/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md +123 -0
  78. package/.zen/src/zh-Hant/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
  79. package/.zen/src/zh-Hant/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
  80. package/README.md +1 -2
  81. package/assets/templates/default/layout.html +82 -0
  82. package/dist/build/pipeline.d.ts.map +1 -1
  83. package/dist/build/pipeline.js +0 -1
  84. package/dist/build/pipeline.js.map +1 -1
  85. package/dist/cli.js +0 -2
  86. package/dist/cli.js.map +1 -1
  87. package/dist/process/template.d.ts.map +1 -1
  88. package/dist/process/template.js +3 -4
  89. package/dist/process/template.js.map +1 -1
  90. package/dist/types.d.ts +0 -1
  91. package/dist/types.d.ts.map +1 -1
  92. package/dist/utils/convertMarkdownToHtml.d.ts.map +1 -1
  93. package/dist/utils/convertMarkdownToHtml.js +75 -22
  94. package/dist/utils/convertMarkdownToHtml.js.map +1 -1
  95. package/docs/test-mermaid.md +105 -0
  96. package/package.json +2 -2
  97. package/src/build/pipeline.ts +0 -1
  98. package/src/cli.ts +0 -2
  99. package/src/process/template.ts +3 -9
  100. package/src/types.ts +0 -1
  101. package/src/utils/convertMarkdownToHtml.ts +80 -21
@@ -0,0 +1,70 @@
1
+ ---
2
+ 'title': 'ZEN - 極簡主義 Markdown + AI 静的サイトビルダー'
3
+ 'summary': 'ZENはAIを組み合わせた静的サイトジェネレーターで、ドキュメント作成とビルドプロセスの簡素化に焦点を当てています。ユーザーはgit管理フォルダ内でMarkdownを使用して静的HTMLサイトを作成でき、複雑な設定は不要で、すべての設定は.zenディレクトリに隠されています。中核機能には、インテリジェント分類ナビゲーション(AIによるコンテンツ分析でサイトマップを生成)、自動インクリメンタル翻訳(多言語バージョンをサポート、ユーザーは母国語で執筆し、AIが翻訳を処理)、および最小限の邪魔で執筆体験を提供します。ツールはNode.js、OpenAI API Key、Gitに依存し、コマンドラインから迅速にビルドでき、zh-Hansやen-USなどの言語パラメータの指定をサポートします。'
4
+ 'tags':
5
+ - '静的サイトジェネレーター'
6
+ - 'Markdown'
7
+ - 'AI'
8
+ - '多言語翻訳'
9
+ - '極簡主義'
10
+ - 'ドキュメントツール'
11
+ - 'ZEN'
12
+ 'inferred_lang': 'zh-Hans'
13
+ ---
14
+
15
+ # ZEN - 極簡主義 Markdown + AI 静的サイトビルダー
16
+
17
+ [> ウェブサイトデモ](https://zen.zccz14.com/)
18
+
19
+ ## 基本機能
20
+
21
+ 1. 📃 **静的サイト生成**:Markdownを含む任意のgitフォルダを静的HTMLサイトに構築します。
22
+ 2. 🧭 **インテリジェント分類ナビゲーション**:AIを使用してコンテンツを分析し、サイトマップとナビゲーションを生成します。ソースファイルの位置に依存しません。
23
+ 3. 🌍 **自動インクリメンタル翻訳**:AIを使用してインクリメンタル翻訳を行い、ユーザーが母国語でMarkdownを執筆しながら、多言語対応を可能にします。
24
+
25
+ なぜまたMarkdown静的サイトジェネレーターを作ったのか?AI時代において、ドキュメントツールが書き手により良くどのように奉仕できるか、私は再考しました:
26
+
27
+ - コンテンツへの回帰:最小限の邪魔で、執筆に集中
28
+
29
+ ドキュメントを本質に戻し、執筆を静寂に戻します。
30
+
31
+ 第一に、私は図書館司書になりたくありません。時々何かを書き留めたいと思うことがありますが、タイトルがまだ決まっていなかったり、特別な構成ができていなかったりすることがあります。LLMが自動的にタイトルを生成し、要約、分類、ナビゲーションなどの整理作業をしてくれることを望みます。
32
+
33
+ 第二に、私の書斎はきれいに掃除されていなければなりません。複雑な設定のビルドツールや、複雑なドキュメント設定、複雑な構造をいじるのは好きではありません。Docusaurus、VuePress、Astroといったツールの設定ファイルやプロジェクト構造を見るたびに、頭が痛くなります。現在、ZENはすべての設定を.zenディレクトリに隠し、隅に掃き出すことを選択しました。ユーザーは執筆コンテンツに集中するだけでよく、他のことはZENが処理します。他のディレクトリはすべてあなたの執筆スペースであり、Markdownファイルを自由に整理できます。
34
+
35
+ - 母国語への回帰:母国語で執筆し、滑らかに多言語バージョンを構築
36
+
37
+ 人生は短いので、翻訳は面倒です。人は母国語を使用するとき、自身の思考の深さを最も発揮できます。しかし同時に、世界とつながりを保つことも必要であり、多言語でのコミュニケーションを諦めたくはありません。そこで私は、母国語で執筆しながら、より多くの人に私のコンテンツを見てもらえるツールを望みました。現在のi18nは自分で翻訳するだけでなく、コンテンツの更新も自分でメンテナンスしなければならず、非常に面倒です。私はLLMを使って翻訳を手伝ってもらうことを選択し、多くの時間を節約し、ワンクリックで複数言語への翻訳を完了できます。
38
+
39
+ ## クイックスタート
40
+
41
+ 前提条件:
42
+
43
+ - [Node.js](https://nodejs.org/)がインストール済み(バージョン18以上を推奨、npxコマンドが必要)
44
+ - [OpenAI API Key](https://platform.openai.com/account/api-keys)を取得済み、またはOpenAI互換のAPI Key
45
+ - Gitがインストール済み(GitからMarkdownファイルをリストし、.gitignoreルールでフィルタリングされたファイルを無視するため)
46
+
47
+ まず、git管理下のフォルダで作業します:
48
+
49
+ 環境変数を設定します
50
+
51
+ ```bash
52
+ export OPENAI_API_KEY="sk-xxxxxx" # 必須:あなたのOpenAI API Keyに置き換えてください
53
+ export OPENAI_BASE_URL="https://api.openai.com/v1" # オプション、デフォルトはOpenAI公式APIを使用
54
+ export OPENAI_MODEL="gpt-3.5-turbo" # オプション、デフォルトはgpt-3.5-turboモデルを使用
55
+ ```
56
+
57
+ サイトを構築し、多言語翻訳をサポートします。現在のディレクトリをソースディレクトリとして使用し、`.zen/dist`ディレクトリに出力します。
58
+
59
+ - `--lang`パラメータを複数回使用して、生成する言語バージョンを指定できます(例:`--lang zh-Hans --lang en-US`)。
60
+ - ソース言語の設定は不要で、ZENが自動的に検出します。
61
+
62
+ ```bash
63
+ npx zengen@latest build --lang zh-Hans --lang en-US
64
+ ```
65
+
66
+ **その他のパラメータやヘルプを表示**:
67
+
68
+ ```bash
69
+ npx zengen@latest
70
+ ```
@@ -0,0 +1,71 @@
1
+ ---
2
+ 'title': 'ZEN - 極簡主義 Markdown + AI 静的サイトビルダー'
3
+ 'summary': 'ZENはAI機能を統合した静的サイトジェネレーターで、Markdown文書専用に設計されています。Gitで管理されたMarkdownファイルを含むフォルダを、複雑な設定なしに静的HTMLサイトへ変換でき、全ての設定は.zenディレクトリ内に隠蔽されます。中核機能には、インテリジェントな分類ナビゲーション(AIによるコンテンツ分析を用いたサイトマップ生成)、自動インクリメンタル翻訳(多言語バージョンをサポート。ユーザーは母国語で執筆し、AIが翻訳を処理)、そして最小限の邪魔で執筆に集中できる体験が含まれます。クイックスタートガイドでは、Node.jsのインストール、OpenAI APIキーの取得、Gitの準備が必要で、コマンドラインからサイトを構築し、言語とベースURLの指定をサポートします。'
4
+ 'tags':
5
+ - '静的サイトジェネレーター'
6
+ - 'Markdown'
7
+ - 'AI'
8
+ - '多言語翻訳'
9
+ - '極簡主義'
10
+ - '文書ツール'
11
+ - 'Git'
12
+ 'inferred_lang': 'zh-Hans'
13
+ ---
14
+
15
+ # ZEN - 極簡主義 Markdown + AI 静的サイトビルダー
16
+
17
+ [> ウェブサイトデモ](https://zen.zccz14.com/)
18
+
19
+ ## 基本機能
20
+
21
+ 1. 📃 **静的サイト生成**:Markdownを含む任意のgitフォルダを静的HTMLサイトに構築します。
22
+ 2. 🧭 **インテリジェント分類ナビゲーション**:AIによるコンテンツ分析を用いて、サイトマップとナビゲーションを生成します。ソースファイルの物理的な位置に依存しません。
23
+ 3. 🌍 **自動インクリメンタル翻訳**:AIによるインクリメンタル翻訳を利用し、ユーザーは母国語でMarkdownを執筆しながら、多言語での公開が可能になります。
24
+
25
+ なぜまたMarkdown静的サイトジェネレーターを作ったのか?AI時代において、文書ツールが書き手により良くどのように奉仕できるか、私は再考しました:
26
+
27
+ - コンテンツへの回帰:最小限の邪魔で、執筆に集中
28
+
29
+ 文書の本質に立ち返り、静かな執筆環境を取り戻します。
30
+
31
+ 第一に、私は図書館司書になりたくありません。時々何かを書き留めたいと思うことがありますが、まだタイトルが決まっていなかったり、明確な構成ができていなかったりします。LLMが自動的にタイトルを生成し、要約、分類、ナビゲーションなどの整理作業をしてくれることを望みます。
32
+
33
+ 第二に、私の書斎はきれいに掃除されていなければなりません。複雑な設定ファイルを持つビルドツールや、複雑な文書構成をいじるのは好きではありません。Docusaurus、VuePress、Astroといったツールの設定ファイルやプロジェクト構造を見るたびに、頭が痛くなります。現在、ZENは全ての設定を.zenディレクトリに隠し、隅に追いやることを選択しました。ユーザーは執筆コンテンツに集中するだけでよく、残りはZENが処理します。他のディレクトリはすべてあなたの執筆スペースであり、Markdownファイルを自由に整理できます。
34
+
35
+ - 母国語への回帰:母国語で執筆し、滑らかに多言語バージョンを構築
36
+
37
+ 人生は短い、私は翻訳するのが面倒です。人は母国語を使用するとき、自身の思考の深みを最も発揮できます。しかし同時に、世界と繋がり続けることも必要であり、多言語でのコミュニケーションを諦めたくはありません。そこで私は、母国語で執筆しながら、より多くの人々に私のコンテンツを見てもらえるツールを望みました。現在のi18nは自分で翻訳するだけでなく、コンテンツの更新も自分で管理しなければならず、非常に面倒です。私はLLMを使って翻訳を手伝ってもらうことを選択し、多くの時間を節約し、ワンクリックで多国語翻訳を完了できます。
38
+
39
+ ## クイックスタート
40
+
41
+ 前提条件:
42
+
43
+ - [Node.js](https://nodejs.org/) がインストール済み(バージョン18以上を推奨、npxコマンドが必要)
44
+ - [OpenAI API Key](https://platform.openai.com/account/api-keys) を取得済み、または OpenAI 互換の API Key を所持
45
+ - Git がインストール済み(GitからMarkdownファイルをリストアップし、.gitignoreルールでフィルタリングされたファイルを無視するために使用)
46
+
47
+ まず、既にgitで管理されているフォルダ内で作業します:
48
+
49
+ 環境変数を設定します
50
+
51
+ ```bash
52
+ export OPENAI_API_KEY="sk-xxxxxx" # 必須:ご自身のOpenAI API Keyに置き換えてください
53
+ export OPENAI_BASE_URL="https://api.openai.com/v1" # オプション、デフォルトはOpenAI公式APIを使用
54
+ export OPENAI_MODEL="gpt-3.5-turbo" # オプション、デフォルトはgpt-3.5-turboモデルを使用
55
+ ```
56
+
57
+ サイトを構築します。多言語翻訳をサポートします。現在のディレクトリをソースディレクトリとして使用し、`.zen/dist`ディレクトリに出力します。
58
+
59
+ - `--lang` パラメータを複数回使用して、生成する言語バージョンを指定できます(例:`--lang zh-Hans --lang en-US`)。
60
+ - `--base-url` パラメータで、サイトのベースURLプレフィックスを指定できます(例:GitHub Pages上のリポジトリ名)。
61
+ - ソース言語の設定は不要です。ZENが自動的に検出します。
62
+
63
+ ```bash
64
+ npx zengen@latest build --lang zh-Hans --lang en-US
65
+ ```
66
+
67
+ **その他のパラメータやヘルプを表示する**:
68
+
69
+ ```bash
70
+ npx zengen@latest
71
+ ```
@@ -0,0 +1,121 @@
1
+ ---
2
+ 'title': 'Mermaid 차트 테스트 문서'
3
+ 'summary': '이 문서는 ZEN에서의 Mermaid 차트 렌더링 기능을 검증하기 위한 테스트 파일입니다. 플로우차트, 시퀀스 다이어그램, 간트 차트, 클래스 다이어그램, 상태 다이어그램, 파이 차트 등 다양한 Mermaid 차트 유형의 예시를 포함하며, 오류 메시지 표시를 확인하기 위한 잘못된 구문 테스트도 포함되어 있습니다. 이 문서는 ZEN에서 Mermaid 통합이 정상적으로 작동하는 상태를 보여주기 위한 목적을 가지고 있습니다.'
4
+ 'tags':
5
+ - 'Mermaid'
6
+ - '차트 테스트'
7
+ - 'ZEN'
8
+ - '플로우차트'
9
+ - '시퀀스 다이어그램'
10
+ - '간트 차트'
11
+ - '클래스 다이어그램'
12
+ - '상태 다이어그램'
13
+ 'inferred_date': '2024-01-01'
14
+ 'inferred_lang': 'ko-KR'
15
+ ---
16
+
17
+ # Mermaid 차트 테스트
18
+
19
+ 이 파일은 ZEN에서의 Mermaid 차트 렌더링 기능을 검증하기 위한 테스트 파일입니다.
20
+
21
+ ## 플로우차트 예시
22
+
23
+ ```mermaid
24
+ graph TD
25
+ A[시작] --> B{계속할까요?}
26
+ B -->|예| C[작업 실행]
27
+ B -->|아니오| D[종료]
28
+ C --> E[결과 확인]
29
+ E --> F{성공했나요?}
30
+ F -->|예| G[완료]
31
+ F -->|아니오| H[재시도]
32
+ H --> C
33
+ G --> D
34
+ ```
35
+
36
+ ## 시퀀스 다이어그램 예시
37
+
38
+ ```mermaid
39
+ sequenceDiagram
40
+ participant User
41
+ participant System
42
+ participant Database
43
+
44
+ User->>System: 요청 제출
45
+ System->>Database: 데이터 조회
46
+ Database-->>System: 결과 반환
47
+ System-->>User: 결과 표시
48
+ ```
49
+
50
+ ## 간트 차트 예시
51
+
52
+ ```mermaid
53
+ gantt
54
+ title 프로젝트 일정
55
+ dateFormat YYYY-MM-DD
56
+ section 설계
57
+ 요구사항 분석 :done, des1, 2024-01-01, 7d
58
+ 프로토타입 설계 :active, des2, 2024-01-08, 5d
59
+ 상세 설계 : des3, after des2, 5d
60
+ section 개발
61
+ 프론트엔드 개발 : dev1, after des3, 10d
62
+ 백엔드 개발 : dev2, after des3, 15d
63
+ section 테스트
64
+ 단위 테스트 : test1, after dev1, 5d
65
+ 통합 테스트 : test2, after dev2, 5d
66
+ ```
67
+
68
+ ## 클래스 다이어그램 예시
69
+
70
+ ```mermaid
71
+ classDiagram
72
+ class Animal {
73
+ +String name
74
+ +int age
75
+ +void eat()
76
+ +void sleep()
77
+ }
78
+ class Dog {
79
+ +void bark()
80
+ }
81
+ class Cat {
82
+ +void meow()
83
+ }
84
+
85
+ Animal <|-- Dog
86
+ Animal <|-- Cat
87
+ ```
88
+
89
+ ## 상태 다이어그램 예시
90
+
91
+ ```mermaid
92
+ stateDiagram-v2
93
+ [*] --> Idle
94
+ Idle --> Processing : 처리 시작
95
+ Processing --> Success : 처리 성공
96
+ Processing --> Error : 처리 실패
97
+ Success --> [*]
98
+ Error --> [*]
99
+ ```
100
+
101
+ ## 파이 차트 예시
102
+
103
+ ```mermaid
104
+ pie title 브라우저 사용률
105
+ "Chrome" : 65.2
106
+ "Firefox" : 15.3
107
+ "Safari" : 12.5
108
+ "Edge" : 5.2
109
+ "기타" : 1.8
110
+ ```
111
+
112
+ ## 잘못된 구문 테스트 (오류 메시지가 표시되어야 함)
113
+
114
+ ```mermaid
115
+ graph TD
116
+ A --> B
117
+ // 여기에 화살표 정의가 누락됨
118
+ C --> D
119
+ ```
120
+
121
+ 이 테스트 파일은 ZEN의 Mermaid 통합이 정상적으로 작동하는지 검증하기 위해 다양한 Mermaid 차트 유형을 포함하고 있습니다.
@@ -0,0 +1,70 @@
1
+ ---
2
+ 'title': 'ZEN - 미니멀리즘 Markdown + AI 정적 사이트 빌더'
3
+ 'summary': 'ZEN은 AI를 결합한 정적 사이트 생성기로, 문서 작성과 빌드 과정을 단순화하는 데 중점을 둡니다. 사용자가 복잡한 설정 없이 git으로 관리되는 폴더에서 Markdown을 사용해 정적 HTML 사이트를 생성할 수 있으며, 모든 설정은 .zen 디렉토리 아래에 숨겨져 있습니다. 핵심 기능으로는 지능형 분류 네비게이션(AI가 내용을 분석해 사이트맵 생성), 자동 증분 번역(다국어 버전 지원, 사용자는 모국어로 작성하고 AI가 번역 처리), 그리고 최소한의 방해로 글쓰기 경험이 포함됩니다. 이 도구는 Node.js, OpenAI API 키, Git에 의존하며, 명령줄을 통해 빠르게 빌드할 수 있고 zh-Hans 및 en-US와 같은 언어 매개변수를 지정할 수 있습니다.'
4
+ 'tags':
5
+ - '정적 사이트 생성기'
6
+ - 'Markdown'
7
+ - 'AI'
8
+ - '다국어 번역'
9
+ - '미니멀리즘'
10
+ - '문서 도구'
11
+ - 'ZEN'
12
+ 'inferred_lang': 'ko-KR'
13
+ ---
14
+
15
+ # ZEN - 미니멀리즘 Markdown + AI 정적 사이트 빌더
16
+
17
+ [> 웹사이트 데모](https://zen.zccz14.com/)
18
+
19
+ ## 기본 기능
20
+
21
+ 1. 📃 **정적 사이트 생성**: Markdown이 포함된 git 폴더를 정적 HTML 사이트로 빌드합니다.
22
+ 2. 🧭 **지능형 분류 네비게이션**: AI를 사용해 내용을 분석하고 사이트맵과 네비게이션을 생성하며, 원본 파일의 위치에 민감하지 않습니다.
23
+ 3. 🌍 **자동 증분 번역**: AI를 사용해 증분 번역을 수행하여 사용자가 모국어로 Markdown을 작성하지만, 다국어로 제공될 수 있도록 합니다.
24
+
25
+ 왜 또 다른 Markdown 정적 사이트 생성기를 만들었을까요? AI 시대에 문서 도구가 작가에게 어떻게 더 잘 서비스할 수 있는지 다시 생각해보았습니다:
26
+
27
+ - 내용으로의 회귀: 최소한의 방해로 집중해서 글쓰기
28
+
29
+ 문서의 본질로 돌아가고, 글쓰기의 평온함으로 돌아갑니다.
30
+
31
+ 첫째, 저는 도서관 사서가 되고 싶지 않습니다. 때로는 내용을 적고 싶지만, 아직 제목을 정하지 못했거나 특별한 체계를 형성하지 못한 경우가 있습니다. LLM이 자동으로 제목을 생성하고, 요약, 분류, 네비게이션 등의 정리 작업을 해주길 바랍니다.
32
+
33
+ 둘째, 제 서재는 반드시 깨끗해야 합니다. 복잡한 구성의 빌드 도구를 설정하고, 복잡한 문서 구성을 다루는 것을 원하지 않으며, 복잡한 구조를 좋아하지 않습니다. Docusaurus, VuePress, Astro 같은 도구들의 설정 파일과 프로젝트 구조를 볼 때마다 두통이 옵니다. 이제 ZEN은 모든 구성을 .zen 디렉토리 아래에 숨기고 구석으로 치워, 사용자는 글쓰기 내용에만 집중하고 나머지는 ZEN이 처리하도록 했습니다. 다른 디렉토리들은 여러분의 글쓰기 공간이며, Markdown 파일을 자유롭게 구성할 수 있습니다.
34
+
35
+ - 모국어로의 회귀: 모국어로 글쓰고, 부드럽게 다국어 버전 빌드하기
36
+
37
+ 인생은 짧고, 저는 번역하기가 귀찮습니다. 사람은 모국어를 사용할 때 가장 깊이 생각할 수 있습니다. 하지만 동시에 세계와 연결을 유지하는 것도 필요하며, 다국어 소통을 포기하고 싶지 않습니다. 그래서 저는 모국어로 글을 쓰면서도 더 많은 사람들이 제 내용을 볼 수 있도록 해주는 도구를 원했습니다. 현재의 i18n은 직접 번역해야 할 뿐만 아니라 내용 업데이트도 직접 관리해야 해서 너무 번거롭습니다. 저는 LLM을 사용해 번역을 도와주도록 선택하여 많은 시간을 절약하고, 한 번의 클릭으로 다국어 번역을 완료할 수 있습니다.
38
+
39
+ ## 빠른 시작
40
+
41
+ 필수 조건:
42
+
43
+ - [Node.js](https://nodejs.org/) 설치됨 (버전 18 이상 권장, npx 명령어 필요)
44
+ - [OpenAI API Key](https://platform.openai.com/account/api-keys) 획득, 또는 OPENAI 호환 API Key
45
+ - Git 설치됨 (Git에서 Markdown 파일을 나열하고, .gitignore 규칙으로 필터링된 파일을 무시하기 위해)
46
+
47
+ 먼저, git으로 관리되는 폴더에서 작업합니다:
48
+
49
+ 환경 변수 설정
50
+
51
+ ```bash
52
+ export OPENAI_API_KEY="sk-xxxxxx" # 필수: 귀하의 OpenAI API Key로 교체하세요
53
+ export OPENAI_BASE_URL="https://api.openai.com/v1" # 선택 사항, 기본값은 OpenAI 공식 API 사용
54
+ export OPENAI_MODEL="gpt-3.5-turbo" # 선택 사항, 기본값은 gpt-3.5-turbo 모델 사용
55
+ ```
56
+
57
+ 사이트 빌드, 다국어 번역 지원. 현재 디렉토리를 소스 디렉토리로 사용하고, `.zen/dist` 디렉토리에 출력합니다.
58
+
59
+ - `--lang` 매개변수를 여러 번 사용하여 생성할 언어 버전을 지정할 수 있습니다 (예: `--lang zh-Hans --lang en-US`).
60
+ - 소스 언어를 구성할 필요 없으며, ZEN이 자동으로 감지합니다.
61
+
62
+ ```bash
63
+ npx zengen@latest build --lang zh-Hans --lang en-US
64
+ ```
65
+
66
+ **더 많은 매개변수 또는 도움말 보기**:
67
+
68
+ ```bash
69
+ npx zengen@latest
70
+ ```
@@ -0,0 +1,71 @@
1
+ ---
2
+ 'title': 'ZEN - 미니멀리스트 Markdown + AI 정적 사이트 빌더'
3
+ 'summary': 'ZEN은 AI 기능을 결합한 정적 사이트 생성기로, Markdown 문서를 위해 설계되었습니다. 사용자가 Markdown 파일을 포함하는 Git 폴더를 복잡한 설정 없이 정적 HTML 사이트로 변환할 수 있도록 하며, 모든 설정은 .zen 디렉토리에 숨겨져 있습니다. 핵심 기능으로는 지능형 분류 네비게이션(AI를 사용해 콘텐츠를 분석하여 사이트맵 생성), 자동 증분 번역(다국어 버전 지원, 사용자는 모국어로 작성하고 AI가 번역 처리), 그리고 최소한의 방해로 글쓰기 경험을 제공합니다. 빠른 시작 가이드는 Node.js 설치, OpenAI API Key 및 Git 획득을 요구하며, 명령줄을 통해 사이트를 구축하고 언어와 기본 URL을 지정할 수 있습니다.'
4
+ 'tags':
5
+ - '정적 사이트 생성기'
6
+ - 'Markdown'
7
+ - 'AI'
8
+ - '다국어 번역'
9
+ - '미니멀리즘'
10
+ - '문서 도구'
11
+ - 'Git'
12
+ 'inferred_lang': 'ko-KR'
13
+ ---
14
+
15
+ # ZEN - 미니멀리스트 Markdown + AI 정적 사이트 빌더
16
+
17
+ [> 웹사이트 데모](https://zen.zccz14.com/)
18
+
19
+ ## 기본 기능
20
+
21
+ 1. 📃 **정적 사이트 생성**: Markdown을 포함하는 임의의 git 폴더를 정적 HTML 사이트로 구축합니다.
22
+ 2. 🧭 **지능형 분류 네비게이션**: AI를 사용해 콘텐츠를 분석하여 사이트맵과 네비게이션을 생성하며, 소스 파일의 위치에 민감하지 않습니다.
23
+ 3. 🌍 **자동 증분 번역**: AI를 사용한 증분 번역으로, 사용자가 모국어로 Markdown을 작성하지만 다국어 사용자가 될 수 있도록 합니다.
24
+
25
+ 왜 또 다른 Markdown 정적 사이트 생성기를 만들었을까요? AI 시대에 문서 도구가 작가에게 어떻게 더 잘 서비스할 수 있는지 다시 생각해보았습니다:
26
+
27
+ - 콘텐츠로의 회귀: 최소한의 방해로 집중하여 글쓰기
28
+
29
+ 문서의 본질로 돌아가고, 글쓰기의 평온함으로 돌아갑니다.
30
+
31
+ 첫째, 나는 도서관 사서가 되고 싶지 않습니다. 때로는 어떤 내용을 적고 싶지만, 아직 제목을 정하지 못했거나 특별한 조직을 형성하지 못한 경우가 있습니다. LLM이 자동으로 제목을 생성하고, 요약, 분류, 네비게이션 등의 정리 작업을 해주길 바랍니다.
32
+
33
+ 둘째, 내 서재는 반드시 깨끗해야 합니다. 복잡한 구성 도구를 설정하거나, 복잡한 문서 구성을 꾸미는 것을 원하지 않으며, 복잡한 구조를 좋아하지 않습니다. Docusaurus, VuePress, Astro와 같은 도구들의 구성 파일과 프로젝트 구조를 볼 때마다 두통이 옵니다. 이제 ZEN은 모든 구성을 .zen 디렉토리에 숨겨 구석으로 치우기로 선택했습니다. 사용자는 글쓰기 콘텐츠에만 집중하면 되며, 나머지는 ZEN이 처리합니다. 다른 디렉토리는 모두 여러분의 글쓰기 공간이며, Markdown 파일을 자유롭게 구성할 수 있습니다.
34
+
35
+ - 모국어로의 회귀: 모국어로 글쓰기, 부드러운 다국어 버전 구축
36
+
37
+ 인생은 짧아서, 나는 번역하기가 귀찮습니다. 사람은 모국어를 사용할 때 가장 깊이 생각할 수 있습니다. 하지만 동시에 세계와의 연결을 유지하는 것도 필요하며, 다국어 소통을 포기하고 싶지 않습니다. 그래서 나는 모국어로 글을 쓰면서도 더 많은 사람들이 내 콘텐츠를 볼 수 있도록 해주는 도구를 원했습니다. 현재의 i18n은 직접 번역해야 할 뿐만 아니라 콘텐츠 업데이트도 직접 관리해야 해서 너무 번거롭습니다. 나는 LLM을 사용해 번역을 도와주도록 선택하여 많은 시간을 절약하고, 한 번의 클릭으로 여러 국가 언어 번역을 완료할 수 있습니다.
38
+
39
+ ## 빠른 시작
40
+
41
+ 필수 조건:
42
+
43
+ - [Node.js](https://nodejs.org/) 설치됨 (버전 18 이상 권장, npx 명령 필요)
44
+ - [OpenAI API Key](https://platform.openai.com/account/api-keys) 획득, 또는 OPENAI 호환 API Key
45
+ - Git 설치됨 (Git에서 Markdown 파일을 나열하고, .gitignore 규칙으로 필터링된 파일을 무시하기 위해)
46
+
47
+ 먼저, git으로 관리되는 폴더에서 작업하세요:
48
+
49
+ 환경 변수 설정
50
+
51
+ ```bash
52
+ export OPENAI_API_KEY="sk-xxxxxx" # 필수: 귀하의 OpenAI API Key로 교체하세요
53
+ export OPENAI_BASE_URL="https://api.openai.com/v1" # 선택 사항, 기본적으로 OpenAI 공식 API 사용
54
+ export OPENAI_MODEL="gpt-3.5-turbo" # 선택 사항, 기본적으로 gpt-3.5-turbo 모델 사용
55
+ ```
56
+
57
+ 사이트 구축, 다국어 번역 지원. 현재 디렉토리를 소스 디렉토리로 사용하고, `.zen/dist` 디렉토리에 출력합니다.
58
+
59
+ - `--lang` 매개변수를 여러 번 사용하여 생성할 언어 버전을 지정할 수 있습니다 (예: `--lang ko-KR --lang en-US`).
60
+ - `--base-url` 매개변수로 사이트의 기본 URL 접두사를 지정할 수 있습니다 (예: GitHub Pages의 저장소 이름).
61
+ - 소스 언어를 구성할 필요가 없으며, ZEN이 자동으로 감지합니다.
62
+
63
+ ```bash
64
+ npx zengen@latest build --lang ko-KR --lang en-US
65
+ ```
66
+
67
+ **더 많은 매개변수 또는 도움말 보기**:
68
+
69
+ ```bash
70
+ npx zengen@latest
71
+ ```
@@ -0,0 +1,121 @@
1
+ ---
2
+ 'title': 'Mermaid Diagram Testdocument'
3
+ 'summary': 'Dit document is een testbestand om de Mermaid-diagramweergavefunctionaliteit in ZEN te valideren. Het bevat voorbeelden van verschillende Mermaid-diagramtypen, zoals stroomdiagrammen, sequentiediagrammen, Gantt-diagrammen, klassendiagrammen, toestandsdiagrammen en taartdiagrammen, en omvat een test met foutieve syntaxis om de foutmeldingweergave te controleren. Het document is bedoeld om de correcte werking van de Mermaid-integratie in ZEN te demonstreren.'
4
+ 'tags':
5
+ - 'Mermaid'
6
+ - 'Diagramtest'
7
+ - 'ZEN'
8
+ - 'Stroomdiagram'
9
+ - 'Sequentiediagram'
10
+ - 'Gantt-diagram'
11
+ - 'Klassendiagram'
12
+ - 'Toestandsdiagram'
13
+ 'inferred_date': '2024-01-01'
14
+ 'inferred_lang': 'nl-NL'
15
+ ---
16
+
17
+ # Mermaid Diagram Test
18
+
19
+ Dit is een testbestand om de Mermaid-diagramweergavefunctionaliteit in ZEN te valideren.
20
+
21
+ ## Stroomdiagram Voorbeeld
22
+
23
+ ```mermaid
24
+ graph TD
25
+ A[Start] --> B{Doorgaan?}
26
+ B -->|Ja| C[Voer actie uit]
27
+ B -->|Nee| D[Einde]
28
+ C --> E[Controleer resultaat]
29
+ E --> F{Succesvol?}
30
+ F -->|Ja| G[Voltooid]
31
+ F -->|Nee| H[Opnieuw proberen]
32
+ H --> C
33
+ G --> D
34
+ ```
35
+
36
+ ## Sequentiediagram Voorbeeld
37
+
38
+ ```mermaid
39
+ sequenceDiagram
40
+ participant Gebruiker
41
+ participant Systeem
42
+ participant Database
43
+
44
+ Gebruiker->>Systeem: Verzoek indienen
45
+ Systeem->>Database: Gegevens opvragen
46
+ Database-->>Systeem: Resultaat teruggeven
47
+ Systeem-->>Gebruiker: Resultaat tonen
48
+ ```
49
+
50
+ ## Gantt-diagram Voorbeeld
51
+
52
+ ```mermaid
53
+ gantt
54
+ title Projecttijdlijn
55
+ dateFormat YYYY-MM-DD
56
+ section Ontwerp
57
+ Behoefteanalyse :done, des1, 2024-01-01, 7d
58
+ Prototypeontwerp :active, des2, 2024-01-08, 5d
59
+ Gedetailleerd ontwerp : des3, after des2, 5d
60
+ section Ontwikkeling
61
+ Frontend ontwikkeling : dev1, after des3, 10d
62
+ Backend ontwikkeling : dev2, after des3, 15d
63
+ section Testen
64
+ Unittesten : test1, after dev1, 5d
65
+ Integratietesten : test2, after dev2, 5d
66
+ ```
67
+
68
+ ## Klassendiagram Voorbeeld
69
+
70
+ ```mermaid
71
+ classDiagram
72
+ class Dier {
73
+ +String naam
74
+ +int leeftijd
75
+ +void eet()
76
+ +void slaap()
77
+ }
78
+ class Hond {
79
+ +void blaf()
80
+ }
81
+ class Kat {
82
+ +void miauw()
83
+ }
84
+
85
+ Dier <|-- Hond
86
+ Dier <|-- Kat
87
+ ```
88
+
89
+ ## Toestandsdiagram Voorbeeld
90
+
91
+ ```mermaid
92
+ stateDiagram-v2
93
+ [*] --> Inactief
94
+ Inactief --> Verwerken : Start verwerking
95
+ Verwerken --> Succes : Verwerking geslaagd
96
+ Verwerken --> Fout : Verwerking mislukt
97
+ Succes --> [*]
98
+ Fout --> [*]
99
+ ```
100
+
101
+ ## Taartdiagram Voorbeeld
102
+
103
+ ```mermaid
104
+ pie title Browsergebruik
105
+ "Chrome" : 65.2
106
+ "Firefox" : 15.3
107
+ "Safari" : 12.5
108
+ "Edge" : 5.2
109
+ "Overig" : 1.8
110
+ ```
111
+
112
+ ## Foutieve Syntaxis Test (moet foutmelding tonen)
113
+
114
+ ```mermaid
115
+ graph TD
116
+ A --> B
117
+ // Hier ontbreekt pijldefinitie
118
+ C --> D
119
+ ```
120
+
121
+ Dit testbestand bevat verschillende Mermaid-diagramtypen om te valideren of de Mermaid-integratie in ZEN correct werkt.
@@ -0,0 +1,70 @@
1
+ ---
2
+ 'title': 'ZEN - Minimalistische Markdown + AI Statische Site Bouwer'
3
+ 'summary': 'ZEN is een statische site generator gecombineerd met AI, gericht op het vereenvoudigen van het documentatie schrijf- en bouwproces. Het stelt gebruikers in staat om statische HTML-sites te maken in git-beheerde mappen met behulp van Markdown, zonder complexe configuratie; alle instellingen zijn verborgen in de .zen map. Kernfuncties omvatten intelligente categorisatie en navigatie (via AI-analyse van inhoud om een sitemap te genereren), automatische incrementele vertaling (ondersteunt meertalige versies, gebruikers kunnen in hun moedertaal schrijven, AI verwerkt de vertaling), en een minimale schrijfonderbreking ervaring. De tool vereist Node.js, een OpenAI API Key en Git, bouwt snel via de command line, en ondersteunt het specificeren van taalparameters zoals zh-Hans en en-US.'
4
+ 'tags':
5
+ - 'Statische Site Generator'
6
+ - 'Markdown'
7
+ - 'AI'
8
+ - 'Meertalige Vertaling'
9
+ - 'Minimalisme'
10
+ - 'Documentatie Tool'
11
+ - 'ZEN'
12
+ 'inferred_lang': 'zh-Hans'
13
+ ---
14
+
15
+ # ZEN - Minimalistische Markdown + AI Statische Site Bouwer
16
+
17
+ [> Website Demo](https://zen.zccz14.com/)
18
+
19
+ ## Basisfunctionaliteiten
20
+
21
+ 1. 📃 **Statische Site Generatie**: Bouw een willekeurige git-map met Markdown-bestanden om tot een statische HTML-site.
22
+ 2. 🧭 **Intelligente Categorisatie en Navigatie**: Gebruik AI voor inhoudsanalyse om een sitemap en navigatie te genereren, ongeacht de locatie van de bronbestanden.
23
+ 3. 🌍 **Automatische Incrementele Vertaling**: Gebruik AI voor incrementele vertaling, zodat gebruikers Markdown in hun moedertaal kunnen schrijven, maar de site meertalig kan zijn.
24
+
25
+ Waarom nog een Markdown statische site generator? Ik heb opnieuw nagedacht over hoe documentatietools in het AI-tijdperk schrijvers beter kunnen dienen:
26
+
27
+ - Terug naar inhoud: Minimale onderbreking, focus op schrijven
28
+
29
+ Laat documentatie terugkeren naar de essentie, laat schrijven terugkeren naar rust.
30
+
31
+ Ten eerste, ik wil geen bibliothecaris zijn. Soms wil ik iets opschrijven, maar ik heb misschien nog geen titel bedacht of een duidelijke structuur gevormd. Ik hoop dat LLM automatisch titels voor me genereert, samenvattingen maakt, categoriseert, navigatie regelt en ander organisatiewerk doet.
32
+
33
+ Ten tweede, mijn werkkamer moet opgeruimd zijn. Ik wil geen complexe bouwtools configureren, geen ingewikkelde documentatie-instellingen, geen complexe structuren. Elke keer als ik de configuratiebestanden en projectstructuren van tools zoals Docusaurus, VuePress, Astro zie, krijg ik hoofdpijn. Nu kiest ZEN ervoor om alle configuratie te verbergen in de .zen map, weggeveegd in een hoekje. Gebruikers hoeven zich alleen te concentreren op het schrijven van inhoud, de rest laat ZEN afhandelen. Alle andere mappen zijn uw schrijfruimte, u kunt uw Markdown-bestanden vrij organiseren.
34
+
35
+ - Terug naar moedertaal: Schrijf in je moedertaal, bouw soepel meertalige versies
36
+
37
+ Het leven is kort, ik heb geen zin om te vertalen. Mensen kunnen hun denkdiepte het beste benutten wanneer ze hun moedertaal gebruiken. Maar tegelijkertijd is verbinding met de wereld noodzakelijk, ik wil meertalige communicatie niet opgeven. Daarom hoop ik op een tool waarmee ik in mijn moedertaal kan schrijven, terwijl meer mensen mijn inhoud kunnen zien. De huidige i18n vereist niet alleen zelfvertaling, maar ook zelfonderhoud van inhoudsupdates, dat is te veel gedoe. Ik kies ervoor om LLM te gebruiken om me te helpen met vertalen, wat me veel tijd bespaart en meertalige vertalingen met één klik mogelijk maakt.
38
+
39
+ ## Snel Starten
40
+
41
+ Vereisten:
42
+
43
+ - [Node.js](https://nodejs.org/) geïnstalleerd (versie 18 of hoger aanbevolen, npx commando nodig)
44
+ - Een [OpenAI API Key](https://platform.openai.com/account/api-keys) verkregen, of een OPENAI-compatibele API Key
45
+ - Git geïnstalleerd (om Markdown-bestanden uit Git op te lijsten, bestanden gefilterd door .gitignore regels te negeren)
46
+
47
+ Werk eerst in een map die al door Git wordt beheerd:
48
+
49
+ Configureer omgevingsvariabelen
50
+
51
+ ```bash
52
+ export OPENAI_API_KEY="sk-xxxxxx" # Verplicht: Vervang door uw OpenAI API Key
53
+ export OPENAI_BASE_URL="https://api.openai.com/v1" # Optioneel, gebruikt standaard de officiële OpenAI API
54
+ export OPENAI_MODEL="gpt-3.5-turbo" # Optioneel, gebruikt standaard het gpt-3.5-turbo model
55
+ ```
56
+
57
+ Bouw de site, ondersteunt meertalige vertaling. Gebruik de huidige map als bronmap, uitvoer naar de `.zen/dist` map.
58
+
59
+ - U kunt meerdere keren de `--lang` parameter gebruiken om de gewenste taalversies op te geven (bijv. `--lang zh-Hans --lang en-US`).
60
+ - Bron taal hoeft niet geconfigureerd te worden, ZEN detecteert dit automatisch.
61
+
62
+ ```bash
63
+ npx zengen@latest build --lang zh-Hans --lang en-US
64
+ ```
65
+
66
+ **Bekijk meer parameters of help**:
67
+
68
+ ```bash
69
+ npx zengen@latest
70
+ ```