符合Windows98規范的幫助文件的開發

領測軟件測試網

符合Windows 98規范的幫助文件的開發
　　·衣秀勇 閆明

　　Windows 98的在線幫助系統較Windows 95有較大的改變，它使用的是一個以網絡超級文本（HTML）為特征的新型幫助系統，即HTML幫助系統。它是來自Microsoft公司的下一代聯機幫助系統，它使用Microsoft Internet Explorer的基礎組件來顯示幫助內容，它支持HTML、ActiveX、Java、腳本（Java 腳本和Microsoft Visual Basic腳本）以及HTML圖像格式（.jpeg、.gif、.png）。HTML幫助文件的擴展名也由Winhelp的.hlp變為.chm。一個典型的HTML幫助系統如圖1所示。

　　

　　圖1．一個典型的HTML幫助系統示例

　　鑒于以上原因，開發符合Windows 98規范的幫助文件就成為編程人員的迫切需要。Microsoft HTML Help Workshop正是Microsoft公司針對這種新型幫助系統而提供的一個集成開發環境，使用它您能簡捷、方便、快速地開發幫助文件。

　　1．創建幫助主題文件

　　創建一個幫助文件最重要的工作就是創建若干您需要的主題文件。HTML幫助的主題文件是使用超級文本語言（HTML）創建的HTML文件，其擴展名是.htm或.html。

　　您可以使用Microsoft HTML Help Workshop創建幫助主題文件，但是筆者認為使用Microsoft Word 97來創建更方便。因為Word 97可以把Word文檔（.doc）文件另存為HTML文件；甚至Word 97還包括一個將.doc文件轉換為HTML文件的批量文件轉換工具。這樣您就可以完全按您撰稿擬文的習慣編寫Word文檔文件，然后再轉換成HTML文件，而不必面對HTML復雜的源代碼。在Word 97中還可以使用插入（Insert）菜單定義超級鏈接（HTML Help Workshop中稱為正文鏈接）和書簽。

　　2．創建幫助項目文件

　　2.1 HTML Help Workshop的幫助項目文件

　　HTML 幫助項目 (.hhp) 文件是一個純文本文件，可以使用任何一個字處理軟件（如Windows的記事本等）打開并編輯它。HTML幫助項目文件將創建一個幫助文件將所需要的所有元素都聯系在一起。這些元素包括幫助主題文件 (.html， .htm)、 圖像文件 (.jpeg、.gif、.png)、索引文件 (.hhk)、內容文件 (.hhc)以及其他文件。它也包含關于如何編譯一個幫助項目文件及幫助文件界面的信息。最后HTML Help Workshop將所有的這些內容編譯成一個單個的幫助文件 (.chm) 。

　　2.2 創建幫助項目文件

　　進入Microsoft HTML Help Workshop，在File菜單下選擇New，在彈出的New對話框中選擇Project， HTML Help Workshop將啟動New Project向導，跟隨向導就可以創建一個幫助項目文件。在其中第三步，Existing Files（已存在的文件）應核選HTML files框（見圖2），以保證在第四步中能將使用Word 97制作的HTML文件包括在幫助項目文件中。

　　

　　圖2．New Project向導的第三步

　　3． 創建目錄（Content）文件

　　3.1目錄和目錄文件

　　幫助文件的目錄類似于Windows資源管理器的左半部分，其形式如圖1中左半部分窗口所示。目錄文件是包含一個幫助文件的所有目錄，而每個目錄又包含條目名稱（或條目標題）、跳轉到幫助主題的捷徑以及每個條目屬性的文件，該文件是一個HTML格式的文件。當用戶在幫助文件的目錄頁中單擊一個條目標題時，與該條目的標題相鏈接的HTML文件將被打開。

　　3.2 創建目錄文件

　　創建目錄文件有兩種方法：

　�。�1）在HTML Help Workshop中打開項目文件。在File菜單上單擊New選項，選擇Table of Contents，Workshop將創建一個未命名的目錄文件，將其保存。然后在項目文件窗口的Project選項卡中單擊“Chang project options（改變項目選項）”按鈕打開Options對話框并進入Files選項卡（見圖3），在Contents File欄中選擇剛保存的目錄文件。

　　

　　圖3．Project Options對話框

　�。�2）如果項目文件中尚沒有包括目錄文件，那么，在剛創建的項目文件的窗口中單擊Contents選項卡，HTML Help Workshop將顯示目錄文件尚未建立的提示并允許您創建一個新的目錄文件或打開一個已存在的目錄文件，選擇Create a New Contents File（創建一個新的目錄文件）（見圖4），單擊“OK”，HTML Help Workshop創建一個空的目錄文件。

　　

　　圖4．目錄文件尚未建立對話框

　　3.3 向目錄文件添加目錄

　　在Contents選項卡中單擊“Insert a heading”按鈕，出現“Tables of Contents Entry”對話框（見圖5），在該對話框的“Entry title”欄中輸入條目標題，并單擊“Add”按鈕為條目添加鏈接的幫助主題。

　　

　　圖5．“Tables of Contents Entry”對話框

　　單擊“Advanced”選項卡，在“Image index”欄中為條目指定圖標，如包含其他條目的條目可以用書形圖標，而其他條目用問號圖標，如圖1中所示。

　　在Contents選項卡中單擊“Insert a Page”按鈕；如果在單擊“Insert a Page”按鈕之前，您選擇的條目不包括別的條目且不被別的條目所包括，那么，HTML Help Workshop將詢問您是否要創建一個起始條目，否則單擊該按鈕將會增加一個子條目。

　　Contents選項卡中的其他按鈕的功能包括：刪除一個條目、改變一個條目的位置和級別以及修改目錄的屬性。

　　3.4 讓目錄文件包含另一個目錄文件

　　打開目錄文件，選擇一個條目，鼠標右鍵單擊，在彈出的菜單中單擊“Insert File”，在出現的Include File對話框中選擇另外一個目錄文件（.hhc），在您選擇的條目下將出現一條語句：INCLUDE:filename.hhc，其中filename.hhc代表您要包含的帶路徑的目錄文件名。

　　4．創建索引（Index）

　　4.1 關鍵字（Keyword）和索引文件

　　關鍵字是用戶可能用到的并與一個或多個幫助主題文件關聯在一起的字、詞或短語。索引文件(.hhk)也是一個HTML文件，它包含若干個關鍵字。當用戶在編譯過的幫助文件里單擊索引頁并選擇一個關鍵字時，幫助文件將顯示與這個關鍵字有關的幫助主題或顯示有關幫助主題的標題的列表。

　　4.2 創建索引文件

　　創建索引文件的方法與創建目錄文件完全相同。

　　4.3 創建關鍵字

　　打開項目文件，在Index選項卡中單擊“Insert a Keyword”按鈕，出現“Index Entry”對話框（該對話框與“Tables of Contents Entry”對話框十分相似），在“General” 選項卡的Keyword欄中輸入關鍵字的名稱，單擊“Add”按鈕指定與該關鍵字相關聯的幫助主題文件。

　　4.4 設置關鍵字跳轉到另一個關鍵字

　　打開索引文件，選擇你需要跳轉到另一個關鍵字的關鍵字，單擊“Edit Selection”按鈕，在“Index Entry”對話框中單擊“Advance”選項卡（見圖6），核選“Destination is Another Keyword（目的地是一個關鍵字）”框。單擊“General” 選項卡，單擊“Add”按鈕，在“File or URL”框中，輸入您需要跳轉到的關鍵字，單擊“OK”。

　　

　　圖6．“Index Entry”對話框的Advance選項卡

　　5．豐富幫助主題文件的內容

　　5.1 查看HTML文件的源代碼

　　查看HTML文件的方法有兩種。

　�。�1）在HTML Help Workshop的File菜單上單擊Open打開一個HTML文件。

　�。�2）在項目文件的“Project”選項卡或“Contents”選項卡中雙擊一個HTML文件或先選擇一個HTML文件，然后單擊“View HTML Source”按鈕。

　　HTML文件的源代碼將顯示在項目文件窗口的右半部分。

　　5.2 向HTML文件中插入HTML Help ActiveX控件

　　5.2.1 HTML Help ActiveX控件簡介

　　HTML Help ActiveX控件是ActiveX控件的一種，它是針對HTML幫助而設計的。向幫助主題文件中插入HTML Help ActiveX控件使您可以為您的幫助文件添加諸如快捷方式、相關主題、KLinks及Alinks等幫助文件的特征。HTML Help ActiveX控件所提供的功能和界面能在支持ActiveX技術的瀏覽器中顯示。

　　5.2.2 插入HTML Help ActiveX控件的一般方法

　�。�1）在Workshop中打開一HTML文件。

　�。�2）把光標放在HTML文件BODY部分的您希望ActiveX控件出現的地方。

　�。�3）在“Tags（標簽）”菜單上， 單擊 HTML Help Control （HTML幫助控件）， 出現HHCTRL向導（見圖7）。

　　

　　圖7．HHCTRL向導的 和

　　 步，在該對話框的“Specify the command（指定命令）”欄中選擇一個您將使用的命令名字，在ID name欄輸入控件的ID名稱；第二步選擇控件的顯示類型，缺省的顯示類型為按鈕（Button）；接著按屏幕上的提示繼續操作即將HTML幫助控件插入HTML文件。向HTML文件中插入HTML Help ActiveX控件都采用這種方法，以下不再贅述。

　　5.2.3 向HTML 文件中插入快捷方式（ShortCut）

　　使用一個快捷方式可以在幫助文件中打開或初始化一個可執行的程序。例如，用戶可以在幫助文件中單擊一個按鈕或者一個鏈接（如Windows 98幫助中的單擊此處）來啟動一個可執行的程序如（Windows的記事本）或對話框（如Windows的添加/刪除程序對話框）。插入快捷方式的步驟如下：

　�。�1）在HHCTRL向導的 步（見圖7）的Specify the command欄中選擇“ShortCut”。

　�。�2）在HHCTRL向導的“ShortCut”對話框（見圖8）中輸入該快捷方式要啟動的程序名稱（如Notepad.exe）及參數。

　　

　　圖8．HHCTRL向導的“ShortCut”對話框

　　5.2.4 向HTML文件中插入相關主題（Related Topics）

　　相關主題是出現在某個主題文件中包含與該主題文件相關的主題文件的鏈接的HTML Help ActiveX控件。插入相關主題的步驟如下：

　�。�1）在HHCTRL向導的 步（見圖7）的“Specify the command”欄中選擇“Related Topics”。

　�。�2）在HHCTRL向導的“Related Topics”對話框中輸入相關的主題文件的標題和路徑（見圖9）。

　　

　　圖9．HHCTRL向導的“Related Topics”對話框

　　5.2.5 向HTML文件中插入關鍵字鏈接（KLinks）

　　關鍵字鏈接（Keyword Links）簡稱KLinks，它是在已經加入到幫助主題文件中的關鍵字的基礎上建立的。 當用戶在幫助文件中單擊KLinks按鈕或鏈接時包含Keyword（與該Klink中的Keyword相同）的主題文件的標題將列表顯示。當在幫助主題文件中增加或減少關鍵字的時候，Klinks也自動地更新。使用Klink也能跳轉到另外的幫助文件的主題文件。

　　5.2.5.1 創建Klinks

　　創建Klinks的步驟如下：

　�。�1）向HTML文件加入關鍵字

　�、俅蜷_HTML文件，并將光標定位在BODY部分需要加入關鍵字的地方。

　�、谠贓dit菜單上單擊“Compiler information（編譯信息）”，啟動Compiler information對話框（見圖10），單擊Keywords選項卡。在Keywords選項卡中單擊“Add”按鈕，接著指定關鍵字；可以指定多個關鍵字，并用分號將它們分隔開。

　　

　　圖10．編譯信息對話框

　�。�2）向HTML文件插入關鍵字鏈接

　　向HTML文件插入關鍵字鏈接實際上就是向HTML文件插入一個命令為“Keyword Search”的HTML Help ActiveX控件，其方法如5.2.1節所述，其中需要說明的步驟如下：

　�、僭贖HCTRL向導的 步（見圖7）的“Specify the command”欄中選擇“Keyword Search”。

　�、谠贖HCTRL向導的“Keyword Search”對話框中單擊“Add”按鈕，輸入已在Compiler information對話框定義的關鍵字（見圖11）。

　　

　　圖11．HHCTRL向導的“Keyword Search”對話框

　　5.2.5.2 將Klinks關鍵字包括在索引文件中

　　在“Chang project options”對話框的“Files” 選項卡（見圖3）中核選“Include Keywords from HTML files（包括HTML文件中的關鍵字）”框，Klinks關鍵字將被包括在索引文件中。

　　5.2.6 向HTML 文件插入聯想鏈接（ALinks）

　　聯想鏈接（Associative Links）簡稱ALinks，它是在已經加入到幫助主題文件中的Alink Names的基礎上建立的。當用戶在幫助文件中單擊ALinks按鈕或鏈接時包含Alink Name（與該ALink中的Alink Name相同）的主題文件的標題將在一個對話框或彈出菜單中顯示。與關鍵字不同的是幫助文件用戶決看不到ALink Name。

　　創建Alinks的步驟除以下兩點外與創建Klinks的方法完全一致，有區別的兩點是：

　�。�1）在Compiler information對話框中要單擊Alink Names選項卡（見圖10）。

　�。�2）在HHCTRL向導的 步（見圖7）的“Specify the command”欄中選擇“ALink Search”。

　　5.2.7 用文字代替按鈕顯示HTML Help ActiveX控件

　　用以上所述的方法向HTML文件加入HTML Help ActiveX控件之后，HTML Help Workshop在HTML文件中也加入了一個Object標簽如下：

　　1 <OBJECT id=hhctrl type="application/x-oleobject"

　　2 classid="clsid:adb880a6-d8ff-11cf-9377-00aa003b7a11"

　　3 codebase="hhctrl.ocx#Version=4,72,7325,0"

　　4 width=100

　　5 height=100

　　6 >

　　7 <PARAM name="Command" value="KLink">

　　8 <PARAM name="Button" value="Text:KLinks">

　　9 <PARAM name="Item1" value="">

　　10 <PARAM name="Item2" value="管理部">

　　11 </OBJECT>

　　這是一個典型的HHCTRL向導所加入的標簽（不包括左面的行號），根據插入HTML Help ActiveX控件時選擇的命令不同其中第7行的“value”值有所不同。從第8行可以看出HTML Help ActiveX控件在HTML文件中缺省地以按鈕的方式顯示，要想以文字代替按鈕，只要將“Button”改成“Text”就可以了，這時第8行的“value”值也從原來顯示在按鈕上變為作為單獨的文字來顯示HTML Help ActiveX控件，它是不帶下劃線的，要想改成帶下劃線的文字只需在第8行和第9行之間加入類似下面的語句：

　　<param NAME="fONT" VALUE="VERDANA,8,0x000800,underline">如果您在HHCTRL向導中選擇的不是以文字顯示在按鈕上，那么第8行的“value”值也要修改成“Text:xxx”的形式。

　　5.3 向HTML 文件中插入JavaScript（Java腳本）

　　5.3.1 用正文鏈接代替按鈕顯示HTML Help ActiveX控件

　　請注意，本問題與5.2.7有所不同，5.2.7中顯示HTML Help ActiveX控件的方式是帶下劃線的文字，而本問題卻是以正文鏈接來顯示HTML Help ActiveX控件，其實是在HTML文件中又加入了JavaScript，實現的方法是：在創建HTML Help ActiveX控件時的HHCTRL向導的第二步（見圖7）中選擇“Hidden（only used for scripting）[隱藏（僅為腳本使用）]”，創建好HTML Help ActiveX控件之后，在Object標簽的下面加入類似以下的標簽：

　　<A HREF="JavaScript:hhctrl1 .Click()">KLink text link</A>

　　下面是一個典型的正文鏈接標簽：

　　<A HREF="sd-98-002.html">a text link </A>

　　從以上兩個標簽的比較可以看出新加入的標簽確實是一個正文鏈接（在Word 97中叫超級鏈接），區別是用一個JavaScript語句代替了鏈接要跳轉到的HTML文件。新加入標簽中的“hhctrl1”是在HHCTRL向導的 步所填入的HTML Help ActiveX控件的“ID Name”。

　　5.3.2 向HTML文件插入一個彈出式窗口（pop-up windows）

　　彈出式窗口是一個彈出在幫助主題之上的窗口。它的樣式能自動調整大小，以恰好容納它里面所有的文字和圖像。彈出式窗口一直保持在屏幕之上直到用戶用鼠標單擊其內部或外部的任何地方。該窗口的式樣如圖12所示：

　　

　　圖12．一個彈出式窗口的例子

　　要向HTML文件插入一個彈出式窗口，只需在HTML文件中加入類似于下面所列的語句：

　　<A HREF=

　　JavaScript:hhctrl.TextPopup("This is how a pop-up window looks.","Verdana,10",9,9,-1,-1)>here</A>

　　可以看出，以上語句也是一個修改了的正文鏈接。其中，括號中的文字就是顯示在彈出式窗口中的文字，您可以按該語句所示的格式修改成您需要的文字。

　　5.4 將鏈接指向另外幫助文件中的主題文件

　　將鏈接指向另外幫助文件中的主題文件的方法是將鏈接所指的幫助主題文件改成以下形式：*.chm::/*.htm。其中 個*號代表另外的幫助文件的文件名，第二個*號表示 個*號所表示的幫助文件中的幫助主題的文件名。

　　6．創建搜索（Search）

　　幫助文件的Search選項卡允許用戶在幫助文件的所有主題文件中搜索與用戶在Search選項
 

延伸閱讀

文章來源于領測軟件測試網 http://www.kjueaiud.com/