編譯chm格式PHP手冊的方法

微軟的chm檔案格式是很受我們喜愛的，因為它可以把很多HTML檔案打包成一個檔案，容易傳輸和分享。而且非常方便易用，支援索引、搜尋等。正因為這樣，大家通常都使用chm版本的PHP手冊。

php.net會定期編譯PHP手冊，提供各種版本供大家下載，包括chm格式。由於是定期編譯，所以我們拿到的永遠不會是最新的手冊。如果你想得到最新的手冊，就只能自己編譯了。而且php.net提供的中文手冊不能搜尋中文，索引也是亂碼。

　　Haohappy介紹一下編譯流程：

　　1。準備好HTML格式的手冊檔案。

有兩種途徑：

1)通過cvs下載手冊檔案，自己編譯出來（保證最新，但編譯過程要花費5個小時左右，生成6000多個檔案，要有耐心，唉。）

2)通過php.net下載打包好的html手冊，到本地解壓縮。

　　2。下載並安裝Microsoft(r)HTMLHelpWorkshop，預設安裝在c:ProgramFilesHTMLHelpWorkshop；

　　3。通過cvs下載chm手冊生成指令碼檔案，位於phpdoc/chm目錄下：

common.php

make_chm.README

make_chm.bat

make_chm.php

make_chm_fancy.php

make_chm_spc.gif

make_chm_

<DIR>chm

<DIR>html

　　4。編輯make_：

根據你的`實際情況修改相應選項：

remPathofthePHPCLIexecutable

setPHP_PATH=C:

remPathoftheHelpCompilercommandlinetool

setPHP_HELP_COMPILER="c:"

remThelanguageofthemanualtocompile

setPHP_HELP_COMPILE_LANG=zh

remThesourcedirectorywiththeoriginalDSSSLmadeHTML

setPHP_HELP_COMPILE_DIR=

注意，我們把要用到的HTML檔案的目錄設定為，所以我們要把所有HTML檔案放進去。

　　5。點選“開始”－＞“執行”－＞“cmd”，在命令列下進入相應目錄，輸入：

make_

如果順利，就會在chm/chm目錄下生成chm格式的PHP手冊了。

編譯帶評論（UserNotes）的PHP手冊：

在phpdoc/htmlhelp目錄下，存在另一個chm檔案編譯系統，用於生成extendedCHM檔案（即帶擴充套件功能的chm檔案）。

　　使用步驟：

1.得到最新的phpdochtml檔案；可以檢視xsl/來得到版本資訊，確保編譯最新的手冊。

2.在phpdoc目錄下：

autoconf

./configure--with-chm=yes

makechm_xsl

可選引數："--with-xsltproc=path"指定XSLTProc路徑

3.將HTML檔案放在phpdoc/htmlhelp/html目錄下（一般情況況執行完1之後會自動複製HTML檔案到該目錄）

4.下載

或者

放到htmlhelp目錄下，與make_同目錄。

5.下載

使用2命令解壓，同樣放到htmlhelp目錄下。

6.把local_重新命名為local_，並根據實際情況修改其中配置。

7.最後執行：

make_

編譯過程中會先生成一個評論相關的chm檔案，然後最後生成一個總的chm手冊。</p