微軟的chm文件格式是很受我們喜愛(ài)的，因?yàn)樗梢园押芏郒TML文件打包成一個(gè)文件，容易傳輸和分享。而且非常方便易用，支持索引、搜索等。正因?yàn)檫@樣，大家通常都使用chm版本的PHP手冊(cè)。

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

Haohappy介紹一下編譯流程：
1。準(zhǔn)備好HTML格式的手冊(cè)文件。
有兩種途徑：
1)通過(guò)cvs下載手冊(cè)文件，自己編譯出來(lái) （保證最新，但編譯過(guò)程要花費(fèi)5個(gè)小時(shí)左右，生成6000多個(gè)文件，要有耐心，唉。）
2)通過(guò)php.net下載打包好的html手冊(cè)，到本地解壓縮。

2。下載并安裝Microsoft(r) HTML Help Workshop，默認(rèn)安裝在 c:\Program Files\HTML Help Workshop\；

3。通過(guò)cvs下載 chm 手冊(cè)生成腳本文件，位于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：
     根據(jù)你的實(shí)際情況修改相應(yīng)選項(xiàng)：
     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文件的目錄設(shè)置為.\html，所以我們要把所有HTML文件放進(jìn)去。

5。點(diǎn)擊“開(kāi)始”－＞“運(yùn)行”－＞“cmd”，在命令行下進(jìn)入相應(yīng)目錄，輸入：
make_chm.bat

如果順利，就會(huì)在chm/chm目錄下生成chm格式的PHP手冊(cè)了。

編譯帶評(píng)論（User Notes）的PHP手冊(cè)：

在phpdoc/htmlhelp目錄下，存在另一個(gè)chm文件編譯系統(tǒng)，用于生成extended CHM文件（即帶擴(kuò)展功能的chm文件）。

使用步驟：

  1. 得到最新的phpdoc html文件； 可以查看xsl/version.xml來(lái)得到版本信息，確保編譯最新的手冊(cè)。

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

 3.     將HTML文件放在   phpdoc/htmlhelp/html 目錄下（一般情況況執(zhí)行完1之后會(huì)自動(dòng)復(fù)制HTML文件到該目錄）

 4. 下載http://cn.php.net/include/mirrors.inc
或者h(yuǎn)ttp://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，并根據(jù)實(shí)際情況修改其中配置。
 7. 最后運(yùn)行：
make_chm.bat

編譯過(guò)程中會(huì)先生成一個(gè)評(píng)論相關(guān)的chm文件，然后最后生成一個(gè)總的chm手冊(cè)。

最新評(píng)論