該如何合併多個HTML 幫助檔案

才智咖 人氣:3.01W

你有沒有想過,假如你單獨發行了若干小遊戲,併為這些小遊戲寫了 HTML 幫助。突然有一天,你打算把這些小遊戲集合起來搞成一個“遊戲樂園”,是不是要把它們的幫助文件原始檔() 再拿出來編譯一遍呢?新增 HTML 道是非常方便,可是那一堆目錄和索引,難道需要重寫嗎?――天啊,人生最痛苦的事莫過於此。

不過沒關係, 雖然有些時候 Microsoft 的東東的確很差勁,但這次,它想到了――提供了一個非常方便的合併(Merge) 功能,可以把目錄、索引甚至全文搜尋字典都合併起來。

怎麼開始呢?還記得在“設定工程選項(Project Options)”一節中最後介紹的內容嗎?對了,就是從這裡開始的:工程選項(Option) 對話方塊的 Merge Files 屬性頁。不過在這之前我們需要新建一個 HTML 幫助工程,所有制作將在這個工程中完成。

Merge Files 屬性頁裡只有新增(Add...) 和刪除(Remove) 兩個按鈕,它們的作用我想不必介紹了吧。只需要在這裡新增你想要合併的檔案,第一步就簡單的完成了。不過切記,這個合併不是真正意義上的合併――生成後的 HTML 幫助檔案大小和沒合併前幾乎一樣大。因此,釋出幫助文件的時候,需要將被合併的 HTML 幫助一起釋出。

現在還有一個問題,我編譯後找遍了所有連結,始終打不開被合併的幫助檔案啊,什麼地方搞錯了?不要著急,我們才剛剛完成第一步,不過做完這一步,被合併 HTML 幫助檔案的索引和全文搜尋字典都已經合併進來了,你沒找到嗎?那是你觀察不仔細。

下面,我們要做的第二步是合併目錄。

在剛才新建的工程中新增一個目錄檔案,當然,是新建的。然後右鍵單擊空白處彈出選單。選單的前兩項都已經在“為幫助檔案新增目錄(Contents)和索引(Index)”一節有介紹過了,第三項“Insert File...”才是本節的重頭戲。

點選“Insert File...”選單項,會彈出一個叫做“Include File”的對話方塊,選擇你要合併的 HTML 幫助檔案(),然後……還沒完,你還需要動手新增如下文字

::

前面的' 是你選擇的檔案,後面的 :: 是要你動手輸入的。其中 要根據實際你使用的目錄檔名來填寫,而這個目錄檔案是 的,不是當前工程的。如果還沒明白,看看下面注意事項的例圖。

編譯執行,一切正常,該合併的都合併了,從目錄裡就能找到被合併幫助檔案中的內容。不過,這個樣子好象還是有點不對勁啊――下面我來說說需要注意的地方。

第一,我們沒有給這個新工程新增主題檔案。有什麼後果?想想你用 IE 瀏覽一個不存在的頁面時會出現什麼樣的情況吧。任何一個 HTML 幫助都有一個預設頁的,我們新建這個工程也不例外,雖然它合併了其它的 HTML 幫助,但是――還是沒有自己的預設頁啊。結論:無論如何要給它新增一個主題檔案,就算是封面好了。

第二,HTML Help Workshop 在這裡有一個 BUG,為免費BUG,你需要注意的第二點就是:想要目錄中的併入檔案節點是子某個節點的位元組點,在編輯時應該讓它和這個節點同層次。 有時候我們會見到一從一個幫助頁中連結到另一個幫助檔案的例子,比如在 MSDN 中就非常多,這就是怎麼實現的呢?其實,這不是 HTML Help Workshop 的工作,而是主題檔案() 的工作。需要在 HTML 檔案中插入一個用開啟 HTML 幫助的 ActiveX 控制元件,這裡就不詳述了。