لنشر المستندات كموقع ثابت، اطلب من وكيل ذكاء اصطناعي تحويلها إلى Markdown مع بيانات مقدمة YAML والصور محفوظة كملفات، ثم شغّل المولد الخاص بك. يقوم GroupDocs.Markdown.Mcp بالتحويل محليًا، لذا يمكن لـ Claude Desktop أو Claude Code أو Cursor أو GitHub Copilot إعداد محتوى Word وExcel والكتب الإلكترونية لـ Hugo أو Jekyll أو MkDocs أو Docusaurus دون إرساله إلى خدمة:

حوّل هذه المستندات إلى Markdown مع بيانات مقدمة، بنكهة GitHub، والصور محفوظة كملفات.

الإصدار خطوة بخطوة مع الإعدادات واستكشاف الأخطاء موجود في الوثائق: كيفية نشر المستندات إلى موقع ثابت كـ Markdown.

ما الذي يحتاجه مولد الموقع الثابت من المستند؟

ثلاثة أشياء: Markdown للمحتوى، بيانات مقدمة YAML للبيانات الوصفية، والصور كملفات في مسارات نسبية. يقرأ Hugo وJekyll وMkDocs وDocusaurus جميعًا بيانات المقدمة. ينتج convert_to_markdown الثلاثة عندما تختار الخيارات المناسبة له:

الخيار القيمة للموقع ما يفعله
frontMatter true يكتب YAML يحتوي على العنوان، المؤلف، الصيغة وعدد الصفحات في أعلى الملف
images "file" يكتب الصور بجوار ملف .md ويشير إليها بمسار نسبي
flavor "github" (default), or "commonmark" Markdown بنكهة GitHub هو ما تفترضه معظم المولدات؛ CommonMark يناسب سلاسل أدوات أكثر صرامة

تحقق من العنوان والمؤلف في أعلى كل ملف محوّل؛ إذا كانت فارغة أو خاطئة، اطلب من الوكيل ضبطها.

كيف أحول Word إلى Hugo Markdown؟

Hugo هو المولد وراء هذه المدونة، لذا هو المثال هنا. يحتوي التدفق على أربع خطوات، والوكيل ينفذها جميعًا.

  1. تحويل. نفّذ الأمر أعلاه على مجلد المستندات.
  2. تنظيم. يكتب الخادم الملفات؛ ترتيب المجلدات هو مهمة الوكيل.

    ضع كل ملف محوّل في مجلد يحمل اسم المستند، مع صوره في مجلد فرعي images بجواره.

  3. أضف المفاتيح التي يحتاجها القالب. غالبًا ما تتوقع قوالب Hugo وجود date أو weight. الأداة لا تكتبها، لذا اطلب:

    أضف weight إلى بيانات المقدمة لكل ملف، مرقمة بالترتيب الذي ذكرته.

  4. بناء. شغّل Hugo بنفسك. في هذه المرحلة تكون الملفات Markdown عادية مع بيانات مقدمة، ويعاملها المولد كأي صفحة.

بالنسبة لـ Docusaurus وMkDocs ينطبق نفس الناتج؛ فقط تخطيط المجلدات والمفاتيح الإضافية تختلف، وتصفها في الطلبين الثاني والثالث.

جلسة مثال (مختصرة)

أنت:   حوّل المستندات الثلاثة في /drafts إلى Markdown مع بيانات مقدمة، بنكهة GitHub، والصور كملفات. مجلد واحد لكل مستند.
الوكيل: convert_to_markdown (frontMatter: true, flavor: "github", images: "file") x 3
       تم إنشاء guide-onboarding/، guide-security/، price-list/ مع ملفات .md ومجلدات فرعية للصور. بيانات المقدمة تحتوي على العنوان، المؤلف، الصيغة وعدد الصفحات.
أنت:   أضف الوزن إلى كل ملف بالترتيب الذي ذكرته.
الوكيل: تم تحديث بيانات المقدمة للملفات الثلاثة بالوزن 10، 20 و30.

كيف أتحقق من النتيجة قبل النشر؟

تحققان يلتقطان تقريبًا كل مشكلة:

لكل ملف محوّل، قارن عدد صفحات المصدر بطول الـ Markdown.

المستند المكوّن من 60 صفحة والذي تحول إلى 3 كيلوبايت من Markdown هو PDF ممسوح أو تشغيل في وضع التقييم.

قوّم مجلد الصور لكل مستند والصور التي يشير إليها الـ Markdown.

ملف .md يشير إلى صور لم تُكتب أبدًا يظهر كصور مكسورة على الموقع. قم بفحص سريع للمصدر الأكثر فوضى قبل دفعة من مئتي مستند.

تحول مصادر Word وExcel مع الحفاظ على هيكلها: العناوين تصبح عناوين والجداول تتحول إلى جداول Markdown. تعتمد PDFs على طريقة إنشائها. التحويل الرقمي الأصلي يتحول بنظافة؛ أما المسح الضوئي فلا يتحول بأي معنى مفيد، لأن هذا الخادم لا يحتوي على خطوة OCR.

أي مفاتيح بيانات مقدمة أضيفها بنفسي؟

frontMatter: true يكتب العنوان، المؤلف، الصيغة وعدد الصفحات. تحقق من هذه القيم في كل ملف واطلب من الوكيل تصحيح أي منها فارغ أو خاطئ. التنقل، الترتيب، الوسوم والتواريخ هي مفاتيح تضيفها بعد التحويل، كما في الخطوة 3. لدمج خصائص المستند الغنية في بيانات المقدمة، اجمع هذا الخادم مع GroupDocs.Metadata.Mcp، الذي يقرأها، واجعل الوكيل يضيف المفاتيح؛ هذه المقالة لا تغطي ذلك.

حدود صادقة

بدون ترخيص يعمل الخادم في وضع التقييم، ولا يتم معالجة سوى الصفحات الثلاث الأولى، مع علامة مائية للتقييم على كل منها. موقع يُبنى من مخرجات غير مرخصة يرسل مقاطع من ثلاث صفحات للمستندات الطويلة. شغّل get_license_status قبل التحويل، واحتفظ بفحص “الطول مقارنة بالمصدر” في الحلقة.

الأسئلة المتكررة

كيف أحول Word إلى Hugo Markdown؟

اطلب من الوكيل تحويل المستند باستخدام frontMatter: true، images: "file" وflavor: "github"، ثم ترتيب الملفات في مجلد المحتوى الخاص بك. أضف أي مفاتيح خاصة بالقالب، مثل weight، في طلب ثانٍ.

هل يمكن لوكيل ذكاء اصطناعي نشر المستندات إلى موقع ثابت؟

يمكنه إعداد كل ما يحتاجه بناء الموقع: Markdown، بيانات مقدمة، ملفات الصور وتخطيط المجلدات. أنت تشغّل المولد، لذا يبقى البناء والنشر تحت سيطرتك.

هل يحدث التحويل محليًا؟

نعم. يعمل GroupDocs.Markdown.Mcp كعملية محلية عبر stdio ويقرأ المستندات من المجلد الذي قمت بتكوينه. المستندات التي تصبح عامة فقط بعد المراجعة تبقى على جهازك حتى تقوم بنشرها.

تعمق أكثر