此方法仅针对中文简体用户,繁体用户需做少许更改:-)
一、准备工作
下载并安装Microsoft(r) HTML Help Workshop,笔者按默认安装,即装在 c:\Program Files\HTML Help Workshop\; 配置好 php.ini,加入 iconv 或 mbstring 扩展的支持; 下载 PHP html 手册,并解压缩到 d:\phpchm\html 目录,当然你也可以放到其他目录,在本文中笔者以 d:\phpchm 作为根目录; 下载 chm 手册生成脚本文件,当然你得先装好CVS客户端,操作如下:
D:\cvsroot>cvs -d :pserver:cvsread@cvs.php.net:/repository checkout phpdoc-zh
拷贝 d:\cvsroot\phpdoc-zh\chm 目录下所有文件到 d:\phpchm\chm 目录下;
拷贝 d:\cvsroot\phpdoc-zh\zh 目录下所有文件到 d:\phpchm\zh 目录下; 二、修改 chm 手册生成脚本文件
打开 make_chm.bat,并做如下修改:
如下的相关路径可根据你自己的需求进行相应的更改。
rem Path of the PHP CGI executable
set PHP_PATH=d:\php-4.3.6\php.exe
rem Path of the Help Compiler command line tool
set PHP_HELP_COMPILER="c:\Program Files\HTML Help Workshop\hhc.exe"
rem The language of the manual to compile
set PHP_HELP_COMPILE_LANG=zh
rem The source directory with the original DSSSL made HTML
set PHP_HELP_COMPILE_DIR=..\html
rem The directory, where the fancy files need to be copied
set PHP_HELP_COMPILE_FANCYDIR=fancy 打开 make_chm_fancy.php,并做如下修改(若用常规方式编译则这步可省略):
copy("chm/make_chm_style.css", "$FANCY_PATH/style.css");
copy("chm/make_chm_spc.gif", "$FANCY_PATH/spacer.gif");
改为:
copy("make_chm_style.css", "$FANCY_PATH/style.css");
copy("make_chm_spc.gif", "$FANCY_PATH/spacer.gif"); 若你下载的 chm_setting.php 文件是1.9版以前,则还需做如下修改(主要解决CHM手册索引乱码问题,已通知Avenger更新了):
"zh" => array(
"langcode" => "0x804 Simplified Chinese",
"preferred_charset" => "CP936",
"mime_charset_name" => "gb2312",
"preferred_font" => "MingLiu,10,0"
)
改为:
"zh" => array(
"langcode" => "0x804 Simplified Chinese",
"preferred_charset" => "CP936",
"mime_charset_name" => "gb2312",
"preferred_font" => "simsun,10,0"
) 三、开始编译
只需敲入以下命令即可:
D:\phpchm\chm>make_chm.bat
稍等几分钟后就会在 php_manual_zh.chm 文件。 四、附件
这里附上笔者于2004年7月26日晚编译好的最新PHP手册。