風禹科技驗證有限公司 - 輔助說明檔 輔助說明檔 (Windows Help)

輔助說明檔是一種超文字介面的檔案,其利用鍵值的觀念來聯結,可達到理想的速查效果,此外該類形的檔案可利用在線上輔助,達到即學即用又可免去查閱使用者手冊的不便。

表 1 一般有如下之超文字檔

用途 附檔名 文字格式 編譯器 附註
DOS Help File HLP RTF Help Maker (HELPMAKE.EXE)
Windows 3.1 Help File HLP RTF HC.EXE, HCP.EXE
Windows 95/NT Help File HLP RTF HCW.EXE 新版 Windows 預設停用
Windows HTML Help CHM HTML HHW.EXE (mk:@MSITStore:chm檔案路徑::/內部路徑)
Windows HTML Help 2 HxS HTML Visual Studio .Net (內含) (ms-help://)
Vista Help H1S xml helpcompiler.exe 2006
Microsoft Help 3 mshc html Visual Studio 2010 Microsoft Help Viewer 1.0 (ms-xhelp://)
MicroStation Help File HC RTF I/Help 8.0 Source
WWW(HTML) HTM HTML -
其它 通常為 HLP 特定格式 -

微軟輔助說明檔發展史

DOS 3.3 ~ 6.22

Help Maker:HELPMAKE.EXE(編譯及解譯器均為本檔案)

自 MS-DOS 7.0 後微軟不再提供 DOS 版本的說明檔編譯器,我手邊也只有舊版本的,需要可從 Microsoft C/C++ 7.0 (MFC 1.0) 的磁片中抄出來,或 Microsoft Fortran 5.1 for DOS/Windows 的磁片中抄出來

瀏覽器為 QH.EXE,在 MS-DOS 6.22 中 QBASIC 及 EDIT 的說明檔也是這種格式

Windows 3.x

HC505.EXE Help Compiler 3.10.505:HC.EXE, HCP.EXE

What6.EXE What for Word 6.0a 用 Word 6.0 寫輔助說明檔 (Q140875)

範例預覽範例原始檔 :簡單介紹如何製作 Windows Help 檔案

Windows 95 / NT

Help Compiler WorkShop 4.03:HCW.EXE

這個年代我正好在當兵,所以沒有自己寫的完整範例,一共寫了兩個,最後都交接給別人了,但是 Windows 3.x 的範例仍相容於 Windows 95/NT,所以仍可參考上述範例

重要訊息:

新版的 Windows Vista / Longhorn Server 已不再內建 WinHelp 32 位元瀏覽程式,微軟建議開發者採用 HTMLHelp 取代,詳情可參見 KB917607,若仍有需要使用到 WinHelp32.exe ,可在此處下載,所下載之 WinHelp32.exe ,程式設計師或軟體經銷商均不授與散佈權,亦即 KB917607 的程式不可以直接包裝或複製交付給客戶使用,但可以註明 KB 的編號、連結,必須請客戶自行下載。

Windows 98

很多人不知道 Windows 98 有什麼不一樣,在檔案總管下按看看 [F1]

如果你的系統為 Windows 95,則必須安裝 IE4 或 IE5 或 HTMLHelp Compiler 1.31 (任一項) 才能觀看範例檔

在 Visual Studio .Net 內附的版本為 HTMLHelp 1.4 版,亦可至微軟網頁下載。

徐昇網自動分析:簡單範例原始碼部分可與網頁共用

曾文水庫防洪運轉資訊系統:簡單範例原始碼部分可與網頁共用

淹水預警分析(二):水庫防洪運轉:簡單範例原始碼部分可與網頁共用

有人問到檢視這兩個原始碼怎麼是網頁?沒錯!在寫 HTMLHelp 就是先寫網頁,寫好再將網頁檔指定給 HTML Help Workshop ,因此 HTML Help Workshop 會造一個專案檔 (*.hhp ,這個專案檔類似 Help Compiler 中的 HPJ 檔) ,只是網頁卻用不著這個專案檔,除此之外,網頁必須多三個檔,一個首頁檔分成兩個 Frame ,左邊的 Frame 連結內容及索引畫面共二個 HTML 檔,用這三個檔模擬 HTML Help 的殼,其它內容及影像檔則均為相同的,亦包含了 HTML Help Workshop 所造的 hhc 及 hhk 檔均相同

Office XP/Visual Studio .Net/MSDN

有安裝 Office XP 、 Visual Studio .Net 或是 MSDN 的網友或許已經注意到,微軟又推出一新的線上輔助說明檔,採用 Microsoft Document Explorer 7.0 瀏覽,查閱版本應屬 HTMLHelp 2.x 版,這個說明檔畫面可參考小範例

檔案編譯及聯結仍採用 HTML 格式,故上面小範例中,仍採

淹水預警分析(二):水庫防洪運轉:簡單範例原始碼部分可與網頁共用

為範例編譯展示,但其線上輔助說明啟動方式已與原先 HTMLHelp 不同,引數必須輸入正確瀏覽位置,故範例無法直接以檔案總管啟動

Visual Studio .Net 外掛程式:

  1. 2002 : VSHIK 2002
  2. 2003 : VSHIK 2003
  3. 2005 : VSHIK 2005

Windows Vista

Windows Longhorn 已經改採用 xml 來編寫輔助說明檔,2005/03 前,可在 http://longhorn.msdn.microsoft.com/ 找到,但 4 月起,改為 http://winfx.msdn.microsoft.com/ 後,就找不到說明文件了,其後 Vista 上市,已證明此格式作廢,仍持續使用舊型的 HTMLHelp。

下載"Longhorn" Help authoring walkthrough

Microsoft Help 3

目前僅有 MSDN Library for Visual Studio 2010 使用,是我長期追隨 Microsoft Help 中,我認為最爛的版本。我在網誌上有針對此一狀況評論:

2010/05/30: [VS2010]MSDN Library for Visual Studio 2010 的安裝與小評

註:執行檔均為原版軟體下載,版權屬發行公司所有


WinHelp 快速製作

若不求能製作複雜連結的輔助說明檔,可以利用下述方法依序完成。

1. 將 DOC 檔以「另存新檔」存成 RTF 格式;輔助說明檔之編譯器無法編輯太過複雜的表格,尤其需將格線去除;另外檔案中若有圖檔的情形,可能會造成記憶體不足,若在編譯時期顯示出記憶體不足的錯誤訊息,請將圖形去除,圖形修改加入輔助說明檔的方法,將在進階功能製作中說明。

2. 加入主題 ( Content ) 。去除整篇文章最前面的空白及跳行的字元,在整篇文章最前面的文字插入註腳;選取功能表「插入」的「註腳...」,選「自定標記」並打入「 # 」;之後會到註腳列,打入 contents 並去掉前面之空白。這裡並不一定必須為 contents ,不過通常都用 contents ,此文字為變數名,任何打入文字均需符合變數名命名原則即可;完成後存檔並關閉,未關閉的檔案是無法進行編譯的。

3. 使用記事本編輯一個新檔,打入下列內容:

[OPTIONS]
CONTENTS=contents

[FILES]
filename.rtf

為簡單起見,先將本檔與前述儲存之 filename.rtf 存於同一目錄下,並以附檔名 HPJ 儲存後關閉。

4. 由程式管理員的主群組進入 MS-DOS 模式;檢查環境變數中的路徑是否有指到編譯器所在的目錄,並更改目錄區為上述的文字檔案目錄;打入下列內容:

C:\FILEPATH>HCP FILENAME[.HPJ] 或 C:\FILEPATH>HC FILENAME[.HPJ]

5. 使用 WinHelp.EXE 開啟 FileName.HLP 或由檔案管理員對該檔以滑鼠雙觸擊即可。

一個無任何功能的輔助說明檔已經完成了,是否很簡單呢?


WinHelp

在程式中呼叫輔助說明檔

語言 項目
Fortran 如何以程式碼啟動說明檔?

HTML Help

設定「搜尋」頁籤
建立新的 HTML Help範例壓縮檔
設定說明檔工具列「按鈕」
在 Internet Explorer 中無法顯示 HTML Help 內容及索引清單或框架無法正確顯示 HTMLHelp 內容清單轉換

相關中文參考書籍
WinHelp 桂思強,『深造 Excel VBA (I) 』,博碩, 11 章,民國 83 年。
侯俊傑譯,『深入 Visual C++ 』,松崗, 20 章,民國 83 年。
朱學亭,「Windows Help Compiler 說明檔設計實務」,旗標,民國 84 年 7 月。
HTMLHelp 張寶源譯,「Official Microsoft HTML Help 創作工具」,眳p,民國 87 年 7 月。

相關網站

所視即所得之編輯器 http://www.devgr.com/docs/whd.html
  http://www.shareware.com/
  http://www.download.com/
Visual Basic Explorer-HTMLHelp Center(for VB6) http://www.vbexplorer.com/htmlhelp.asp
  http://chih.copystar.com.tw/articles/htmlhelp.html

 

製作 MS-Windows Help 檔:步驟 ABC http://cyber.cs.ntou.edu.tw/class/topic/hyang_hlp/index.htm
  HelpMaster's WinHelp, HTML Help, Hypertext and Animation Site. By Josef Becker.
  HTML Help by The Web Design Group
  Web Workshop - Introducing HTML Help

本網站討論區與 tw.bbs.comp.lang.basic 轉信,亦可到成大資工 BBS basic 版討論


Web 位址: http://tlcheng.twbbs.org/TLCheng/