ايجاد Help در برنامه هاي وب

استفاده کنندگان برنامه هاي کامپيوتري همواره نيازمند توصيه ها و راهنمائي لازم به منظور استفاده از پتانسيل هاي يک برنامه مي باشند. ارائه توضيحات لازم در خصوص نحوه استفاده از يک برنامه کامپيوتري با استفاده از برنامه هاي کمکي که به Help معروف مي باشند ، صورت مي پذيرد. طراحي وپياده سازي Help در يک نرم افزار، امروزه خود به يک تخصص خاص تبديل شده است و قطعا" به عنوان يکي از پارامترهاي مهم در زمان انتخاب يک نرم افزار، مطرح خواهد بود (حداقل از جانب End Users ) . طراحان و پياده کنندگان نرم افزار با آناليز دقيق مخاطبان و نوع نياز آنا ن ، اقدام به طراحي و پياده سازي برنامه هاي help نموده و آنان را به عنوان جزء لاينفک نرم افزار ، ارائه مي نمايند . برنامه هاي وب نيز از اين قاعده مستثني نبوده و از روش هاي متفاوتي بمنظور ارائه Help ، استفاده مي نمايند . در اين مقاله ، قصد داريم به بررسي روش هاي متفاوت ارائه Help در برنامه هاي وب دات نت ، بپردازيم .
برنامه هاي وب ، به منظور ارائه Help از روش هاي متفاوتي نظير : ToolTip براي کنترل ها ، فرم هاي وب و يا صفحات HTML و يا فايل هاي HTML Help ترجمه شده ، استفاده مي نمايند . در ادامه به بررسي هر يک از موارد فوق ، خواهيم پرداخت .

نمايش ToolTip

ToolTip ، يک پيام کوتاه تشريحي است که پس از استقرار موس بر روي يک کنترل توسط کاربر ، براي مدت زمان بسيار محدودي نمايش داده مي شود . از اين نوع پيام ها در برنامه هاي نوشته شده تحت ويندور و به منظور ارائه اطلاعات مفيد دررابطه با دکمه هاي Toolbar و يا ساير کنترل هاي گرافيک، استفاده مي گردد. در زمان استفاده از آيکون ها و يا لينک ها ، مي توان از يک ToolTip که عملکرد آنان را براي کاربران تشريح مي نمايد ، استفاده نمود.
اکثر کنترل هاي سرويس دهنده ، داراي يک خصلت ToolTip مي باشند که مي توان از آن به منظور مقداردهي پيام مورد نظر جهت نمايش ، استفاده کرد. در زمان اجراء ، ASP.NET ، خصلت ToolTip را بعنوان خصلت عنوان کنترل ، براي مرورگر ارسال که IE آن را بعنوان يک ToolTip نمايش خواهد داد.
کنترل هاي HTML ، داراي خصلتي با نام ToolTip نمي باشند . در چنين مواردي مي توان ، خصلت title را مستقيما" استفاده نمود . تگ هاي HTML زير ، تفاوت موجود بين نحوه مقداردهي يک ToolTip براي يک کنترل سرويس دهنده و يک کنترل HTML را نشان مي دهد .

Setting ToolTip :: A server Control

<asp:Image id="Image1" runat="server" ImageUrl="100Four.gif" ToolTip="سايت سخاروش"></asp:Image>

Setting ToolTip:: An HTML Control

تمامي کنترل ها داراي خصلت ToolTip و يا title نمي باشند. مثلا" کنترل هاي سرويس دهنده DropDownList و ListBox ، امکانات فوق را دارا نمي باشند .

نمايش Help به عنوان فرم هاي وب و يا HTML

ايجاد محتويات Help با استفاده از فرم هاي وب و يا صفحات HTML ، از ساده ترين رويکردهاي موجود بمنظور ارائه توضيحات و اطلاعات کمکي در يک برنامه وب ، مي باشد . فايل هاي Help را مي توان در فولدر مربوط به محل استقرار پروژه ( فولدر محل استقرار برنامه وب ) و يا در يک فولدر زير مجموعه ، مستفر نمود. از hyperlink و يا ساير کنترل ها ، مي توان بمنظور نمايش Help در مرورگر استفاده نمود . روش فوق ، مشابه عملياتي است که دررابطه با ساير صفحات انجام مي شود. در اين رابطه يک تفاوت اساسي وجود دارد : نمايش Help در يک پنجره جديد و يا يک فريم جداگانه .
نمايش Help در يک پنجره جداگانه ، باعث نگهداري موقعيت کاربر در برنامه وب شده و امکان استفاده از Help و مقايسه توضيحات ارائه شده با عمليات و يا کار جاري را در اختيار کاربرقرار خواهد داد . به منظور نمايش Help در يک پنجره جداگانه ، مي توان از متد open مربوط به شي window ( سمت سرويس گيرنده ) ، استفاده نمود . کد زير ، نحوه انجام اين عمليات را نشان مي دهد :

Setting ToolTip :: A server Control

<a href="#" onclick="window.open('Help1.aspx','helpwin').focus()"> Help مشاهده </a>

در کد فوق از رويداد onclick به منظور نمايش Help در يک پنجره جديد مرورگر استفاده شده است .اولين آرگومان متد open ، فايل Help را مشخص مي نمايد ، دومين آرگومان نامگذاري پنجره جديد را انجام مي دهد ( زمينه هدايت ساير Help هاي زير مجموعه به پنجره يکساني فراهم خواهد شد). متد focus ، اطمينان لازم در خصوص نمايش پنجره Help در قسمت بالاي برنامه وب را بوجود مي آورد.
ساير Heperlink هاي مربوط به Help در يک برنامه وب مي توانند با استفاده از روش فوق ، از اسکريپت ساده onclick به منظور نمايش عناوين متفاوت در پنجره يکساني، استفاده نمايند . در صورتيکه ، برنامه وب موجود داراي چندين hyperlink در رابطه با نمايش help در يک فرم وب باشد ، مي توان اسکريپت را در يک روتين مستقر نمود و آن را در زمان تحقق رويداد onclick ، فراخواند . کد زير نحوه انجام اين کار را نشان مي دهد :

Place Script in a procedure

<HTML>
      <HEAD>
        <title> WebForm1 </title>
    <script language="vbscript">
         Sub ShowHelp(topicName)
             Set HelpWindow = window.open(topicName ,"helpwin" , "left=600 , height = 300 , width = 200 " )
             HelpWindow.focus
         End Sub
     </script>
         </HEAD>
          <body>
            <h2 align="right"><FONT size="3" color="#000099">نمايشراهنماي برنامهدر يک پنجرهجديد</FONT></h2>
            <A onclick=" showHelp('Help1.aspx') " href="#">نمايش راهنمايبرنامه</A><Br>
            <A onclick=" showHelp('Help2.aspx') " href="#">نمايشتوضيحات ضروريبرنامه</A>
</body>
</HTML>

نمايش HTML Help

با استفاده از متد showHelp مربوط به شي window ، مي توان فايل هاي HTML Help ، فايل هاي HTML معمولي و يا فرم هاي وب را توسط نمايش دهنده HTML Help ( فايل hh.exe ) ، نمايش داد. يک فايل HTML Help ، شامل فايل هاي عناوين نوشته شده به HTML بوده که به يک فايل فشرده و جداگانه تبديل شده اند . اين نوع فايل ها ، ويژگي هاي اضافه اي را در رابطه با Help ارائه مي نمايند . متد showHelp ، عناوين را در نمايش دهنده HTML Help ، نمايش خواهد داد (بصورت پيش فرض در بالاي صفحه مربوط به پنجره مرورگر برنامه وب ) . به منظور نمايش يک فرم وب و يا صفحه HTML با استفاده از showHelp ، نام فرم وب و يا صفحه HTML را مي بايست بعنوان اولين آرگومان متد، مشخص نمود.

Show Help with HTML Help Viewer

<a href="#" onclick="window.showHelp('Help1.aspx')">مشاهده راهنما</a>

با استفاده از متد Showhelp ، مي توان فايل هاي Help ترجمه شده را نيز مشاهده نمود . اين نوع فايل ها از صفحات HTML تشکيل شده که در نهايت به يک فايل ترجمه مي گردند ( فايلي با انشعاب chm ) . براي ايجاد اين نوع از فايل ها مي بايست از برنامه HTML Help Workshop استفاده گردد . به منظور نمايش يک فايل ترجمه شده ، مي بايست نام آن بعنوان اولين آرگومان متد showHelp مشخص گردد .

Show a Compiled HTML Help File by showHelp method

<a href="#" onclick="window.showHelp('C:\\php_manual_en.chm')">PHP مشاهده راهنماي</a>

HTML فوق ، فايل ترجمه شده اي با نام php_manual_en.chm را نمايش خواهد داد . فايل Help ترجمه شده ،مي بايست Download و بر روي ماشين کاربر ذخيره گردد .

استفاده از فايل هاي Help ترجمه شده ، داراي مزاياي زير است :

• کاهش اندازه : فايل هاي Help ترجمه شده ، عناوين را فشرده نموده و اندازه آنان بمراتب نسبت به مجموع ظرفيت يکايک عناوين ، کمتر مي باشد .
• محتوي ، ايندکس و ابزارهاي جستجو : برنامه HTML Help Workshop ، شامل ابزارهاي لازم به منظور ايجاد ويژگي هاي فوق و افزودن آنان به Help مي باشند .
• نمايش Embeded : کنترل اکتيوايکس HTML Help و اپلت جاوا ، امکان نمايش Help را بهمراه پنجره مرورگر فراهم مي نمايند(در مقابل نمايش آنان در يک پنجره جداگانه )
• محلي سازي ساده : با توجه به اينکه HTML Help ، فايل هاي عناوين را به Context ID مپ مي نمايد ، امکان استفاده از چندين فايل Help نوشته شده با زبان هاي متفاوت که جملگي از مجموعه يکساني Context ID ، استفاده مي نمايند، وجود خواهدداشت .
فايل هاي Help ترجمه شده ، داراي محدويت هاي خاص خود بوده که لازم است در زمان استفاده از اين نوع فايل ها ، به آنان توجه گردد :
• فايل منبع مي بايست داراي فرمت HTML باشد . فرم هاي وب نمي توانند به فايل هاي chm. ، ترجمه گردند .
• تمامي فايل ترجمه شده مي بايست بر روي ماشين کاربر ، مستقر( DownLoad ) گردند . در صورتيکه داراي يک فايل Help بزرگ بوده و کاربر با استفاده از يک مودم معمولي! به برنامه وب متصل مي گردد، مدت زمان زيادي صرف استقرار فايل بر روي ماشين کاربر خواهد شد.