[RaggiTech]

استخدام MAML مع DocProject

يمكِّنك DocProject من إضافة مواضيع ذات المحتوى المفاهيمي Conceptual Topics لشرح فكرة معينة عن طريقة عمل برنامجك أو مكتباتك, بالإضافة إلى إمكانية كتابة المقالات الإرشادية Walkthrough Topics, وغيرها من أنواع المواضيع الذي سبق ذكرها في قسم MAML )راجع أعلى الموضوع). يقوم DocProject بترجمة الملفات ذات محتوى MAML إلى ملفات HTML ثم بناء ملف CHM النهائي, يتم كل ذلك اعتمادا على Microsoft Sandcastle. لتحرير مواضيع المحتوى المفاهيمي يمكنك الاعتماد على محرّر XML الخاص بـ Visual Studio أو استخدام Microsoft XML Notepad ويمكنك تحميلها من خلال هذا الرابط
نقطة أخرى مهمة لم أشر في بداية الموضوع لها هي ضرورة وجود Microsoft Help Workshop والذي يحتوي الأدوات الضرورية لبناء ملفات CHM ويمكنك تحميله من هذا الرابط

في الخطوة التالية سأشرح كيفية إضافة موضوع ذو محتوى مفاهيمي إلى المشروع الذي أشاناه سابقا.
افتح المشروع الذي أنشأته سابقا من خلال Visual Studio.
من خلال أداة Toolbox والمسماة DocProject –Sandcastle, أنقر فوق الزرshow the topic explorer .
سيظهر إطار جديد ,والمسمى Topic Explorer ويحتوي على جزئين ToolBox علوي + أداة treeView والتي تمثل شجرة المواضيع وستظهر كما هي في ملف CHM الناتج



انقر فوق الزر الظاهر كما في الصورة



ستلاحظ إضافة ملف جديد باسم New Conceptual Topic بالامتداد الجديد AML والذي سبق الحديث عنه, طبعا يمكنك إعادة تسمية الملف كما ترغب



لاحظ كذلك أن هذا الموضوع يحتوي على معرف GUID يقوم هذا المعرف بتمييز الموضوع عن غيره لإضافته لاحقا كارتباط Link
ستلاحظ أيضا ظهور محتوى الملف في محرر XML الخاص بـ Visual Studio ويظهر كما في الصورة



قم ببناء مشروعك من جديد ولاحظ ملف CHM الناتج سيكون شبيه بالتالي


يتبع...