 |
輔助說明檔 (Windows Help) |
|
輔助說明檔 (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 | 特定格式 | - |
微軟輔助說明檔發展史
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 的說明檔也是這種格式
HC505.EXE Help Compiler 3.10.505：HC.EXE, HCP.EXE
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 有什麼不一樣，在檔案總管下按看看 [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 外掛程式：
- 2002 : VSHIK 2002
- 2003 : VSHIK 2003
- 2005 : VSHIK 2005
Windows Longhorn 已經改採用 xml 來編寫輔助說明檔，2005/03 前，可在 http://longhorn.msdn.microsoft.com/ 找到，但 4 月起，改為 http://winfx.msdn.microsoft.com/ 後，就找不到說明文件了，其後 Vista 上市，已證明此格式作廢，仍持續使用舊型的 HTMLHelp。
目前僅有 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 或由檔案管理員對該檔以滑鼠雙觸擊即可。
一個無任何功能的輔助說明檔已經完成了，是否很簡單呢？
在程式中呼叫輔助說明檔
| 語言 | 項目 |
| Fortran | 如何以程式碼啟動說明檔？ |
| 設定「搜尋」頁籤 建立新的 HTML Help：範例壓縮檔 |
設定說明檔工具列「按鈕」 在 Internet Explorer 中無法顯示 HTML Help 內容及索引清單或框架無法正確顯示 HTMLHelp 內容清單轉換 |
| 相關中文參考書籍 | ||||
|
相關網站
| 所視即所得之編輯器 | 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 |
本網站討論區與 tw.bbs.comp.lang.basic 轉信，亦可到成大資工 BBS basic 版討論