wiki-vitepress
إنشاء مواقع VitePress من ويكي ماركداون
تحويل ملفات ويكي ماركداون المُنشأة إلى موقع VitePress ثابت أنيق وقابل للتصفح. يتضمن الوضع الداكن، ومخططات Mermaid مع وضع داكن支持和点击放大، ومخرجات بناء جاهزة للإنتاج.
下载技能 ZIP
在 Claude 中上传
前往 设置 → 功能 → 技能 → 上传技能
开启并开始使用
测试它
正在使用“wiki-vitepress”。 إنشاء موقع VitePress من صفحات ويكي
预期结果:
تم إنشاء دليل wiki-site/ مع .vitepress/config.mts (الوضع الداكن، Mermaid مُكوَّن)، custom.css (أنماط Mermaid الداكنة)، theme/index.ts (إعداد النقر للتكبير)، و 12 صفحة ويكي. الموقع يبني بنجاح إلى .vitepress/dist/.
正在使用“wiki-vitepress”。 تكوين مخططات Mermaid للوضع الداكن
预期结果:
تم تطبيق إصلاح الوضع الداكن ثلاثي الطبقات: 1) themeVariables في config.mts بألوان مخصصة، 2) تجاوزات CSS تستهدف عناصر .mermaid SVG، 3) استطلاع JavaScript في theme/index.ts لاستبدال الأنماط المضمنة. جميع المخططات تُعرض بشكل صحيح في الوضع الداكن.
安全审计
低风险Static analyzer detected 69 patterns but 68 are false positives from Markdown documentation (code fences mistaken for shell execution, crypto references in comments). One legitimate concern: innerHTML assignment at line 112 uses self-generated content (low risk). Safe to publish with documentation warning.
低风险问题 (1)
风险因素
⚡ 包含脚本 (1)
质量评分
你能构建什么
موقع التوثيق التقني
بناء موقع توثيق احترافي من ملفات ويكي ماركداون مع الوضع الداكن ومخططات تفاعلية.
تصدير قاعدة المعرفة
تحويل محتوى ويكي الداخلي إلى موقع ثابت قابل للتصفح لمشاركة المعرفة بين الفريق.
توثيق مشاريع المصدر المفتوح
إنشاء مواقع توثيق أنيقة مع مخططات Mermaid لمستودعات GitHub.
试试这些提示
إنشاء هيكل موقع VitePress في wiki-site/ مع تكوين الوضع الداكن ونسخ جميع ملفات .md wiki المُنشأة إلى المشروع.
إعداد تكوين VitePress مع إضافة Mermaid وتكوين متغيرات السمة الداكنة لم mermaid.themeVariables بما في ذلك primaryColor و nodeBorder وألوان الخلفية.
تنفيذ وظيفة النقر للتكبير لمخططات Mermaid عن طريق تغليف حاويات .mermaid مع مستمعي الأحداث الذين يفتحون نوافذ كاملة الشاشة عند النقر.
تشغيل ما بعد المعالجة لإصلاح مشاكل صياغة ماركداون، ثم بناء موقع VitePress باستخدام npm run docs:build وإخراج مجلد dist.
最佳实践
- استخدم setup() مع onMounted للتلاعب DOM، وليس enhanceApp() الذي يعمل أثناء SSR
- طبق الاستطلاع لعناصر Mermaid SVG لأنها تُعرض بشكل غير متزامن
- تأكد من أن جميع صفحات ويكي تحتوي على بيانات YAML الأمامية مع العنوان والوصف
避免
- لا تستخدم خيار المترجم isCustomElement للمعلمات العامة العارية - يسبب崩溃
- لا تعتمد فقط على CSS للوضع الداكن Mermaid - الأنماط المضمنة تتطلب استبدال JavaScript
- لا تحاول الوصول إلى DOM أثناء مرحلة SSR - document غير محدد