مولّد MD
تُنشئ صفحة الأدوات ← مولّد MD ملفات Markdown القياسية لأي مستودع. شاشة واحدة: اختر مشروعًا، اختر ملفًا، ثم ولّد.
الملفات التي يمكن إنشاؤها
Section titled “الملفات التي يمكن إنشاؤها”| الملف | المحتوى |
|---|---|
README.md | ما هو المشروع، وكيف يُشغَّل، وكيف يُدقَّق |
CONTRIBUTING.md | سير العمل: الفروع والمراجعة والدمج |
AUTHORS.md | الأشخاص الذين يعملون على المستودع |
SECURITY.md | كيفية الإبلاغ عن ثغرة |
CODE_OF_CONDUCT.md | السلوك المتوقَّع وآلية التطبيق |
CHANGELOG.md | التغييرات المهمّة لكل إصدار |
من القالب (الافتراضي، مجاني)
Section titled “من القالب (الافتراضي، مجاني)”لا يتطلّب تكامل ذكاء اصطناعي. يأتي المحتوى من البيانات الحقيقية لمشروعك:
- اسم المشروع ومسار المستودع ورابطه والفرع الافتراضي واللغة الأساسية ومزوّد Git
- الوحدات التي تتيحها باقتك - فقسم «التدقيق المعماري» في الـ README يذكر ما تستخدمه فعلًا فقط
- ولـ
AUTHORS.md، القائمة المتزامنة من لوحة المطوّرين مع استبعاد حسابات الخدمة
لا يُختلق أي شيء مجهول. لا يمكننا معرفة أمر البناء لديك ولا رخصتك، فيظهر مكانها سطر > **TODO:** واضح. فأمر npm run build خاطئ وواثق أغلى ثمنًا من فراغ ظاهر.
يُنتج وضع القالب الإنجليزية فقط. فالقالب المكتوب يدويًا لا يغطي إلا اللغات التي يتعهّدها أحد، وملف CONTRIBUTING مترجَم نصفيًا أسوأ من آخر إنجليزي متّسق - وهو العُرف المتّبع لهذه الملفات في المستودعات العامة أصلًا.
بالذكاء الاصطناعي (اختياري)
Section titled “بالذكاء الاصطناعي (اختياري)”يُفتح هذا الوضع عندما يضبط مشغّل التثبيت مزوّد ذكاء اصطناعي ويسمح باقتراحات الإصلاح؛ فلا تأتي مساحات العمل بمفاتيحها الخاصة. يتلقّى النموذج المعطيات نفسها التي يستخدمها القالب، والمسوّدة المولَّدة، وشريحة سطحية من المستودع: الوصف، والوسوم، وقائمة الجذر، وبضعة ملفات manifest (مثل package.json و*.csproj وgo.mod، مقتطعة) وملف README الموجود. ومهمّته تحسين الصياغة لا البحث في المشروع كلّه. وتُصان أسطر TODO.
ويظهر في هذا الوضع خيار إضافي واحد:
- لغة المستند - en وtr وde وfr وes وru وar وaz. الإنجليزية هي الافتراضية: فمن تكون لوحته بالعربية غالبًا ما يريد README بالإنجليزية.
وتظهر تكلفة الرموز في لوحة النتيجة مفصولةً إلى إدخال وإخراج. ويحاسب المزوّد عليها حساب المشغّل؛ والنموذج المستخدم هو النموذج الافتراضي للتثبيت.
المخرجات
Section titled “المخرجات”تحتوي لوحة النتيجة على تبويبَي المعاينة وMarkdown الخام، مع زرَّي النسخ والتنزيل. وتذكر الشارة بجانب اسم الملف اللغة التي وصل بها.