微軟的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