HTML Help 專案合併大法：目錄、索引、全文搜尋一次整合，免重寫

場景：多款小遊戲合併為「遊戲樂園」，CHM 說明檔如何整合？

單獨發行小遊戲各有 CHM 說明，合併時若需重寫目錄、索引、全文搜尋字典，堪稱人生最大痛苦。所幸 Microsoft 提供 Merge (合併) 功能，可將目錄、索引、全文搜尋字典一次合併。

操作步驟

1. 新建主專案： 所有製作在新專案完成。
2. 合併檔案 (Merge Files)： 專案選項 → Merge Files 屬性頁 → 「新增」選擇欲合併的 .chm 檔。
   注意：非真正合併產生單一檔案，產出 CHM 大小與合併前幾乎相同，**發布時必須連同被合併的 CHM 一起發布**。
3. 合併目錄 (關鍵步驟)： 新專案加入新目錄檔 (.hhc) → 右鍵空白處 → 選「Insert File...」 → 對話框選被合併的 .chm → **關鍵：在檔名後手動輸入 ::contents.hhc** (如 game1.chm::contents.hhc)。contents.hhc 依實際目錄檔名填寫，屬於被合併專案而非當前專案。編譯後目錄即可連結被合併內容。

兩大避坑指南

1. 必須給主專案加入主題檔案 (.htm) 做預設頁 (封面皆可)。 否則開啟 CHM 如同 IE 開不存在頁面，雖合併了內容卻無入口。
2. HTML Help Workshop Bug： 欲使合併目錄節點成為某節點的子節點，編輯時**應讓它與父節點同層級**，而非縮排。
   跨 CHM 連結 (如 MSDN 常見) 非 Workshop 工作，需在主題檔 (.htm) 嵌入開啟 CHM 的 ActiveX 控制項實現。

善用 Merge 功能，模組化管理 CHM 專案，維護輕鬆愉快。