編譯chm格式PHP手冊(cè)的方法

　　微軟的chm文件格式是很受我們喜愛的，因?yàn)樗�可以把很多HTML文件打包成一個(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)通過cvs下載手冊(cè)文件，自己編譯出來（保證最新，但編譯過程要花費(fèi)5個(gè)小時(shí)左右，生成6000多個(gè)文件，要有耐心，唉。）

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

　　2。下載并安裝Microsoft(r)HTMLHelpWorkshop，默認(rèn)安裝在c:ProgramFilesHTMLHelpWorkshop；

　　3。通過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)：

　　remPathofthePHPCLIexecutable

　　setPHP_PATH=C:php5php.exe

　　remPathoftheHelpCompilercommandlinetool

　　setPHP_HELP_COMPILER="c:ProgramFilesHTMLHelpWorkshophhc.exe"

　　remThelanguageofthemanualtocompile

　　setPHP_HELP_COMPILE_LANG=zh

　　remThesourcedirectorywiththeoriginalDSSSLmadeHTML

　　setPHP_HELP_COMPILE_DIR=.html

　　注意，我們把要用到的HTML文件的目錄設(shè)置為.html，所以我們要把所有HTML文件放進(jìn)去。

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

　　make_chm.bat

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

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

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

　　使用步驟：

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

　　2.在phpdoc目錄下：

　　autoconf

　　./configure--with-chm=yes

　　makechm_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

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

　　6.把local_vars.php.src重命名為local_vars.php，并根據(jù)實(shí)際情況修改其中配置。

　　7.最后運(yùn)行：

　　make_chm.bat

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

【編譯chm格式PHP手冊(cè)的方法】相關(guān)文章：

CentOS 7.0編譯安裝Nginx+MySQL+PHP的方法06-13

無需重新編譯php加入ftp擴(kuò)展的方法09-04

編譯php的配置參數(shù)實(shí)10-25

解析無需重新編譯php加入ftp擴(kuò)展的方法09-05

php數(shù)組轉(zhuǎn)成json格式的方法09-26

PHP常用編譯參數(shù)中文說明09-28

php格式化時(shí)間戳的方法技巧10-28

自學(xué)PHP方法09-24

PHP的安裝方法11-04