編譯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) HTML Help Workshop，預設安裝在 c:\Program Files\HTML Help Workshop\；

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_style.css
<DIR> chm
<DIR> html

4。編輯make_chm.bat：
根據你的實際情況修改相應選項：
rem Path of the PHP CLI executable
set PHP_PATH=C:\php5\php.exe

rem Path of the Help Compiler command line tool
set PHP_HELP_COMPILER="c:\Program Files\HTML Help Workshop\hhc.exe"

rem The language of the manual to compile
set PHP_HELP_COMPILE_LANG=zh

rem The source directory with the original DSSSL made HTML
set PHP_HELP_COMPILE_DIR=.\html

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

5。點擊“開始”－＞“運行”－＞“cmd”，在命令列下進入相應目錄，輸入：
make_chm.bat

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

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

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

使用步驟：

1. 得到最新的phpdoc html檔案； 可以查看xsl/version.xml來得到版本資訊，確保編譯最新的手冊。

2. 在phpdoc目錄下：
autoconf
./configure --with-chm=yes
make chm_xsl
選擇性參數： "--with-xsltproc=path" 指定 XSLTProc路徑

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

4. 下載http://cn.php.net/include/mirrors.inc
或者http://cn2.php.net/include/mirrors.inc
放到htmlhelp目錄下，與make_chm.bat同目錄。

5. 下載　http://cn.php.net/backend/notes/all.bz2
使用bunzip2 all.bz2命令解壓，同樣放到htmlhelp目錄下。

6. 把local_vars.php.src重新命名為local_vars.php，並根據實際情況修改其中配置。
7. 最後運行：
make_chm.bat

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