تقييم الموضوع :
  • 0 أصوات - بمعدل 0
  • 1
  • 2
  • 3
  • 4
  • 5
مقال- كيف تصنع ملفات المساعدة Help Files وتربطها مع برنامجك
#1
كاتب الموضوع : silverlight

كيف تصنع ملفات المساعدة Help Files وتربطها مع برنامجك

كلنا نصنع برامج أو نريد أن نصنع برامج مناسبة للاستخدام بواسطة أفراد أو شركات أو مؤسسات مختلفة ومن اهم الأشياء التي في الغالب يفتقر لها المبرمج هي عمل ملفات المساعدة Help Files وهذا النوع من الملفات نتركه غالبا الي أخر لحظة أي بعد أن نكون قد انتهينا من تصميم البرنامج وكتابة الكود وتأكدنا من انه يعمل بصورة مناسبة وبالتالي تكون الصورة النهائية قد اتضحت لنا ومن ثم نبدأ في التفكير في أن نضيف ملفات Help الي برامجنا وغالبا عن الكثير من المبرمجين عندما يصلون للنهاية يصبح الأمر مملا قليلا لهم وبالتالي تخرج ملفات المساعدة أو Help Files بشكل غير مكتمل ونضع فيها القليل من الأفكار السريعة حتى ننتهي من البرنامج ومن ثم نستطيع تسويقه الي العميل

في الواقع ملفات المساعدة من الأشياء المهمة التي يجب علينا أن نخطط لها جيدا ونهتم بأن نضع بها كل شئ عن البرنامج وكيفية استخدامه الي أخره من الأشياء الاخري التي نجدها في هذا النوع من الملفات

يجب علينا أن نفكر جيدا من سوف يستخدم البرنامج الذي نصممه هل هو شخص مؤهل ويجيد استخدام الكمبيوتر بكفاءة أم لا وما هي الخبرات التي لديه هل هو يستطيع بسهوله أن يتعامل مع البرنامج. أعتقد أننا عندما نقوم بتصميم ملفات Help يجب أن نتوقع أن المستخدم لا يعلم شيئا أو ببساطة يجب أن نخمن أن المستخدم ما هو إلا طفل صغير قام بالخطأ بفتح البرنامج بالصدفة اعتقادا منه انه مجرد لعبة يستطيع أن يمارسها لذا يجب علينا أن نعطي هذا المستخدم مهما كان شيئا واضحا ليفهمه حتى لو كان المستخدم طفلا صغيرا وطبعا إن من أهم المستخدمين للبرامج هم المبرمجون أنفسهم الذين غالبا ينظرون الي البرنامج بعيون تختلف تماما عن المستخدم العادي فهم بمثابة الناقد الفني للبرنامج بشكل عام

يجب أن نضع في اعتباراتنا الكثير والكثير عند تصميم ملفات المساعدة فهي بمثابة الدعم والسلاح السري الذي يستعين به المستخدم عندما لا يجد من يوضح له كيفية التعامل مع البرنامج أو عندما لا يجد من يقوم بتمرينه علي كيفية استخدام البرنامج

قد يبدو للبعض أن الامر بسيط وان علي المستخدم أن يفهم بنفسه كل شئ داخل البرنامج وقد يكتفي البعض بشرح العناوين الرئيسية للبرنامج وعلي المستخدم أن يقوم بالباقي ويبحث عن ما لا يستطيع فهمه

يجب عليك عزيزي المبرمج أن تفكر في سؤال واحد كم من البرامج صنعت وأجدت في صناعتها وأهملت أن تضيف لها ملفات Help تتناسب مع البرنامج؟

إن صناعة ملفات Help وربطها بالبرنامج الذي نصممه من أهم الأشياء التي يجب علنا أن نهتم بها جيدا والأن لنتحدث قليلا عن كيفية بناء ملفات Help

ما هي الأدوات التي نحتاجها؟

سنحتاج الي Editor وأيضا الي Help Compiler

برامج Editors كثيرة و يمكنك الاعتماد علي واحد من هذه البرامج
HTML Editor أو MS Word بشرط أن تحفظ الملفات علي شكل Web Page يمكنك أيضا استخدام MS FrontPage أو Notepad هذا طبعا لو أنت محترف في كيفية استخدامه لتصميم ملفات HTML أو ايضا يمكنك استخدام Visual Studio. Net IDE

أيضا كما ذكرت سوف نحتاج الي Help Compiler ويمكنك استخدام برنامج مثل MS HTM Help Workshop وهو برنامج متاح في مواقع ميكروسوفت وهو FREE يمكن أن تقوم بعمل تنزيل له من الرابط التالي
http://msdn.microsoft.com/library/de...pDownloads.asp

كيف نصنع ملفات HTML

أولا نستخدم أي Editor من البرامج التي ذكرناها سابقا ومن ثم نقوم بإنشاء ملف لكل HTML لكل عنوان علي حده وطبعا كل ملف من هذه الملفات يجب أن يكون كاملا بشكل جيد أعلم جيدا أنها ستكون مملة فإن المبرمج بطبيعته يهتم بالكود أكثر من ملفات Help في الواقع أنا شخصيا يصيبني الملل كثيرا عند كتابة ملفات Help لذا أعلم جيدا شعور المبرمج بشكل ما ولكن علينا أن نبذل القليل من الجهد وأن نجتهد بقدر الإمكان أن تعطي هذه الملفات شكل مناسب

يجب أن تهتم أن يكون هناك صفحة أو ملف كمقدمة Introduction للبرنامج توضح فيه الغرض الرئيسي من البرنامج بشكل عام أيضا بعض الصور المتحركة مثل Gif Files مثلا ثم نهتم بباقي الملفات التي توضح وتشرح علي سبيل المثال القوائم المختلفة والهدف من كل قائمة الي أخره وطبعا لا تنسي أن تضيف صفحة أخيرة تضع فيها كيفية الاتصال بالمبرمج أو الشركة المنتجة للبرنامج وتضع بها بعض العناوين و الأرقام التليفونية وروابط مختلفة الي صفحات الويب التي تشير إليك أو الي الشركة المنتجة للبرنامج وأيضا طريقة الاتصال في حالة لو احتاج المستخدم الي الاستفسار عن شئ غير موجود بملفات Help بشكل عام أنا مدرك أن المبرمج لن ينسي هذه الصفحة بالذات عموما حاول أن تفتح أكثر من برنامج مثلا وتري كيف تبدو ملفات Help ذلك سوف يعطيك بعض الأفكار المناسبة لكي تقوم بتصميم ملفات مماثلة

كيف نقوم بعمل Compiling للملفات التي قد قمنا بكتابتها وجمعها معا لكي ننتج ملف Help.chm بشكله النهائي ومن ثم نقوم بوضع رابط داخل البرنامج يشير الي هذا الملف
علينا الأن أن نستخدم HTML Help Workshop وإن كنت لا تجيد استخدامه عليك أن تتعلم كيف تفعل ذلك ممن أن تقرأ ملف Help المرفق معه علي سبيل المثال
طبعا لن أستطيع أن أشرح لك عزيزي القارئ كيفية استخدام برنامج HTML Help Workshop عليك أن تجتهد قليلا وهو برنامج سهل جدا لا تقلق سوف تتعلمه سريعا جدا مثلا عليك تتعلم كيف تضيف الملفات التي كتبتها وأيضا كيف تقوم بإنشاء Index وأيضا Table of Contents الي أخره من الأشياء الاخري التي نراها في ملفات المساعدة الموجودة بأي برنامج

كيف تربط بين ملف Help وبرنامجك

هناك ثلاثة طرق نستطيع من خلالها أن نربط بين ملفات Help البرنامج الذي نريد طرحه للمستهلك ربما هناك طرق أخري ولكن هذه هي الطرق التي أعرفها فقط

الطريقة الأولي: وهي تتم باستخدام System.Diagnostics.Process.Start من تحت قائمة Help أو Help Contents داخل برنامجنا والكود يكون بالشكل التالي وهذه الطريقة هي الأسهل علي الإطلاق علي أن نضع ملفات Help تحت Application StartPath


كود :
Public Class Form1

Private Sub ContentsToolStripMenuItem_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles ContentsToolStripMenuItem.Click
System.Diagnostics.Process.Start(Application.StartupPath & "\printing.chm")
End Sub

End Class
الطريقة الثانية: وهي أيضا طريقة سهلة وفيها نستخدم Help Class بحيث نضع ملف المساعدة تحت Application StartupPath ويتم استخدام هذا الكلاس لعرض Index أو لعرض ملف Help كما هو مبين في الكود التالي


كود :
Public Class Form1

Private Sub ContentsToolStripMenuItem_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles ContentsToolStripMenuItem.Click
Help.ShowHelp(Me, Application.StartupPath & "\printing.chm")
End Sub

Private Sub IndexToolStripMenuItem_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles IndexToolStripMenuItem.Click
Help.ShowHelpIndex(Me, Application.StartupPath & "\printing.chm")

End Sub

End Class
الطريقة الثالثة: يمكنك استخدام Help Provider Control F1 وهي تتم بإضافة هذا الكونترول من Toolbox الي الفورم الرئيسي مثلا وهذا الكونترول له صفات Properties يمكن استخدامها لعرض ملفات المساعدة وهي تسمح لك بإنشاء Context-sensitive help وأهم صفات هذا الكونترول هي HelpNameSpace Property و نصيحة لا تغير أو تحدد قيمة لهذه الخاصية إلا عن طريق الكود أي Dynamically أثناء التشغيل فلو قمت بتحديد قيمة لها من داخل Properties Window قبل بدئ البرنامج فإن الملف قد يعمل جيدا علي جهازك ولكنه لن يعمل عندما تقوم بتشغيل برنامجك علي كمبيوتر العميل أو عند تجريب برنامجك علي أي كمبيوتر أخر في الواقع انا لم أستطيع أن أقوم بتجارب لاستخدام الطريقة الثالثة مع نسخة الفيجوال استوديو 2008 لأني كنت بحاجة الي جهاز أخر أثناء كتابة هذا الموضوع لتأكيد ما كتبت لربما قامت ميكروسوفت بحل مشكلة HelpNameSpace عموما عزيزي القارئ حاول أن تجرب بنفسك وخصوصا لو كنت تمتلك أكثر من جهاز كمبيوتر في منزلك وتستطيع أن تزيد معلوماتك لو قرأت ودرست الامر بعناية فإن هدفي من هذا المقال كان مجرد مقدمة وفكرة عامة عن كيفية تصميم ملفات Help وربطها مع برنامجك عموما الكود التالي يعطي فكرة عن طريق استخدام Help Provider وتحديدا خاصية HelpNameSpace


كود :
HelpProvider1.HelpNamespace = Application.StartupPath & "\printing.chm"
مرفق مثال توضيحي يمكنك إنزاله من هذا الرابط

http://vb4arb.com/vb/uploaded/18_01349450912.zip

النسخة المستخدمة الفيجوال استوديو 2008
اللغة المستخدمة الفيجوال بيسك دوت نت

ملحوظة يمكنك بناء الملفات بأي لغة ويمكن أيضا انشاء اكثر من ملف Help ويمكنك تقسيم ملف Help الي أكثر من ملف كل شئ ممكن حاول تجرب بنفسك


بالتوفيق
أخوكم عمر
}}}



التنقل السريع :


يقوم بقرائة الموضوع: بالاضافة الى ( 1 ) ضيف كريم