編譯chm格式PHP手冊的方法

微軟的chm文件格式是很受我們喜愛的,因爲它可以把很多HTML文件打包成一個文件,容易傳輸和分享。而且非常方便易用,支持索引、搜索等。正因爲這樣,大家通常都使用chm版本的PHP手冊。

編譯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