- 相關推薦
編譯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)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_style.css
<DIR>chm
<DIR>html
4。編輯make_chm.bat:
根據你的實際情況修改相應選項:
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文件的目錄設置為.html,所以我們要把所有HTML文件放進去。
5。點擊“開始”->“運行”->“cmd”,在命令行下進入相應目錄,輸入:
make_chm.bat
如果順利,就會在chm/chm目錄下生成chm格式的PHP手冊了。
編譯帶評論(UserNotes)的PHP手冊:
在phpdoc/htmlhelp目錄下,存在另一個chm文件編譯系統,用于生成extendedCHM文件(即帶擴展功能的chm文件)。
使用步驟:
1.得到最新的phpdochtml文件;可以查看xsl/version.xml來得到版本信息,確保編譯最新的手冊。
2.在phpdoc目錄下:
autoconf
./configure--with-chm=yes
makechm_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
使用bunzip2all.bz2命令解壓,同樣放到htmlhelp目錄下。
6.把local_vars.php.src重命名為local_vars.php,并根據實際情況修改其中配置。
7.最后運行:
make_chm.bat
編譯過程中會先生成一個評論相關的chm文件,然后最后生成一個總的chm手冊。</p
【編譯chm格式PHP手冊的方法】相關文章:
CentOS 7.0編譯安裝Nginx+MySQL+PHP的方法06-13
無需重新編譯php加入ftp擴展的方法09-04
編譯php的配置參數實10-25
php數組轉成json格式的方法09-26
PHP常用編譯參數中文說明09-28
php格式化時間戳的方法技巧10-28
自學PHP方法09-24
PHP的安裝方法11-04