zengen 0.3.0 → 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.
- package/.zen/meta.json +7 -8
- package/.zen/src/ar-SA/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/ar-SA/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/da-DK/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/da-DK/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/de-DE/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/de-DE/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/en-US/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/en-US/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/es-ES/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/es-ES/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/es-MX/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/es-MX/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/fi-FI/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/fi-FI/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/fr-FR/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/fr-FR/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/hi-IN/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/hi-IN/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/id-ID/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/id-ID/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/it-IT/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/it-IT/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/ja-JP/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/ja-JP/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/ko-KR/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/ko-KR/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/nl-NL/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/nl-NL/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/no-NO/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/no-NO/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/pl-PL/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/pl-PL/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/pt-BR/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/pt-BR/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/pt-PT/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/pt-PT/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/ru-RU/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/ru-RU/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/sv-SE/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/sv-SE/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/th-TH/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/th-TH/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/tr-TR/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/tr-TR/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/uk-UA/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/uk-UA/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/vi-VN/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/vi-VN/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/zh-Hans/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +74 -0
- package/.zen/src/zh-Hans/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +75 -0
- package/.zen/src/zh-Hant/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/zh-Hant/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/README.md +1 -2
- package/dist/build/pipeline.d.ts.map +1 -1
- package/dist/build/pipeline.js +0 -1
- package/dist/build/pipeline.js.map +1 -1
- package/dist/cli.js +0 -2
- package/dist/cli.js.map +1 -1
- package/dist/process/template.d.ts.map +1 -1
- package/dist/process/template.js +3 -4
- package/dist/process/template.js.map +1 -1
- package/dist/types.d.ts +0 -1
- package/dist/types.d.ts.map +1 -1
- package/package.json +2 -2
- package/src/build/pipeline.ts +0 -1
- package/src/cli.ts +0 -2
- package/src/process/template.ts +3 -9
- package/src/types.ts +0 -1
package/.zen/meta.json
CHANGED
|
@@ -2,7 +2,6 @@
|
|
|
2
2
|
"version": "1.0.0",
|
|
3
3
|
"options": {
|
|
4
4
|
"verbose": true,
|
|
5
|
-
"baseUrl": "/ZEN",
|
|
6
5
|
"langs": [
|
|
7
6
|
"zh-Hans",
|
|
8
7
|
"en-US",
|
|
@@ -34,22 +33,22 @@
|
|
|
34
33
|
},
|
|
35
34
|
"files": [
|
|
36
35
|
{
|
|
37
|
-
"hash": "
|
|
36
|
+
"hash": "6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed",
|
|
38
37
|
"path": "README.md",
|
|
39
38
|
"links": [
|
|
40
|
-
"https://zccz14.
|
|
39
|
+
"https://zen.zccz14.com/",
|
|
41
40
|
"https://nodejs.org/",
|
|
42
41
|
"https://platform.openai.com/account/api-keys"
|
|
43
42
|
],
|
|
44
43
|
"metadata": {
|
|
45
44
|
"title": "ZEN - 极简主义 Markdown + AI 静态站点构建器",
|
|
46
|
-
"summary": "ZEN 是一个结合 AI
|
|
47
|
-
"tags": ["静态站点生成器", "Markdown", "AI", "
|
|
45
|
+
"summary": "ZEN 是一个结合 AI 的静态站点生成器,专注于简化文档写作和构建过程。它允许用户使用 Markdown 在 git 管理的文件夹中创建静态 HTML 站点,无需复杂配置,所有设置隐藏在 .zen 目录下。核心功能包括智能分类导航(通过 AI 分析内容生成站点地图)、自动增量翻译(支持多语言版本,用户可用母语写作,AI 处理翻译),以及最小化打扰的写作体验。工具依赖 Node.js、OpenAI API Key 和 Git,通过命令行快速构建,支持指定语言参数如 zh-Hans 和 en-US。",
|
|
46
|
+
"tags": ["静态站点生成器", "Markdown", "AI", "多语言翻译", "极简主义", "文档工具", "ZEN"],
|
|
48
47
|
"inferred_lang": "zh-Hans",
|
|
49
48
|
"tokens_used": {
|
|
50
|
-
"prompt":
|
|
51
|
-
"completion":
|
|
52
|
-
"total":
|
|
49
|
+
"prompt": 1011,
|
|
50
|
+
"completion": 212,
|
|
51
|
+
"total": 1223
|
|
53
52
|
}
|
|
54
53
|
}
|
|
55
54
|
},
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
---
|
|
2
|
+
'title': 'ZEN - منشئ مواقع ثابتة بالماركداون والذكاء الاصطناعي بتصميم بسيط'
|
|
3
|
+
'summary': 'ZEN هو منشئ مواقع ثابتة مدعوم بالذكاء الاصطناعي، يركز على تبسيط كتابة المستندات وعملية البناء. يسمح للمستخدمين بإنشاء مواقع HTML ثابتة باستخدام Markdown في مجلدات مُدارة بـ Git، دون حاجة لإعدادات معقدة، حيث يتم إخفاء جميع الإعدادات في دليل .zen. تشمل الميزات الأساسية: التنقل الذكي المُصنف (يولد خريطة الموقع عبر تحليل المحتوى بالذكاء الاصطناعي)، والترجمة التلقائية التدريجية (تدعم إصدارات متعددة اللغات، يمكن للمستخدمين الكتابة بلغتهم الأم، ويتولى الذكاء الاصطناعي الترجمة)، وتجربة كتابة بأقل قدر من الإزعاج. يعتمد الأداة على Node.js ومفتاح OpenAI API وGit، ويتم البناء عبر سطر الأوامر بسرعة، ويدعم معلمات لغوية محددة مثل zh-Hans وen-US.'
|
|
4
|
+
'tags':
|
|
5
|
+
- 'منشئ مواقع ثابتة'
|
|
6
|
+
- 'ماركداون'
|
|
7
|
+
- 'ذكاء اصطناعي'
|
|
8
|
+
- 'ترجمة متعددة اللغات'
|
|
9
|
+
- 'تصميم بسيط'
|
|
10
|
+
- 'أدوات المستندات'
|
|
11
|
+
- 'ZEN'
|
|
12
|
+
'inferred_lang': 'zh-Hans'
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
# ZEN - منشئ مواقع ثابتة بالماركداون والذكاء الاصطناعي بتصميم بسيط
|
|
16
|
+
|
|
17
|
+
[> عرض تجريبي للموقع](https://zen.zccz14.com/)
|
|
18
|
+
|
|
19
|
+
## الوظائف الأساسية
|
|
20
|
+
|
|
21
|
+
1. 📃 **إنشاء موقع ثابت**: تحويل أي مجلد يحتوي على Markdown ويُدار بـ Git إلى موقع HTML ثابت.
|
|
22
|
+
2. 🧭 **تنقل وتصنيف ذكي**: استخدام الذكاء الاصطناعي لتحليل المحتوى، وإنشاء خريطة موقع وتنقل، دون حساسية لموقع الملفات المصدر.
|
|
23
|
+
3. 🌍 **ترجمة تلقائية تدريجية**: استخدام الذكاء الاصطناعي للترجمة التدريجية، مما يسمح للمستخدمين بكتابة Markdown بلغتهم الأم، مع إمكانية توفير المحتوى بلغات متعددة.
|
|
24
|
+
|
|
25
|
+
لماذا تم إنشاء منشئ موقع ثابت آخر بـ Markdown؟ لقد فكرت مرة أخرى في كيفية خدمة أدوات المستندات للكتّاب بشكل أفضل في عصر الذكاء الاصطناعي:
|
|
26
|
+
|
|
27
|
+
- العودة إلى المحتوى: تقليل الإزعاج إلى الحد الأدنى، والتركيز على الكتابة
|
|
28
|
+
|
|
29
|
+
إعادة المستندات إلى جوهرها، وإعادة الهدوء إلى الكتابة.
|
|
30
|
+
|
|
31
|
+
أولاً، لا أريد أن أكون أمين مكتبة. أحيانًا أريد كتابة بعض المحتوى، لكن قد لا أكون قد فكرت في عنوانه بعد، أو لم أقم بتنظيمه بشكل خاص. أتمنى أن يساعدني الذكاء الاصطناعي تلقائيًا في إنشاء العناوين، والملخصات، والتصنيف، والتنقل، وغيرها من أعمال التنظيم.
|
|
32
|
+
|
|
33
|
+
ثانيًا، يجب أن يكون مكتبي نظيفًا. لا أريد أدوات بناء معقدة الإعداد، ولا التعامل مع إعدادات مستندات معقدة، ولا أحب الهياكل المعقدة. كلما رأيت ملفات إعداد وهياكل مشاريع أدوات مثل Docusaurus وVuePress وAstro، أشعر بالصداع. الآن، اختار ZEN إخفاء جميع الإعدادات في دليل .zen، ودفعها إلى الزاوية، بحيث يحتاج المستخدم فقط إلى التركيز على كتابة المحتوى، ويتولى ZEN الباقي. جميع الأدلة الأخرى هي مساحة الكتابة الخاصة بك، يمكنك تنظيم ملفات Markdown الخاصة بك كما تشاء.
|
|
34
|
+
|
|
35
|
+
- العودة إلى اللغة الأم: الكتابة باللغة الأم، وبناء إصدارات متعددة اللغات بسلاسة
|
|
36
|
+
|
|
37
|
+
الحياة قصيرة، وأنا كسول للترجمة. عندما يستخدم الشخص لغته الأم، يكون قادرًا على استغلال عمق تفكيره إلى أقصى حد. ولكن في نفس الوقت، من الضروري الحفاظ على الاتصال بالعالم، ولا أريد التخلي عن التواصل متعدد اللغات. لذلك، أتمنى أن تكون هناك أداة تسمح لي بالكتابة بلغتي الأم، وفي نفس الوقت تسمح للمزيد من الأشخاص برؤية محتواي. حاليًا، يتطلب i18n الترجمة الذاتية بالإضافة إلى الحفاظ على تحديث المحتوى، وهذا أمر مزعج للغاية. اخترت استخدام الذكاء الاصطناعي لمساعدتي في الترجمة، مما وفر علي الكثير من الوقت، ويمكن إكمال ترجمة لغات متعددة بنقرة واحدة.
|
|
38
|
+
|
|
39
|
+
## البدء السريع
|
|
40
|
+
|
|
41
|
+
المتطلبات المسبقة:
|
|
42
|
+
|
|
43
|
+
- تثبيت [Node.js](https://nodejs.org/) (يُفضل الإصدار 18 أو أعلى، مع وجود أمر npx)
|
|
44
|
+
- الحصول على [مفتاح OpenAI API](https://platform.openai.com/account/api-keys)، أو مفتاح API متوافق مع OPENAI
|
|
45
|
+
- تثبيت Git (لإدراج ملفات Markdown من Git، وتجاهل الملفات التي تستبعدها قواعد .gitignore)
|
|
46
|
+
|
|
47
|
+
أولاً، اعمل داخل مجلد مُدار بـ Git بالفعل:
|
|
48
|
+
|
|
49
|
+
تكوين متغيرات البيئة
|
|
50
|
+
|
|
51
|
+
```bash
|
|
52
|
+
export OPENAI_API_KEY="sk-xxxxxx" # إلزامي: استبدل بمفتاح OpenAI API الخاص بك
|
|
53
|
+
export OPENAI_BASE_URL="https://api.openai.com/v1" # اختياري، يستخدم API الرسمي لـ OpenAI افتراضيًا
|
|
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 + الذكاء الاصطناعي'
|
|
3
|
+
'summary': 'ZEN هو مُنشئ مواقع ثابتة مُدمج مع وظائف الذكاء الاصطناعي، مُصمم خصيصًا لمستندات Markdown. يسمح للمستخدمين بتحويل مجلد Git يحتوي على ملفات Markdown إلى موقع HTML ثابت، دون حاجة لإعدادات معقدة، حيث يتم إخفاء جميع الإعدادات في دليل .zen. تشمل الميزات الأساسية: التنقل الذكي المُصنف (باستخدام الذكاء الاصطناعي لتحليل المحتوى وإنشاء خريطة الموقع)، والترجمة التلقائية التدريجية (تدعم إصدارات متعددة اللغات، حيث يمكن للمستخدمين الكتابة بلغتهم الأم، ويتولى الذكاء الاصطناعي عملية الترجمة)، وتجربة كتابة بأقل قدر من الإزعاج. يتطلب دليل البدء السريع تثبيت Node.js، والحصول على مفتاح OpenAI API و Git، وبناء الموقع عبر سطر الأوامر، مع دعم تحديد اللغة وعنوان URL الأساسي.'
|
|
4
|
+
'tags':
|
|
5
|
+
- 'مُنشئ المواقع الثابتة'
|
|
6
|
+
- 'Markdown'
|
|
7
|
+
- 'الذكاء الاصطناعي'
|
|
8
|
+
- 'ترجمة متعددة اللغات'
|
|
9
|
+
- 'البساطة'
|
|
10
|
+
- 'أداة توثيق'
|
|
11
|
+
- 'Git'
|
|
12
|
+
'inferred_lang': 'zh-Hans'
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
# ZEN - مُنشئ المواقع الثابتة البسيط باستخدام Markdown + الذكاء الاصطناعي
|
|
16
|
+
|
|
17
|
+
[> عرض تجريبي للموقع](https://zen.zccz14.com/)
|
|
18
|
+
|
|
19
|
+
## الوظائف الأساسية
|
|
20
|
+
|
|
21
|
+
1. 📃 **إنشاء موقع ثابت**: تحويل أي مجلد git يحتوي على Markdown إلى موقع HTML ثابت.
|
|
22
|
+
2. 🧭 **تنقل ذكي مُصنف**: استخدام الذكاء الاصطناعي لتحليل المحتوى، وإنشاء خريطة موقع وتنقل، دون حساسية لموقع الملفات المصدر.
|
|
23
|
+
3. 🌍 **ترجمة تلقائية تدريجية**: استخدام الذكاء الاصطناعي للترجمة التدريجية، مما يسمح للمستخدمين بكتابة Markdown بلغتهم الأم، مع إمكانية توفير المحتوى بلغات متعددة.
|
|
24
|
+
|
|
25
|
+
لماذا قمت بإنشاء مُنشئ مواقع ثابت آخر باستخدام Markdown؟ لقد فكرت مرة أخرى في كيفية خدمة أدوات التوثيق للكتّاب بشكل أفضل في عصر الذكاء الاصطناعي:
|
|
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](https://platform.openai.com/account/api-keys)، أو مفتاح API متوافق مع OPENAI
|
|
45
|
+
- تثبيت Git (لاستخدامه في سرد ملفات Markdown من Git، وتجاهل الملفات التي تستبعدها قواعد .gitignore)
|
|
46
|
+
|
|
47
|
+
أولاً، اعمل داخل مجلد تمت إدارته بواسطة git بالفعل:
|
|
48
|
+
|
|
49
|
+
تكوين متغيرات البيئة
|
|
50
|
+
|
|
51
|
+
```bash
|
|
52
|
+
export OPENAI_API_KEY="sk-xxxxxx" # إلزامي: يُرجى استبداله بمفتاح OpenAI API الخاص بك
|
|
53
|
+
export OPENAI_BASE_URL="https://api.openai.com/v1" # اختياري، يستخدم API الرسمي لـ OpenAI افتراضيًا
|
|
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
|
+
- يمكن تحديد بادئة عنوان URL الأساسي للموقع من خلال معلمة `--base-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,70 @@
|
|
|
1
|
+
---
|
|
2
|
+
'title': 'ZEN - Minimalistisk Markdown + AI statisk site-bygger'
|
|
3
|
+
'summary': 'ZEN er en statisk site-generator kombineret med AI, der fokuserer på at forenkle dokumentationsskrivning og byggeprocessen. Den tillader brugere at oprette statiske HTML-sider i git-styrede mapper ved hjælp af Markdown, uden kompleks konfiguration – alle indstillinger er skjult i .zen-mappen. Kernefunktioner omfatter intelligent kategorinavigation (generering af sitemap via AI-analyse af indhold), automatisk inkrementel oversættelse (understøtter flersprogede versioner, hvor brugeren kan skrive på modersmål, og AI håndterer oversættelsen) samt en minimalt forstyrrende skriveoplevelse. Værktøjet kræver Node.js, OpenAI API-nøgle og Git, bygger hurtigt via kommandolinjen og understøtter angivelse af sprogparametre som zh-Hans og en-US.'
|
|
4
|
+
'tags':
|
|
5
|
+
- 'Statisk site-generator'
|
|
6
|
+
- 'Markdown'
|
|
7
|
+
- 'AI'
|
|
8
|
+
- 'Flersproget oversættelse'
|
|
9
|
+
- 'Minimalisme'
|
|
10
|
+
- 'Dokumentationsværktøj'
|
|
11
|
+
- 'ZEN'
|
|
12
|
+
'inferred_lang': 'zh-Hans'
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
# ZEN - Minimalistisk Markdown + AI statisk site-bygger
|
|
16
|
+
|
|
17
|
+
[> Website Demo](https://zen.zccz14.com/)
|
|
18
|
+
|
|
19
|
+
## Grundlæggende funktioner
|
|
20
|
+
|
|
21
|
+
1. 📃 **Statisk site-generering**: Byg en hvilken som helst git-mappe indeholdende Markdown om til et statisk HTML-site.
|
|
22
|
+
2. 🧭 **Intelligent kategorinavigation**: Brug AI til indholdsanalyse, generer sitemap og navigation – placeringen af kildefiler er ikke afgørende.
|
|
23
|
+
3. 🌍 **Automatisk inkrementel oversættelse**: Brug AI til inkrementel oversættelse, så brugeren kan skrive Markdown på modersmål, mens sitet kan være flersproget.
|
|
24
|
+
|
|
25
|
+
Hvorfor endnu en Markdown-statisk-site-generator? Jeg har genovervejet, hvordan dokumentationsværktøjer i AI-tiden bedre kan tjene forfattere:
|
|
26
|
+
|
|
27
|
+
- Tilbage til indholdet: Minimal forstyrrelse, fokus på skrivning
|
|
28
|
+
|
|
29
|
+
Lad dokumentationen vende tilbage til essensen, lad skrivningen vende tilbage til ro.
|
|
30
|
+
|
|
31
|
+
For det første vil jeg ikke være bibliotekar. Nogle gange vil jeg skrive noget ned, men jeg har måske ikke tænkt på en titel endnu eller organiseret det særligt. Jeg ønsker, at LLM automatisk hjælper med at generere titler, lave resuméer, kategorisere, navigere og andre organisatoriske opgaver.
|
|
32
|
+
|
|
33
|
+
For det andet skal mit skriveværelse være rent og ryddeligt. Jeg vil ikke have komplekse konfigurationsværktøjer, rode med indviklede dokumentationsopsætninger eller komplicerede strukturer. Hver gang jeg ser konfigurationsfiler og projektstrukturer fra værktøjer som Docusaurus, VuePress eller Astro, får jeg hovedpine. Nu vælger ZEN at skjule al konfiguration i .zen-mappen, feje det væk i et hjørne, så brugeren kun skal fokusere på at skrive indhold – alt andet håndteres af ZEN. Alle andre mapper er dit skriveområde, hvor du frit kan organisere dine Markdown-filer.
|
|
34
|
+
|
|
35
|
+
- Tilbage til modersmålet: Skriv på modersmål, byg problemfrit flersprogede versioner
|
|
36
|
+
|
|
37
|
+
Livet er for kort til at jeg gider oversætte. Man udnytter sin tankedybde bedst, når man bruger sit modersmål. Men samtidig er det nødvendigt at forbinde sig med verden, og jeg vil ikke opgive flersproget kommunikation. Derfor ønsker jeg et værktøj, der lader mig skrive på modersmål, samtidig med at flere mennesker kan se mit indhold. Nuværende i18n kræver, at man selv oversætter og vedligeholder opdateringer – det er for besværligt. Jeg vælger at bruge LLM til at hjælpe med oversættelsen, hvilket sparer mig for meget tid og gør det muligt at fuldføre flersproget oversættelse med et enkelt klik.
|
|
38
|
+
|
|
39
|
+
## Hurtig start
|
|
40
|
+
|
|
41
|
+
Forudsætninger:
|
|
42
|
+
|
|
43
|
+
- [Node.js](https://nodejs.org/) installeret (anbefalet version 18 eller nyere, kræver npx-kommandoen)
|
|
44
|
+
- [OpenAI API-nøgle](https://platform.openai.com/account/api-keys) erhvervet, eller en OPENAI-kompatibel API-nøgle
|
|
45
|
+
- Git installeret (bruges til at liste Markdown-filer fra Git og ignorere filer filtreret af .gitignore-regler)
|
|
46
|
+
|
|
47
|
+
Først: Arbejd i en mappe, der allerede administreres af git:
|
|
48
|
+
|
|
49
|
+
Konfigurer miljøvariabler
|
|
50
|
+
|
|
51
|
+
```bash
|
|
52
|
+
export OPENAI_API_KEY="sk-xxxxxx" # Påkrævet: Erstat med din OpenAI API-nøgle
|
|
53
|
+
export OPENAI_BASE_URL="https://api.openai.com/v1" # Valgfri, bruger som standard OpenAI's officielle API
|
|
54
|
+
export OPENAI_MODEL="gpt-3.5-turbo" # Valgfri, bruger som standard gpt-3.5-turbo-modellen
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
Byg sitet, understøtter flersproget oversættelse. Brug den aktuelle mappe som kildemappe, output til `.zen/dist`-mappen.
|
|
58
|
+
|
|
59
|
+
- Du kan angive de ønskede sprogversioner ved gentagne gange at bruge `--lang`-parameteren (f.eks. `--lang zh-Hans --lang en-US`).
|
|
60
|
+
- Kilde sprog behøver ikke konfigureres, ZEN detekterer det automatisk.
|
|
61
|
+
|
|
62
|
+
```bash
|
|
63
|
+
npx zengen@latest build --lang zh-Hans --lang en-US
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
**Se flere parametre eller hjælp**:
|
|
67
|
+
|
|
68
|
+
```bash
|
|
69
|
+
npx zengen@latest
|
|
70
|
+
```
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
---
|
|
2
|
+
'title': 'ZEN - Minimalistisk Markdown + AI statisk site-generator'
|
|
3
|
+
'summary': 'ZEN er en statisk site-generator med AI-funktioner, designet til Markdown-dokumenter. Den gør det muligt for brugere at konvertere en Git-mappe med Markdown-filer til et statisk HTML-site uden kompleks konfiguration – alle indstillinger er skjult i .zen-mappen. Kernesystemet inkluderer intelligent kategorinavigation (bruger AI til at analysere indhold og generere et sitemap), automatisk inkrementel oversættelse (understøtter flersprogede versioner, så brugere kan skrive på deres modersmål, mens AI håndterer oversættelsen) og en minimalt forstyrrende skriveoplevelse. Hurtig start-guiden kræver installation af Node.js, anskaffelse af en OpenAI API-nøgle og Git, og opbygning af sitet via kommandolinjen med mulighed for at angive sprog og basis-URL.'
|
|
4
|
+
'tags':
|
|
5
|
+
- 'Statisk site-generator'
|
|
6
|
+
- 'Markdown'
|
|
7
|
+
- 'AI'
|
|
8
|
+
- 'Flersproget oversættelse'
|
|
9
|
+
- 'Minimalisme'
|
|
10
|
+
- 'Dokumentationsværktøj'
|
|
11
|
+
- 'Git'
|
|
12
|
+
'inferred_lang': 'da-DK'
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
# ZEN - Minimalistisk Markdown + AI statisk site-generator
|
|
16
|
+
|
|
17
|
+
[> Website Demo](https://zen.zccz14.com/)
|
|
18
|
+
|
|
19
|
+
## Grundlæggende funktioner
|
|
20
|
+
|
|
21
|
+
1. 📃 **Statisk site-generering**: Byg en hvilken som helst git-mappe med Markdown-filer om til et statisk HTML-site.
|
|
22
|
+
2. 🧭 **Intelligent kategorinavigation**: Brug AI til at analysere indhold, generere sitemap og navigation – uafhængigt af kildefilernes placering.
|
|
23
|
+
3. 🌍 **Automatisk inkrementel oversættelse**: Brug AI til inkrementel oversættelse, så brugerne kan skrive Markdown på deres modersmål, mens sitet kan være flersproget.
|
|
24
|
+
|
|
25
|
+
Hvorfor endnu en Markdown statisk site-generator? Jeg har genovervejet, hvordan dokumentationsværktøjer i AI-tiden bedre kan tjene forfattere:
|
|
26
|
+
|
|
27
|
+
- Tilbage til indholdet: Minimal forstyrrelse, fokus på skrivning
|
|
28
|
+
|
|
29
|
+
Lad dokumentationen vende tilbage til essensen, og lad skriveprocessen være fredfyldt.
|
|
30
|
+
|
|
31
|
+
For det første ønsker jeg ikke at være bibliotekar. Nogle gange vil jeg skrive noget indhold, men jeg har måske ikke tænkt på en titel endnu eller organiseret det særligt godt. Jeg håber, at LLM automatisk vil hjælpe med at generere titler, lave resuméer, kategorisere og oprette navigation.
|
|
32
|
+
|
|
33
|
+
For det andet skal mit skriveværelse være rent og ryddeligt. Jeg vil ikke konfigurere komplekse byggeværktøjer, rode med indviklede dokumentationsopsætninger eller have komplekse strukturer. Hver gang jeg ser konfigurationsfiler og projektstrukturer fra værktøjer som Docusaurus, VuePress eller Astro, får jeg hovedpine. Nu vælger ZEN at skjule al konfiguration i .zen-mappen – gemt væk i et hjørne. Brugeren skal kun fokusere på at skrive indhold; alt andet håndteres af ZEN. Alle andre mapper er din skriveplads, hvor du frit kan organisere dine Markdown-filer.
|
|
34
|
+
|
|
35
|
+
- Tilbage til modersmålet: Skriv på modersmål, opbyg flersprogede versioner problemfrit
|
|
36
|
+
|
|
37
|
+
Livet er for kort til at jeg gider oversætte. Man udtrykker sine tanker bedst, når man bruger sit modersmål. Men samtidig er det nødvendigt at forbinde sig med verden, og jeg vil ikke opgive flersproget kommunikation. Derfor ønsker jeg et værktøj, der lader mig skrive på mit modersmål, samtidig med at flere mennesker kan se mit indhold. Nuværende i18n-løsninger kræver, at man selv oversætter og vedligeholder opdateringer – det er for besværligt. Jeg vælger at bruge LLM til at hjælpe med oversættelsen, hvilket sparer mig for meget tid og gør det muligt at få flersprogede versioner med et enkelt klik.
|
|
38
|
+
|
|
39
|
+
## Hurtig start
|
|
40
|
+
|
|
41
|
+
Forudsætninger:
|
|
42
|
+
|
|
43
|
+
- [Node.js](https://nodejs.org/) installeret (anbefales version 18 eller nyere, skal have npx-kommandoen)
|
|
44
|
+
- [OpenAI API-nøgle](https://platform.openai.com/account/api-keys) anskaffet, eller en OPENAI-kompatibel API-nøgle
|
|
45
|
+
- Git installeret (bruges til at liste Markdown-filer fra Git og ignorere filer filtreret af .gitignore-regler)
|
|
46
|
+
|
|
47
|
+
Først, arbejd i en mappe, der allerede administreres af git:
|
|
48
|
+
|
|
49
|
+
Konfigurer miljøvariabler
|
|
50
|
+
|
|
51
|
+
```bash
|
|
52
|
+
export OPENAI_API_KEY="sk-xxxxxx" # Påkrævet: Erstat med din OpenAI API-nøgle
|
|
53
|
+
export OPENAI_BASE_URL="https://api.openai.com/v1" # Valgfri, bruger standard OpenAI API som standard
|
|
54
|
+
export OPENAI_MODEL="gpt-3.5-turbo" # Valgfri, bruger gpt-3.5-turbo-modellen som standard
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
Byg sitet med understøttelse af flersproget oversættelse. Brug den aktuelle mappe som kildemappe og output til `.zen/dist`-mappen.
|
|
58
|
+
|
|
59
|
+
- Du kan angive de ønskede sprogversioner ved gentagne gange at bruge `--lang`-parameteren (f.eks. `--lang da-DK --lang en-US`).
|
|
60
|
+
- Du kan angive sitets basis-URL-præfiks med `--base-url`-parameteren (f.eks. dit repositorienavn på GitHub Pages).
|
|
61
|
+
- Kilde sprog behøver ikke konfigureres; ZEN registrerer det automatisk.
|
|
62
|
+
|
|
63
|
+
```bash
|
|
64
|
+
npx zengen@latest build --lang da-DK --lang en-US
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
**Se flere parametre eller få hjælp**:
|
|
68
|
+
|
|
69
|
+
```bash
|
|
70
|
+
npx zengen@latest
|
|
71
|
+
```
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
---
|
|
2
|
+
'title': 'ZEN - Minimalistischer Markdown + AI Static Site Builder'
|
|
3
|
+
'summary': 'ZEN ist ein statischer Site-Generator mit KI-Integration, der sich auf die Vereinfachung des Dokumentationsschreibens und des Build-Prozesses konzentriert. Er ermöglicht es Nutzern, mit Markdown in git-verwalteten Ordnern statische HTML-Seiten zu erstellen, ohne komplexe Konfiguration – alle Einstellungen sind im .zen-Verzeichnis verborgen. Kernfunktionen umfassen intelligente Kategorienavigation (durch KI-Analyse des Inhalts generierte Sitemap), automatische inkrementelle Übersetzung (Unterstützung für mehrsprachige Versionen, Nutzer können in ihrer Muttersprache schreiben, KI übernimmt die Übersetzung) und eine minimal störende Schreiberfahrung. Das Tool benötigt Node.js, einen OpenAI API Key und Git, ermöglicht schnelle Builds über die Kommandozeile und unterstützt Sprachparameter wie zh-Hans und en-US.'
|
|
4
|
+
'tags':
|
|
5
|
+
- 'Statischer Site-Generator'
|
|
6
|
+
- 'Markdown'
|
|
7
|
+
- 'KI'
|
|
8
|
+
- 'Mehrsprachige Übersetzung'
|
|
9
|
+
- 'Minimalismus'
|
|
10
|
+
- 'Dokumentationstool'
|
|
11
|
+
- 'ZEN'
|
|
12
|
+
'inferred_lang': 'zh-Hans'
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
# ZEN - Minimalistischer Markdown + AI Static Site Builder
|
|
16
|
+
|
|
17
|
+
[> Website Demo](https://zen.zccz14.com/)
|
|
18
|
+
|
|
19
|
+
## Grundlegende Funktionen
|
|
20
|
+
|
|
21
|
+
1. 📃 **Statische Site-Generierung**: Erstellt aus einem beliebigen Git-Ordner mit Markdown-Dateien eine statische HTML-Website.
|
|
22
|
+
2. 🧭 **Intelligente Kategorienavigation**: Nutzt KI zur Inhaltsanalyse, generiert Sitemap und Navigation – unabhängig von der Position der Quelldateien.
|
|
23
|
+
3. 🌍 **Automatische inkrementelle Übersetzung**: Nutzt KI für inkrementelle Übersetzungen, sodass Nutzer Markdown in ihrer Muttersprache schreiben können, die Website aber mehrsprachig ist.
|
|
24
|
+
|
|
25
|
+
Warum noch ein Markdown Static Site Generator? Ich habe überlegt, wie Dokumentationstools im KI-Zeitalter Autoren besser dienen können:
|
|
26
|
+
|
|
27
|
+
- Zurück zum Inhalt: Minimale Ablenkung, Fokus auf das Schreiben
|
|
28
|
+
|
|
29
|
+
Lasst die Dokumentation zu ihrem Wesen zurückkehren und das Schreiben zur Ruhe kommen.
|
|
30
|
+
|
|
31
|
+
Erstens: Ich möchte kein Bibliothekar sein. Manchmal möchte ich etwas aufschreiben, habe aber vielleicht noch keinen Titel oder eine klare Struktur. Ich möchte, dass eine LLM automatisch Titel generiert, Zusammenfassungen erstellt, kategorisiert, navigiert und andere organisatorische Aufgaben übernimmt.
|
|
32
|
+
|
|
33
|
+
Zweitens: Mein Arbeitsbereich muss aufgeräumt sein. Ich möchte keine komplexen Build-Tools konfigurieren, mich nicht mit komplizierten Dokumenteneinstellungen herumschlagen oder komplexe Strukturen haben. Jedes Mal, wenn ich die Konfigurationsdateien und Projektstrukturen von Tools wie Docusaurus, VuePress oder Astro sehe, bekomme ich Kopfschmerzen. ZEN versteckt jetzt alle Konfigurationen im .zen-Verzeichnis – weg in der Ecke. Der Nutzer muss sich nur auf den Inhalt konzentrieren, den Rest erledigt ZEN. Alle anderen Verzeichnisse sind Ihr Schreibbereich, Sie können Ihre Markdown-Dateien frei organisieren.
|
|
34
|
+
|
|
35
|
+
- Zurück zur Muttersprache: In der Muttersprache schreiben, nahtlos mehrsprachige Versionen erstellen
|
|
36
|
+
|
|
37
|
+
Das Leben ist zu kurz für Übersetzungen. Man denkt am tiefsten in der Muttersprache. Gleichzeitig ist die Verbindung zur Welt notwendig, ich möchte den mehrsprachigen Austausch nicht aufgeben. Daher wünsche ich mir ein Tool, mit dem ich in meiner Muttersprache schreiben kann, während mehr Menschen meinen Inhalt sehen. Aktuelle i18n-Lösungen erfordern nicht nur eigene Übersetzungen, sondern auch die Pflege von Aktualisierungen – zu umständlich. Ich nutze LLMs für Übersetzungen, spare viel Zeit und kann mit einem Klick mehrere Sprachversionen erstellen.
|
|
38
|
+
|
|
39
|
+
## Schnellstart
|
|
40
|
+
|
|
41
|
+
Voraussetzungen:
|
|
42
|
+
|
|
43
|
+
- [Node.js](https://nodejs.org/) installiert (empfohlen Version 18 oder höher, mit npx-Befehl)
|
|
44
|
+
- [OpenAI API Key](https://platform.openai.com/account/api-keys) oder kompatibler API Key beschafft
|
|
45
|
+
- Git installiert (zum Auflisten von Markdown-Dateien aus Git, ignoriert .gitignore-Dateien)
|
|
46
|
+
|
|
47
|
+
Arbeiten Sie zunächst in einem bereits von Git verwalteten Ordner:
|
|
48
|
+
|
|
49
|
+
Umgebungsvariablen konfigurieren
|
|
50
|
+
|
|
51
|
+
```bash
|
|
52
|
+
export OPENAI_API_KEY="sk-xxxxxx" # Erforderlich: Bitte durch Ihren OpenAI API Key ersetzen
|
|
53
|
+
export OPENAI_BASE_URL="https://api.openai.com/v1" # Optional, standardmäßig wird die offizielle OpenAI-API verwendet
|
|
54
|
+
export OPENAI_MODEL="gpt-3.5-turbo" # Optional, standardmäßig wird das gpt-3.5-turbo-Modell verwendet
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
Site erstellen, mit mehrsprachiger Übersetzungsunterstützung. Nutzt das aktuelle Verzeichnis als Quellverzeichnis, Ausgabe in `.zen/dist`.
|
|
58
|
+
|
|
59
|
+
- Mehrere Sprachversionen können durch wiederholte Verwendung des `--lang`-Parameters angegeben werden (z.B. `--lang zh-Hans --lang en-US`).
|
|
60
|
+
- Die Quellsprache muss nicht konfiguriert werden, ZEN erkennt sie automatisch.
|
|
61
|
+
|
|
62
|
+
```bash
|
|
63
|
+
npx zengen@latest build --lang zh-Hans --lang en-US
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
**Weitere Parameter oder Hilfe anzeigen**:
|
|
67
|
+
|
|
68
|
+
```bash
|
|
69
|
+
npx zengen@latest
|
|
70
|
+
```
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
---
|
|
2
|
+
'title': 'ZEN - Minimalistischer Markdown + AI Static Site Builder'
|
|
3
|
+
'summary': 'ZEN ist ein statischer Site-Generator mit KI-Funktionen, speziell für Markdown-Dokumente entwickelt. Er ermöglicht es Benutzern, einen Git-Ordner mit Markdown-Dateien in eine statische HTML-Website zu konvertieren, ohne komplexe Konfiguration – alle Einstellungen sind im .zen-Verzeichnis versteckt. Zu den Kernfunktionen gehören intelligente Kategorienavigation (KI-generierte Sitemap durch Inhaltsanalyse), automatische inkrementelle Übersetzung (Unterstützung für mehrsprachige Versionen, Benutzer können in ihrer Muttersprache schreiben, KI übernimmt die Übersetzung) und ein minimal störendes Schreiberlebnis. Die Schnellstartanleitung erfordert die Installation von Node.js, einen OpenAI API Key und Git, ermöglicht den Aufbau der Website über die Befehlszeile und unterstützt die Angabe von Sprache und Basis-URL.'
|
|
4
|
+
'tags':
|
|
5
|
+
- 'Statischer Site-Generator'
|
|
6
|
+
- 'Markdown'
|
|
7
|
+
- 'KI'
|
|
8
|
+
- 'Mehrsprachige Übersetzung'
|
|
9
|
+
- 'Minimalismus'
|
|
10
|
+
- 'Dokumentationstool'
|
|
11
|
+
- 'Git'
|
|
12
|
+
'inferred_lang': 'zh-Hans'
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
# ZEN - Minimalistischer Markdown + AI Static Site Builder
|
|
16
|
+
|
|
17
|
+
[> Website Demo](https://zen.zccz14.com/)
|
|
18
|
+
|
|
19
|
+
## Grundlegende Funktionen
|
|
20
|
+
|
|
21
|
+
1. 📃 **Statische Site-Generierung**: Wandelt einen beliebigen Git-Ordner mit Markdown-Dateien in eine statische HTML-Website um.
|
|
22
|
+
2. 🧭 **Intelligente Kategorienavigation**: Nutzt KI zur Inhaltsanalyse, generiert Sitemap und Navigation, unabhängig von der Position der Quelldateien.
|
|
23
|
+
3. 🌍 **Automatische inkrementelle Übersetzung**: Nutzt KI für inkrementelle Übersetzungen, sodass Benutzer Markdown in ihrer Muttersprache schreiben können, aber mehrsprachige Inhalte bereitstellen.
|
|
24
|
+
|
|
25
|
+
Warum noch ein Markdown Static Site Generator? Ich habe überlegt, wie Dokumentationstools im KI-Zeitalter Autoren besser dienen können:
|
|
26
|
+
|
|
27
|
+
- Zurück zum Inhalt: Minimale Ablenkung, Fokus auf das Schreiben
|
|
28
|
+
|
|
29
|
+
Lasst die Dokumentation zum Wesentlichen zurückkehren und das Schreiben zur Ruhe.
|
|
30
|
+
|
|
31
|
+
Erstens: Ich möchte kein Bibliothekar sein. Manchmal möchte ich etwas aufschreiben, aber ich habe vielleicht noch keinen Titel oder eine klare Struktur. Ich wünsche mir, dass LLMs automatisch Titel generieren, Zusammenfassungen erstellen, kategorisieren und Navigationen organisieren.
|
|
32
|
+
|
|
33
|
+
Zweitens: Mein Arbeitsbereich muss aufgeräumt sein. Ich möchte keine komplexen Build-Tools konfigurieren, keine komplizierten Dokumenteneinstellungen und keine komplexen Strukturen. Jedes Mal, wenn ich die Konfigurationsdateien und Projektstrukturen von Docusaurus, VuePress oder Astro sehe, bekomme ich Kopfschmerzen. ZEN versteckt jetzt alle Konfigurationen im .zen-Verzeichnis – aus dem Weg geräumt. Benutzer konzentrieren sich nur auf den Inhalt, den Rest erledigt ZEN. Alle anderen Verzeichnisse sind Ihr Schreibbereich, Sie können Ihre Markdown-Dateien frei organisieren.
|
|
34
|
+
|
|
35
|
+
- Zurück zur Muttersprache: In der Muttersprache schreiben, nahtlos mehrsprachige Versionen erstellen
|
|
36
|
+
|
|
37
|
+
Das Leben ist zu kurz für Übersetzungen. Menschen denken am tiefgründigsten in ihrer Muttersprache. Gleichzeitig ist die Verbindung zur Welt notwendig, ich möchte den mehrsprachigen Austausch nicht aufgeben. Daher wünsche ich mir ein Tool, mit dem ich in meiner Muttersprache schreiben kann, während mehr Menschen meine Inhalte sehen. Aktuelle i18n-Lösungen erfordern nicht nur eigene Übersetzungen, sondern auch die Pflege von Aktualisierungen – zu umständlich. Ich nutze LLMs für Übersetzungen, spare viel Zeit und kann mit einem Klick mehrere Sprachversionen erstellen.
|
|
38
|
+
|
|
39
|
+
## Schnellstart
|
|
40
|
+
|
|
41
|
+
Voraussetzungen:
|
|
42
|
+
|
|
43
|
+
- [Node.js](https://nodejs.org/) installiert (empfohlen Version 18 oder höher, npx-Befehl erforderlich)
|
|
44
|
+
- [OpenAI API Key](https://platform.openai.com/account/api-keys) vorhanden oder kompatibler API Key
|
|
45
|
+
- Git installiert (zum Auflisten von Markdown-Dateien aus Git, ignoriert durch .gitignore gefilterte Dateien)
|
|
46
|
+
|
|
47
|
+
Arbeiten Sie zunächst in einem von Git verwalteten Ordner:
|
|
48
|
+
|
|
49
|
+
Umgebungsvariablen konfigurieren
|
|
50
|
+
|
|
51
|
+
```bash
|
|
52
|
+
export OPENAI_API_KEY="sk-xxxxxx" # Erforderlich: Ersetzen Sie mit Ihrem OpenAI API Key
|
|
53
|
+
export OPENAI_BASE_URL="https://api.openai.com/v1" # Optional, standardmäßig wird die offizielle OpenAI API verwendet
|
|
54
|
+
export OPENAI_MODEL="gpt-3.5-turbo" # Optional, standardmäßig wird das gpt-3.5-turbo Modell verwendet
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
Website erstellen, mit mehrsprachiger Übersetzungsunterstützung. Nutzt das aktuelle Verzeichnis als Quellverzeichnis, Ausgabe in `.zen/dist`.
|
|
58
|
+
|
|
59
|
+
- Mehrere Sprachversionen können durch wiederholte Verwendung des `--lang`-Parameters angegeben werden (z.B. `--lang zh-Hans --lang en-US`).
|
|
60
|
+
- Die Basis-URL-Präfix der Website kann mit dem `--base-url`-Parameter festgelegt werden (z.B. Repository-Name auf GitHub Pages).
|
|
61
|
+
- Die Quellsprache muss nicht konfiguriert werden, ZEN erkennt sie automatisch.
|
|
62
|
+
|
|
63
|
+
```bash
|
|
64
|
+
npx zengen@latest build --lang zh-Hans --lang en-US
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
**Weitere Parameter oder Hilfe anzeigen**:
|
|
68
|
+
|
|
69
|
+
```bash
|
|
70
|
+
npx zengen@latest
|
|
71
|
+
```
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
---
|
|
2
|
+
'title': 'ZEN - Minimalist Markdown + AI Static Site Builder'
|
|
3
|
+
'summary': 'ZEN is an AI-powered static site generator focused on simplifying documentation writing and building. It allows users to create static HTML sites from git-managed folders using Markdown, with no complex configuration—all settings are hidden in the .zen directory. Core features include intelligent categorization and navigation (generating site maps via AI content analysis), automatic incremental translation (supporting multilingual versions, enabling users to write in their native language while AI handles translation), and a minimally disruptive writing experience. The tool relies on Node.js, an OpenAI API Key, and Git, enabling quick builds via the command line and supporting language parameters such as zh-Hans and en-US.'
|
|
4
|
+
'tags':
|
|
5
|
+
- 'Static Site Generator'
|
|
6
|
+
- 'Markdown'
|
|
7
|
+
- 'AI'
|
|
8
|
+
- 'Multilingual Translation'
|
|
9
|
+
- 'Minimalism'
|
|
10
|
+
- 'Documentation Tool'
|
|
11
|
+
- 'ZEN'
|
|
12
|
+
'inferred_lang': 'zh-Hans'
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
# ZEN - Minimalist Markdown + AI Static Site Builder
|
|
16
|
+
|
|
17
|
+
[> Website Demo](https://zen.zccz14.com/)
|
|
18
|
+
|
|
19
|
+
## Core Features
|
|
20
|
+
|
|
21
|
+
1. 📃 **Static Site Generation**: Build a static HTML site from any git-managed folder containing Markdown files.
|
|
22
|
+
2. 🧭 **Intelligent Categorization and Navigation**: Use AI to analyze content, generating site maps and navigation independent of source file locations.
|
|
23
|
+
3. 🌍 **Automatic Incremental Translation**: Use AI for incremental translation, allowing users to write Markdown in their native language while supporting multilingual output.
|
|
24
|
+
|
|
25
|
+
Why create another Markdown static site generator? I’ve reconsidered how documentation tools can better serve writers in the AI era:
|
|
26
|
+
|
|
27
|
+
- **Return to Content: Minimize Distractions, Focus on Writing**
|
|
28
|
+
|
|
29
|
+
Bring documentation back to its essence and restore tranquility to writing.
|
|
30
|
+
|
|
31
|
+
First, I don’t want to be a librarian. Sometimes I want to jot down ideas without having finalized titles or organized structures. I want LLMs to automatically generate titles, summaries, categories, navigation, and other organizational tasks.
|
|
32
|
+
|
|
33
|
+
Second, my workspace must stay clean. I don’t want complex build tools, intricate documentation configurations, or convoluted structures. Tools like Docusaurus, VuePress, and Astro with their configuration files and project structures give me a headache. ZEN hides all configurations in the `.zen` directory, tucked away in a corner. Users can focus solely on writing content, leaving the rest to ZEN. All other directories are your writing space—organize your Markdown files however you like.
|
|
34
|
+
|
|
35
|
+
- **Return to Native Language: Write in Your Mother Tongue, Seamlessly Build Multilingual Versions**
|
|
36
|
+
|
|
37
|
+
Life is short; I can’t be bothered with translation. People think most deeply when using their native language. Yet, staying connected to the world is essential—I don’t want to give up multilingual communication. I wanted a tool that lets me write in my native language while making my content accessible to more people. Traditional i18n requires manual translation and content maintenance, which is too cumbersome. I chose to use LLMs for translation, saving significant time and enabling one-click multilingual translation.
|
|
38
|
+
|
|
39
|
+
## Quick Start
|
|
40
|
+
|
|
41
|
+
Prerequisites:
|
|
42
|
+
|
|
43
|
+
- [Node.js](https://nodejs.org/) installed (version 18 or higher recommended, with `npx` command available)
|
|
44
|
+
- An [OpenAI API Key](https://platform.openai.com/account/api-keys) or compatible OpenAI API key
|
|
45
|
+
- Git installed (used to list Markdown files from Git, ignoring files filtered by `.gitignore` rules)
|
|
46
|
+
|
|
47
|
+
First, work within a folder already managed by Git:
|
|
48
|
+
|
|
49
|
+
Set environment variables:
|
|
50
|
+
|
|
51
|
+
```bash
|
|
52
|
+
export OPENAI_API_KEY="sk-xxxxxx" # Required: Replace with your OpenAI API Key
|
|
53
|
+
export OPENAI_BASE_URL="https://api.openai.com/v1" # Optional, defaults to OpenAI's official API
|
|
54
|
+
export OPENAI_MODEL="gpt-3.5-turbo" # Optional, defaults to the gpt-3.5-turbo model
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
Build the site with support for multilingual translation. Use the current directory as the source and output to the `.zen/dist` directory.
|
|
58
|
+
|
|
59
|
+
- Specify language versions using the `--lang` parameter multiple times (e.g., `--lang zh-Hans --lang en-US`).
|
|
60
|
+
- No need to configure the source language—ZEN automatically detects it.
|
|
61
|
+
|
|
62
|
+
```bash
|
|
63
|
+
npx zengen@latest build --lang zh-Hans --lang en-US
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
**View more parameters or help**:
|
|
67
|
+
|
|
68
|
+
```bash
|
|
69
|
+
npx zengen@latest
|
|
70
|
+
```
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
---
|
|
2
|
+
'title': 'ZEN - Minimalist Markdown + AI Static Site Builder'
|
|
3
|
+
'summary': 'ZEN is a static site generator with AI capabilities, designed specifically for Markdown documents. It allows users to convert a Git folder containing Markdown files into a static HTML site without complex configuration—all settings are hidden in the .zen directory. Core features include intelligent categorization and navigation (using AI to analyze content and generate a sitemap), automatic incremental translation (supporting multilingual versions, enabling users to write in their native language with AI handling translation), and a minimally disruptive writing experience. The quick start guide requires installing Node.js, obtaining an OpenAI API Key and Git, building the site via the command line, and supports specifying languages and base URLs.'
|
|
4
|
+
'tags':
|
|
5
|
+
- 'Static Site Generator'
|
|
6
|
+
- 'Markdown'
|
|
7
|
+
- 'AI'
|
|
8
|
+
- 'Multilingual Translation'
|
|
9
|
+
- 'Minimalism'
|
|
10
|
+
- 'Documentation Tool'
|
|
11
|
+
- 'Git'
|
|
12
|
+
'inferred_lang': 'zh-Hans'
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
# ZEN - Minimalist Markdown + AI Static Site Builder
|
|
16
|
+
|
|
17
|
+
[> Website Demo](https://zen.zccz14.com/)
|
|
18
|
+
|
|
19
|
+
## Core Features
|
|
20
|
+
|
|
21
|
+
1. 📃 **Static Site Generation**: Build any Git folder containing Markdown files into a static HTML site.
|
|
22
|
+
2. 🧭 **Intelligent Categorization and Navigation**: Uses AI to analyze content, generating a sitemap and navigation that is insensitive to source file locations.
|
|
23
|
+
3. 🌍 **Automatic Incremental Translation**: Uses AI for incremental translation, allowing users to write Markdown in their native language while supporting multilingual output.
|
|
24
|
+
|
|
25
|
+
Why create another Markdown static site generator? I've reconsidered how documentation tools can better serve writers in the AI era:
|
|
26
|
+
|
|
27
|
+
- **Return to Content: Minimize Distractions, Focus on Writing**
|
|
28
|
+
|
|
29
|
+
Bring documentation back to its essence and restore tranquility to writing.
|
|
30
|
+
|
|
31
|
+
First, I don't want to be a librarian. Sometimes I want to jot down ideas without having finalized titles or organizational structures. I want LLMs to automatically generate titles, summaries, categories, navigation, and other organizational tasks.
|
|
32
|
+
|
|
33
|
+
Second, my workspace must stay clean. I don't want complex build tools, cumbersome documentation configurations, or intricate structures. Every time I see the configuration files and project structures of tools like Docusaurus, VuePress, or Astro, I get a headache. Now, ZEN hides all configurations in the `.zen` directory, tucked away in a corner. Users only need to focus on writing content; ZEN handles the rest. All other directories are your writing space—organize your Markdown files freely.
|
|
34
|
+
|
|
35
|
+
- **Return to Native Language: Write in Your Mother Tongue, Seamlessly Build Multilingual Versions**
|
|
36
|
+
|
|
37
|
+
Life is short; I can't be bothered with translation. People express their deepest thoughts best in their native language. Yet, staying connected to the world is essential, and I don't want to give up multilingual communication. I wanted a tool that lets me write in my native language while making my content accessible to a broader audience. Traditional i18n requires manual translation and content maintenance, which is too cumbersome. I chose to use LLMs for translation, saving significant time and enabling one-click multilingual translation.
|
|
38
|
+
|
|
39
|
+
## Quick Start
|
|
40
|
+
|
|
41
|
+
Prerequisites:
|
|
42
|
+
|
|
43
|
+
- [Node.js](https://nodejs.org/) installed (version 18 or higher recommended, with `npx` command available)
|
|
44
|
+
- [OpenAI API Key](https://platform.openai.com/account/api-keys) obtained, or an OpenAI-compatible API Key
|
|
45
|
+
- Git installed (used to list Markdown files from Git, ignoring files filtered by `.gitignore` rules)
|
|
46
|
+
|
|
47
|
+
First, work in a folder already managed by Git:
|
|
48
|
+
|
|
49
|
+
Set environment variables:
|
|
50
|
+
|
|
51
|
+
```bash
|
|
52
|
+
export OPENAI_API_KEY="sk-xxxxxx" # Required: Replace with your OpenAI API Key
|
|
53
|
+
export OPENAI_BASE_URL="https://api.openai.com/v1" # Optional, defaults to OpenAI's official API
|
|
54
|
+
export OPENAI_MODEL="gpt-3.5-turbo" # Optional, defaults to the gpt-3.5-turbo model
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
Build the site with support for multilingual translation. Uses the current directory as the source and outputs to the `.zen/dist` directory.
|
|
58
|
+
|
|
59
|
+
- Specify language versions to generate using the `--lang` parameter multiple times (e.g., `--lang zh-Hans --lang en-US`).
|
|
60
|
+
- Specify the site's base URL prefix with the `--base-url` parameter (e.g., a repository name on GitHub Pages).
|
|
61
|
+
- No need to configure the source language; ZEN automatically detects it.
|
|
62
|
+
|
|
63
|
+
```bash
|
|
64
|
+
npx zengen@latest build --lang zh-Hans --lang en-US
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
**View more parameters or help**:
|
|
68
|
+
|
|
69
|
+
```bash
|
|
70
|
+
npx zengen@latest
|
|
71
|
+
```
|