- 相關(guān)推薦
編譯chm格式PHP手冊的方法
微軟的chm文件格式是很受我們喜愛的,因為它可以把很多HTML文件打包成一個文件,容易傳輸和分享。而且非常方便易用,支持索引、搜索等。正因為這樣,大家通常都使用chm版本的PHP手冊。
php.net會定期編譯PHP手冊,提供各種版本供大家下載,包括chm格式。由于是定期編譯,所以我們拿到的永遠(yuǎn)不會是最新的手冊。如果你想得到最新的手冊,就只能自己編譯了。而且php.net提供的中文手冊不能搜索中文,索引也是亂碼。
Haohappy介紹一下編譯流程:
1。準(zhǔn)備好HTML格式的手冊文件。
有兩種途徑:
1)通過cvs下載手冊文件,自己編譯出來(保證最新,但編譯過程要花費5個小時左右,生成6000多個文件,要有耐心,唉。)
2)通過php.net下載打包好的html手冊,到本地解壓縮。
2。下載并安裝Microsoft(r)HTMLHelpWorkshop,默認(rèn)安裝在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_style.css
<DIR>chm
<DIR>html
4。編輯make_chm.bat:
根據(jù)你的實際情況修改相應(yī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。點擊“開始”->“運行”->“cmd”,在命令行下進(jìn)入相應(yīng)目錄,輸入:
make_chm.bat
如果順利,就會在chm/chm目錄下生成chm格式的PHP手冊了。
編譯帶評論(UserNotes)的PHP手冊:
在phpdoc/htmlhelp目錄下,存在另一個chm文件編譯系統(tǒng),用于生成extendedCHM文件(即帶擴展功能的chm文件)。
使用步驟:
1.得到最新的phpdochtml文件;可以查看xsl/version.xml來得到版本信息,確保編譯最新的手冊。
2.在phpdoc目錄下:
autoconf
./configure--with-chm=yes
makechm_xsl
可選參數(shù):"--with-xsltproc=path"指定XSLTProc路徑
3.將HTML文件放在phpdoc/htmlhelp/html目錄下(一般情況況執(zhí)行完1之后會自動復(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ù)實際情況修改其中配置。
7.最后運行:
make_chm.bat
編譯過程中會先生成一個評論相關(guān)的chm文件,然后最后生成一個總的chm手冊。</p
【編譯chm格式PHP手冊的方法】相關(guān)文章:
自學(xué)PHP方法12-04
PHP日期函數(shù)date格式化UNIX時間的方法11-16
PHP偽靜態(tài)的方法12-02
解決php fsockopen的方法03-27
PHP的安裝方法及軟件03-18
PHP實現(xiàn)多線程的方法03-29
php數(shù)組長度的方法03-03
PHP頁面漏洞分析的方法03-27