czon 0.1.1 → 0.1.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "czon",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "CZone - A minimalist Markdown documentation site builder",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/.zen/meta.json

@@ -1,106 +0,0 @@
-{
-  "version": "1.0.0",
-  "options": {
-    "verbose": true,
-    "langs": [
-      "zh-Hans",
-      "en-US",
-      "ja-JP",
-      "ko-KR",
-      "es-ES",
-      "fr-FR",
-      "de-DE",
-      "ru-RU",
-      "pt-PT",
-      "it-IT",
-      "nl-NL",
-      "pl-PL",
-      "sv-SE",
-      "fi-FI",
-      "da-DK",
-      "no-NO",
-      "zh-Hant",
-      "hi-IN",
-      "ar-SA",
-      "th-TH",
-      "vi-VN",
-      "id-ID",
-      "pt-BR",
-      "es-MX",
-      "tr-TR",
-      "uk-UA"
-    ]
-  },
-  "files": [
-    {
-      "hash": "6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed",
-      "path": "README.md",
-      "links": [
-        "https://zen.zccz14.com/",
-        "https://nodejs.org/",
-        "https://platform.openai.com/account/api-keys"
-      ],
-      "metadata": {
-        "title": "ZEN - 极简主义 Markdown + AI 静态站点构建器",
-        "summary": "ZEN 是一个结合 AI 的静态站点生成器，专注于简化文档写作和构建过程。它允许用户使用 Markdown 在 git 管理的文件夹中创建静态 HTML 站点，无需复杂配置，所有设置隐藏在 .zen 目录下。核心功能包括智能分类导航（通过 AI 分析内容生成站点地图）、自动增量翻译（支持多语言版本，用户可用母语写作，AI 处理翻译），以及最小化打扰的写作体验。工具依赖 Node.js、OpenAI API Key 和 Git，通过命令行快速构建，支持指定语言参数如 zh-Hans 和 en-US。",
-        "tags": ["静态站点生成器", "Markdown", "AI", "多语言翻译", "极简主义", "文档工具", "ZEN"],
-        "inferred_lang": "zh-Hans",
-        "tokens_used": {
-          "prompt": 1011,
-          "completion": 212,
-          "total": 1223
-        }
-      }
-    },
-    {
-      "hash": "579c3a203225b8b7aead541f42381de0619d8bc1d451d0d9c3267dbc74205503",
-      "path": "docs/test-katex.md",
-      "links": [],
-      "metadata": {
-        "title": "KaTeX 公式显示效果测试",
-        "summary": "该文档是一个用于测试KaTeX公式显示效果的示例，包含多个行内和块级数学公式，如E=mc^2、积分、导数、级数、分段函数、表格、矩阵等，旨在验证公式的正确渲染。",
-        "tags": ["KaTeX", "公式测试", "数学公式", "LaTeX", "显示效果", "文档示例"],
-        "inferred_lang": "zh-Hans",
-        "tokens_used": {
-          "prompt": 552,
-          "completion": 118,
-          "total": 670
-        }
-      }
-    },
-    {
-      "hash": "50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c",
-      "path": "docs/test-mermaid.md",
-      "links": [],
-      "metadata": {
-        "title": "Mermaid 图表测试文档",
-        "summary": "该文档是一个测试文件，用于验证 ZEN 中的 Mermaid 图表渲染功能。它包含了多种 Mermaid 图表类型的示例，如流程图、序列图、甘特图、类图、状态图和饼图，并包括一个错误语法测试以检查错误信息显示。文档旨在展示 Mermaid 集成在 ZEN 中的正常工作状态。",
-        "tags": ["Mermaid", "图表测试", "ZEN", "流程图", "序列图", "甘特图", "类图", "状态图"],
-        "inferred_date": "2024-01-01",
-        "inferred_lang": "zh-Hans",
-        "tokens_used": {
-          "prompt": 899,
-          "completion": 156,
-          "total": 1055
-        }
-      }
-    },
-    {
-      "hash": "9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc",
-      "path": "docs/tricks.md",
-      "links": [],
-      "metadata": {
-        "title": "ZEN文档日期声明使用技巧",
-        "summary": "本文档介绍了ZEN工具中在正文中直接声明日期的使用技巧，与传统Markdown通过YAML Frontmatter声明日期的方式对比，强调了ZEN的自动识别和智能处理功能，提升了用户体验，并适用于日记、博客等需要时间线的内容类型。",
-        "tags": ["ZEN", "日期声明", "Markdown", "AI处理", "时间线", "用户体验", "文档管理"],
-        "inferred_date": "2026-01-08",
-        "inferred_lang": "zh-Hans",
-        "tokens_used": {
-          "prompt": 417,
-          "completion": 135,
-          "total": 552
-        }
-      }
-    }
-  ]
-}

package/.zen/src/ar-SA/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md

@@ -1,121 +0,0 @@
----
-'title': 'وثيقة اختبار مخططات Mermaid'
-'summary': 'هذه الوثيقة هي ملف اختبار للتحقق من وظيفة عرض مخططات Mermaid في ZEN. تحتوي على أمثلة لأنواع متعددة من مخططات Mermaid، مثل المخططات الانسيابية، ومخططات التسلسل، ومخططات جانت، ومخططات الفئات، ومخططات الحالة، والمخططات الدائرية، وتتضمن اختبارًا لبناء جملة خاطئ للتحقق من عرض رسائل الخطأ. تهدف الوثيقة إلى عرض حالة عمل تكامل Mermaid في ZEN بشكل صحيح.'
-'tags':
-  - 'Mermaid'
-  - 'اختبار المخططات'
-  - 'ZEN'
-  - 'المخطط الانسيابي'
-  - 'مخطط التسلسل'
-  - 'مخطط جانت'
-  - 'مخطط الفئات'
-  - 'مخطط الحالة'
-'inferred_date': '2024-01-01'
-'inferred_lang': 'ar-SA'
----
-
-# اختبار مخططات Mermaid
-
-هذا ملف اختبار للتحقق من وظيفة عرض مخططات Mermaid في ZEN.
-
-## مثال على المخطط الانسيابي
-
-```mermaid
-graph TD
-    A[بداية] --> B{هل تستمر؟}
-    B -->|نعم| C[تنفيذ العملية]
-    B -->|لا| D[نهاية]
-    C --> E[فحص النتيجة]
-    E --> F{هل نجحت؟}
-    F -->|نعم| G[اكتمال]
-    F -->|لا| H[إعادة المحاولة]
-    H --> C
-    G --> D
-```
-
-## مثال على مخطط التسلسل
-
-```mermaid
-sequenceDiagram
-    participant المستخدم
-    participant النظام
-    participant قاعدة_البيانات
-
-    المستخدم->>النظام: تقديم الطلب
-    النظام->>قاعدة_البيانات: استعلام البيانات
-    قاعدة_البيانات-->>النظام: إرجاع النتيجة
-    النظام-->>المستخدم: عرض النتيجة
-```
-
-## مثال على مخطط جانت
-
-```mermaid
-gantt
-    title الجدول الزمني للمشروع
-    dateFormat  YYYY-MM-DD
-    section التصميم
-    تحليل المتطلبات     :مكتمل,    des1, 2024-01-01, 7d
-    تصميم النموذج الأولي     :نشط,  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 الحيوان {
-        +String الاسم
-        +int العمر
-        +void أكل()
-        +void نوم()
-    }
-    class الكلب {
-        +void نباح()
-    }
-    class القط {
-        +void مواء()
-    }
-
-    الحيوان <|-- الكلب
-    الحيوان <|-- القط
-```
-
-## مثال على مخطط الحالة
-
-```mermaid
-stateDiagram-v2
-    [*] --> خامل
-    خامل --> معالجة : بدء المعالجة
-    معالجة --> نجاح : نجاح المعالجة
-    معالجة --> خطأ : فشل المعالجة
-    نجاح --> [*]
-    خطأ --> [*]
-```
-
-## مثال على المخطط الدائري
-
-```mermaid
-pie title معدل استخدام المتصفحات
-    "Chrome" : 65.2
-    "Firefox" : 15.3
-    "Safari" : 12.5
-    "Edge" : 5.2
-    "أخرى" : 1.8
-```
-
-## اختبار بناء جملة خاطئ (يجب أن يعرض رسالة خطأ)
-
-```mermaid
-graph TD
-    A --> B
-    // هنا تعريف السهم مفقود
-    C --> D
-```
-
-يحتوي ملف الاختبار هذا على أنواع متعددة من مخططات Mermaid، للتحقق من عمل تكامل Mermaid في ZEN بشكل صحيح.

package/.zen/src/ar-SA/579c3a203225b8b7aead541f42381de0619d8bc1d451d0d9c3267dbc74205503.md

@@ -1,79 +0,0 @@
----
-'title': 'اختبار عرض صيغ KaTeX'
-'summary': 'هذا المستند هو مثال لاختبار عرض صيغ KaTeX، يحتوي على عدة صيغ رياضية داخل السطر وعلى مستوى الكتلة، مثل E=mc^2، التكامل، المشتقة، المتسلسلة، الدالة المتعددة التعريف، الجداول، المصفوفات، إلخ، ويهدف إلى التحقق من التصيير الصحيح للصيغ.'
-'tags':
-  - 'KaTeX'
-  - 'اختبار الصيغ'
-  - 'الصيغ الرياضية'
-  - 'LaTeX'
-  - 'تأثير العرض'
-  - 'مثال المستند'
-'inferred_lang': 'ar-SA'
----
-
-# اختبار عرض صيغ 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}
-$$
-
-اختبار صيغة تحتوي على حالات:
-
-$$
-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}
-$$
-
-اختبار صيغة تحتوي على نص:
-
-$$
-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/ar-SA/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md

@@ -1,70 +0,0 @@
----
-'title': 'ZEN - منشئ مواقع ثابتة بالماركداون والذكاء الاصطناعي بتصميم بسيط'
-'summary': 'ZEN هو منشئ مواقع ثابتة مدعوم بالذكاء الاصطناعي، يركز على تبسيط كتابة المستندات وعملية البناء. يسمح للمستخدمين بإنشاء مواقع HTML ثابتة باستخدام Markdown في مجلدات مُدارة بـ Git، دون حاجة لإعدادات معقدة، حيث يتم إخفاء جميع الإعدادات في دليل .zen. تشمل الميزات الأساسية: التنقل الذكي المُصنف (يولد خريطة الموقع عبر تحليل المحتوى بالذكاء الاصطناعي)، والترجمة التلقائية التدريجية (تدعم إصدارات متعددة اللغات، يمكن للمستخدمين الكتابة بلغتهم الأم، ويتولى الذكاء الاصطناعي الترجمة)، وتجربة كتابة بأقل قدر من الإزعاج. يعتمد الأداة على Node.js ومفتاح OpenAI API وGit، ويتم البناء عبر سطر الأوامر بسرعة، ويدعم معلمات لغوية محددة مثل zh-Hans وen-US.'
-'tags':
-  - 'منشئ مواقع ثابتة'
-  - 'ماركداون'
-  - 'ذكاء اصطناعي'
-  - 'ترجمة متعددة اللغات'
-  - 'تصميم بسيط'
-  - 'أدوات المستندات'
-  - 'ZEN'
-'inferred_lang': 'zh-Hans'
----
-
-# ZEN - منشئ مواقع ثابتة بالماركداون والذكاء الاصطناعي بتصميم بسيط
-
-[> عرض تجريبي للموقع](https://zen.zccz14.com/)
-
-## الوظائف الأساسية
-
-1. 📃 **إنشاء موقع ثابت**: تحويل أي مجلد يحتوي على Markdown ويُدار بـ Git إلى موقع HTML ثابت.
-2. 🧭 **تنقل وتصنيف ذكي**: استخدام الذكاء الاصطناعي لتحليل المحتوى، وإنشاء خريطة موقع وتنقل، دون حساسية لموقع الملفات المصدر.
-3. 🌍 **ترجمة تلقائية تدريجية**: استخدام الذكاء الاصطناعي للترجمة التدريجية، مما يسمح للمستخدمين بكتابة Markdown بلغتهم الأم، مع إمكانية توفير المحتوى بلغات متعددة.
-
-لماذا تم إنشاء منشئ موقع ثابت آخر بـ Markdown؟ لقد فكرت مرة أخرى في كيفية خدمة أدوات المستندات للكتّاب بشكل أفضل في عصر الذكاء الاصطناعي:
-
-- العودة إلى المحتوى: تقليل الإزعاج إلى الحد الأدنى، والتركيز على الكتابة
-
-  إعادة المستندات إلى جوهرها، وإعادة الهدوء إلى الكتابة.
-
-  أولاً، لا أريد أن أكون أمين مكتبة. أحيانًا أريد كتابة بعض المحتوى، لكن قد لا أكون قد فكرت في عنوانه بعد، أو لم أقم بتنظيمه بشكل خاص. أتمنى أن يساعدني الذكاء الاصطناعي تلقائيًا في إنشاء العناوين، والملخصات، والتصنيف، والتنقل، وغيرها من أعمال التنظيم.
-
-  ثانيًا، يجب أن يكون مكتبي نظيفًا. لا أريد أدوات بناء معقدة الإعداد، ولا التعامل مع إعدادات مستندات معقدة، ولا أحب الهياكل المعقدة. كلما رأيت ملفات إعداد وهياكل مشاريع أدوات مثل Docusaurus وVuePress وAstro، أشعر بالصداع. الآن، اختار ZEN إخفاء جميع الإعدادات في دليل .zen، ودفعها إلى الزاوية، بحيث يحتاج المستخدم فقط إلى التركيز على كتابة المحتوى، ويتولى ZEN الباقي. جميع الأدلة الأخرى هي مساحة الكتابة الخاصة بك، يمكنك تنظيم ملفات Markdown الخاصة بك كما تشاء.
-
-- العودة إلى اللغة الأم: الكتابة باللغة الأم، وبناء إصدارات متعددة اللغات بسلاسة
-
-  الحياة قصيرة، وأنا كسول للترجمة. عندما يستخدم الشخص لغته الأم، يكون قادرًا على استغلال عمق تفكيره إلى أقصى حد. ولكن في نفس الوقت، من الضروري الحفاظ على الاتصال بالعالم، ولا أريد التخلي عن التواصل متعدد اللغات. لذلك، أتمنى أن تكون هناك أداة تسمح لي بالكتابة بلغتي الأم، وفي نفس الوقت تسمح للمزيد من الأشخاص برؤية محتواي. حاليًا، يتطلب i18n الترجمة الذاتية بالإضافة إلى الحفاظ على تحديث المحتوى، وهذا أمر مزعج للغاية. اخترت استخدام الذكاء الاصطناعي لمساعدتي في الترجمة، مما وفر علي الكثير من الوقت، ويمكن إكمال ترجمة لغات متعددة بنقرة واحدة.
-
-## البدء السريع
-
-المتطلبات المسبقة:
-
-- تثبيت [Node.js](https://nodejs.org/) (يُفضل الإصدار 18 أو أعلى، مع وجود أمر npx)
-- الحصول على [مفتاح OpenAI API](https://platform.openai.com/account/api-keys)، أو مفتاح API متوافق مع OPENAI
-- تثبيت Git (لإدراج ملفات Markdown من Git، وتجاهل الملفات التي تستبعدها قواعد .gitignore)
-
-أولاً، اعمل داخل مجلد مُدار بـ Git بالفعل:
-
-تكوين متغيرات البيئة
-
-```bash
-export OPENAI_API_KEY="sk-xxxxxx"  # إلزامي: استبدل بمفتاح OpenAI API الخاص بك
-export OPENAI_BASE_URL="https://api.openai.com/v1"  # اختياري، يستخدم API الرسمي لـ OpenAI افتراضيًا
-export OPENAI_MODEL="gpt-3.5-turbo"  # اختياري، يستخدم نموذج gpt-3.5-turbo افتراضيًا
-```
-
-بناء الموقع، مع دعم الترجمة متعددة اللغات. استخدم الدليل الحالي كدليل مصدر، وأخرج إلى دليل `.zen/dist`.
-
-- يمكن تحديد إصدارات اللغة المطلوبة باستخدام معلمة `--lang` عدة مرات (مثل `--lang zh-Hans --lang en-US`).
-- لا حاجة لتكوين لغة المصدر، سيكتشف ZEN ذلك تلقائيًا.
-
-```bash
-npx zengen@latest build --lang zh-Hans --lang en-US
-```
-
-**عرض المزيد من المعلمات أو المساعدة**:
-
-```bash
-npx zengen@latest
-```

package/.zen/src/ar-SA/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md

@@ -1,71 +0,0 @@
----
-'title': 'ZEN - منشئ المواقع الثابتة البسيط باستخدام Markdown + الذكاء الاصطناعي'
-'summary': 'ZEN هو منشئ مواقع ثابتة مزود بوظائف الذكاء الاصطناعي، يهدف إلى تبسيط عملية كتابة المستندات وإنشاء المواقع. يسمح للمستخدمين بالتركيز على كتابة محتوى Markdown بلغتهم الأم، ويتعامل تلقائياً مع إنشاء العناوين، والتنقل عبر التصنيفات، والترجمة التدريجية، ويدعم إصدارات متعددة اللغات دون الحاجة إلى إعدادات معقدة. يعتمد الأداة على Node.js وواجهة برمجة تطبيقات OpenAI، ويبني المواقع بسرعة عبر سطر الأوامر، مما يجعله مناسباً للكتاب الذين يبحثون عن الكفاءة والبساطة.'
-'tags':
-  - 'منشئ المواقع الثابتة'
-  - 'Markdown'
-  - 'الذكاء الاصطناعي'
-  - 'البساطة'
-  - 'الترجمة متعددة اللغات'
-  - 'Node.js'
-  - 'OpenAI'
-'inferred_lang': 'zh-Hans'
----
-
-# ZEN - منشئ المواقع الثابتة البسيط باستخدام Markdown + الذكاء الاصطناعي
-
-[> عرض تجريبي للموقع](https://zccz14.github.io/ZEN/)
-
-## الوظائف الأساسية
-
-1. 📃 **إنشاء موقع ثابت**: تحويل أي مجلد git يحتوي على Markdown إلى موقع HTML ثابت.
-2. 🧭 **التنقل الذكي عبر التصنيفات**: استخدام الذكاء الاصطناعي لتحليل المحتوى، وإنشاء خريطة الموقع والتنقل، دون الحساسية لموقع الملفات المصدر.
-3. 🌍 **الترجمة التلقائية التدريجية**: استخدام الذكاء الاصطناعي للترجمة التدريجية، مما يسمح للمستخدمين بكتابة Markdown بلغتهم الأم، مع دعمهم بلغات متعددة.
-
-لماذا قمت بإنشاء منشئ مواقع ثابت آخر باستخدام Markdown؟ لقد فكرت مرة أخرى في كيفية خدمة أدوات المستندات للكتاب بشكل أفضل في عصر الذكاء الاصطناعي:
-
-- العودة إلى المحتوى: تقليل الإزعاج، والتركيز على الكتابة
-
-  إعادة المستندات إلى جوهرها، وإعادة الهدوء إلى الكتابة.
-
-  أولاً، لا أريد أن أكون أمين مكتبة. أحياناً أريد كتابة بعض المحتوى، لكنني قد لا أكون قد فكرت في عنوانه بعد، أو لم أقم بتنظيمه بشكل خاص. أتمنى أن يقوم LLM تلقائياً بإنشاء العناوين، والملخصات، والتصنيفات، والتنقل، وغيرها من أعمال التنظيم.
-
-  ثانياً، يجب أن يكون مكتبي نظيفاً. لا أريد أدوات بناء معقدة الإعدادات، أو التعامل مع إعدادات المستندات المعقدة، ولا أحب الهياكل المعقدة. كلما رأيت ملفات الإعدادات وهياكل المشاريع الخاصة بأدوات مثل Docusaurus وVuePress وAstro، أشعر بالصداع. الآن، اختار ZEN إخفاء جميع الإعدادات في مجلد `.zen`، ودفعها إلى الزاوية، بحيث يركز المستخدم فقط على محتوى الكتابة، ويتولى ZEN الباقي. جميع المجلدات الأخرى هي مساحة الكتابة الخاصة بك، ويمكنك تنظيم ملفات Markdown الخاصة بك كما تشاء.
-
-- العودة إلى اللغة الأم: الكتابة بلغتك الأم، وإنشاء إصدارات متعددة اللغات بسلاسة
-
-  الحياة قصيرة، وأنا كسول للترجمة. عندما يستخدم الإنسان لغته الأم، يكون قادراً على استغلال عمق تفكيره بشكل أفضل. ولكن في نفس الوقت، من الضروري الحفاظ على الاتصال بالعالم، ولا أريد التخلي عن التواصل متعدد اللغات. لذلك، أتمنى أن تكون هناك أداة تسمح لي بالكتابة بلغتي الأم، وفي نفس الوقت تسمح للمزيد من الأشخاص برؤية محتواي. حالياً، تتطلب i18n الترجمة الذاتية بالإضافة إلى الحفاظ على تحديث المحتوى، وهذا أمر مزعج للغاية. اخترت استخدام LLM لمساعدتي في الترجمة، مما وفر علي الكثير من الوقت، ويمكن إكمال ترجمة لغات متعددة بنقرة واحدة.
-
-## البدء السريع
-
-المتطلبات المسبقة:
-
-- تثبيت [Node.js](https://nodejs.org/) (يُفضل الإصدار 18 أو أعلى، مع وجود أمر npx)
-- الحصول على [مفتاح واجهة برمجة تطبيقات OpenAI](https://platform.openai.com/account/api-keys)، أو مفتاح واجهة برمجة تطبيقات متوافق مع OPENAI
-- تثبيت Git (لإدراج ملفات Markdown من Git، وتجاهل الملفات التي تمت تصفيتها بواسطة قواعد .gitignore)
-
-أولاً، اعمل داخل مجلد تمت إدارته بواسطة Git:
-
-تكوين متغيرات البيئة
-
-```bash
-export OPENAI_API_KEY="sk-xxxxxx"  # إلزامي: يرجى استبداله بمفتاح واجهة برمجة تطبيقات OpenAI الخاص بك
-export OPENAI_BASE_URL="https://api.openai.com/v1"  # اختياري، يستخدم واجهة برمجة تطبيقات OpenAI الرسمية افتراضياً
-export OPENAI_MODEL="gpt-3.5-turbo"  # اختياري، يستخدم نموذج gpt-3.5-turbo افتراضياً
-```
-
-بناء الموقع، مع دعم الترجمة متعددة اللغات. استخدم المجلد الحالي كمجلد مصدر، وأخرج إلى مجلد `.zen/dist`.
-
-- يمكنك تحديد إصدارات اللغة المطلوبة عن طريق استخدام معلمة `--lang` عدة مرات (مثل `--lang zh-Hans --lang en-US`).
-- يمكنك تحديد بادئة عنوان URL الأساسي للموقع باستخدام معلمة `--base-url` (مثل اسم المستودع على GitHub Pages).
-- لا حاجة لتكوين لغة المصدر، سيكتشف ZEN ذلك تلقائياً.
-
-```bash
-npx zengen@latest build --lang zh-Hans --lang en-US
-```
-
-**عرض المزيد من المعلمات أو المساعدة**:
-
-```bash
-npx zengen@latest
-```

package/.zen/src/ar-SA/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md

@@ -1,71 +0,0 @@
----
-'title': 'ZEN - مُنشئ المواقع الثابتة البسيط باستخدام Markdown + الذكاء الاصطناعي'
-'summary': 'ZEN هو مُنشئ مواقع ثابتة مُدمج مع وظائف الذكاء الاصطناعي، مُصمم خصيصًا لمستندات Markdown. يسمح للمستخدمين بتحويل مجلد Git يحتوي على ملفات Markdown إلى موقع HTML ثابت، دون حاجة لإعدادات معقدة، حيث يتم إخفاء جميع الإعدادات في دليل .zen. تشمل الميزات الأساسية: التنقل الذكي المُصنف (باستخدام الذكاء الاصطناعي لتحليل المحتوى وإنشاء خريطة الموقع)، والترجمة التلقائية التدريجية (تدعم إصدارات متعددة اللغات، حيث يمكن للمستخدمين الكتابة بلغتهم الأم، ويتولى الذكاء الاصطناعي عملية الترجمة)، وتجربة كتابة بأقل قدر من الإزعاج. يتطلب دليل البدء السريع تثبيت Node.js، والحصول على مفتاح OpenAI API و Git، وبناء الموقع عبر سطر الأوامر، مع دعم تحديد اللغة وعنوان URL الأساسي.'
-'tags':
-  - 'مُنشئ المواقع الثابتة'
-  - 'Markdown'
-  - 'الذكاء الاصطناعي'
-  - 'ترجمة متعددة اللغات'
-  - 'البساطة'
-  - 'أداة توثيق'
-  - 'Git'
-'inferred_lang': 'zh-Hans'
----
-
-# ZEN - مُنشئ المواقع الثابتة البسيط باستخدام Markdown + الذكاء الاصطناعي
-
-[> عرض تجريبي للموقع](https://zen.zccz14.com/)
-
-## الوظائف الأساسية
-
-1. 📃 **إنشاء موقع ثابت**: تحويل أي مجلد git يحتوي على Markdown إلى موقع HTML ثابت.
-2. 🧭 **تنقل ذكي مُصنف**: استخدام الذكاء الاصطناعي لتحليل المحتوى، وإنشاء خريطة موقع وتنقل، دون حساسية لموقع الملفات المصدر.
-3. 🌍 **ترجمة تلقائية تدريجية**: استخدام الذكاء الاصطناعي للترجمة التدريجية، مما يسمح للمستخدمين بكتابة Markdown بلغتهم الأم، مع إمكانية توفير المحتوى بلغات متعددة.
-
-لماذا قمت بإنشاء مُنشئ مواقع ثابت آخر باستخدام Markdown؟ لقد فكرت مرة أخرى في كيفية خدمة أدوات التوثيق للكتّاب بشكل أفضل في عصر الذكاء الاصطناعي:
-
-- العودة إلى المحتوى: تقليل الإزعاج إلى الحد الأدنى، والتركيز على الكتابة
-
-  إعادة التوثيق إلى جوهره، وإعادة الهدوء إلى الكتابة.
-
-  أولاً، لا أريد أن أكون أمين مكتبة. أحيانًا أريد كتابة بعض المحتوى، لكن قد لا أكون قد فكرت في عنوانه بعد، أو لم أقم بتنظيمه بشكل خاص. أتمنى أن يساعدني LLM تلقائيًا في إنشاء العناوين، والملخصات، والتصنيف، والتنقل، وأعمال التنظيم الأخرى.
-
-  ثانيًا، يجب أن يكون مكتبي نظيفًا. لا أريد أدوات بناء معقدة الإعداد، أو العبث بتكوينات توثيق معقدة، ولا أحب الهياكل المعقدة. كلما رأيت ملفات الإعداد وهياكل المشاريع لأدوات مثل Docusaurus و VuePress و Astro، أشعر بالصداع. الآن، اختار ZEN إخفاء جميع الإعدادات في دليل .zen، ودفعها إلى الزاوية، بحيث يحتاج المستخدم فقط إلى التركيز على محتوى الكتابة، ويتولى ZEN الباقي. جميع الدلائل الأخرى هي مساحة الكتابة الخاصة بك، يمكنك تنظيم ملفات Markdown الخاصة بك كما تشاء.
-
-- العودة إلى اللغة الأم: الكتابة باللغة الأم، وبناء إصدارات متعددة اللغات بسلاسة
-
-  الحياة قصيرة، وأنا كسول للترجمة. عندما يستخدم الإنسان لغته الأم، يكون قادرًا على استغلال عمق تفكيره إلى أقصى حد. ولكن في نفس الوقت، يعد التواصل مع العالم ضروريًا، ولا أريد التخلي عن التواصل متعدد اللغات. لذلك أتمنى أن تكون هناك أداة تسمح لي بالكتابة بلغتي الأم، وفي نفس الوقت تسمح للمزيد من الأشخاص برؤية محتواي. حاليًا، يتطلب i18n الترجمة الذاتية بالإضافة إلى الحفاظ على تحديث المحتوى، وهذا مزعج جدًا. اخترت استخدام LLM لمساعدتي في الترجمة، مما وفر علي الكثير من الوقت، ويمكن إكمال ترجمة لغات متعددة بنقرة واحدة.
-
-## البدء السريع
-
-المتطلبات المسبقة:
-
-- تثبيت [Node.js](https://nodejs.org/) (يُوصى بالإصدار 18 أو أعلى، مع ضرورة وجود أمر npx)
-- الحصول على [مفتاح OpenAI API](https://platform.openai.com/account/api-keys)، أو مفتاح API متوافق مع OPENAI
-- تثبيت Git (لاستخدامه في سرد ملفات Markdown من Git، وتجاهل الملفات التي تستبعدها قواعد .gitignore)
-
-أولاً، اعمل داخل مجلد تمت إدارته بواسطة git بالفعل:
-
-تكوين متغيرات البيئة
-
-```bash
-export OPENAI_API_KEY="sk-xxxxxx"  # إلزامي: يُرجى استبداله بمفتاح OpenAI API الخاص بك
-export OPENAI_BASE_URL="https://api.openai.com/v1"  # اختياري، يستخدم API الرسمي لـ OpenAI افتراضيًا
-export OPENAI_MODEL="gpt-3.5-turbo"  # اختياري، يستخدم نموذج gpt-3.5-turbo افتراضيًا
-```
-
-بناء الموقع، مع دعم الترجمة متعددة اللغات. استخدم الدليل الحالي كدليل مصدر، وأخرج إلى دليل `.zen/dist`.
-
-- يمكن تحديد إصدارات اللغة المطلوبة من خلال استخدام معلمة `--lang` عدة مرات (مثل `--lang zh-Hans --lang en-US`).
-- يمكن تحديد بادئة عنوان URL الأساسي للموقع من خلال معلمة `--base-url` (مثل اسم المستودع على GitHub Pages).
-- لا حاجة لتكوين اللغة المصدر، سيكتشف ZEN ذلك تلقائيًا.
-
-```bash
-npx zengen@latest build --lang zh-Hans --lang en-US
-```
-
-**عرض المزيد من المعلمات أو المساعدة**:
-
-```bash
-npx zengen@latest
-```

package/.zen/src/ar-SA/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md

@@ -1,30 +0,0 @@
----
-'title': 'تقنيات استخدام إعلان التواريخ في وثائق ZEN'
-'summary': 'يقدم هذا المستند تقنيات استخدام إعلان التواريخ مباشرة في نص الوثيقة باستخدام أداة ZEN، مقارنةً بالطريقة التقليدية في Markdown عبر YAML Frontmatter. يُبرز المستند قدرات ZEN على التعرف التلقائي والمعالجة الذكية، مما يعزز تجربة المستخدم، ويناسب أنواع المحتوى التي تتطلب خط زمني مثل اليوميات والمدونات.'
-'tags':
-  - 'ZEN'
-  - 'إعلان التاريخ'
-  - 'Markdown'
-  - 'المعالجة بالذكاء الاصطناعي'
-  - 'الخط الزمني'
-  - 'تجربة المستخدم'
-  - 'إدارة الوثائق'
-'inferred_date': '2026-01-08'
-'inferred_lang': 'ar-SA'
----
-
-# نصائح الاستخدام
-
-## إعلان التاريخ في نص الوثيقة
-
-يمكنك استخدام عبارة مثل **"اليوم هو 8 يناير 2026"** في نص الوثيقة (بأي تنسيق حر)، وسيتعرف ZEN عليها ويعالجها تلقائيًا.
-
-في وثائق Markdown التقليدية، يتم إعلان التاريخ عبر YAML Frontmatter، مما يتطلب تذكر الحقول المناسبة، وإلا قد لا يتم التعرف على التاريخ بشكل صحيح.
-
-يدعم ZEN إعلان التاريخ مباشرة في نص الوثيقة، مما يتجنب مشكلة نسيان ملء حقول Frontmatter.
-
-سيقوم الذكاء الاصطناعي باستخراج واستنتاج معلومات التاريخ من نص الوثيقة تلقائيًا، ومعالجتها كتاريخ إنشاء الوثيقة.
-
-هذه الطريقة أكثر مرونة وذكاءً، مما يعزز تجربة المستخدم.
-
-بالمناسبة، يمكن للوثائق التي تحتوي على تواريخ إنشاء عرضًا زمنيًا، مما يسهل التصفح والإدارة. وهي مناسبة بشكل خاص لأنواع المحتوى التي تتطلب خطًا زمنيًا مثل اليوميات والمدونات.