1.
Extended chm 的主要特点
可自定义右键菜单
PHP代码块以语法高亮显示
PHP代码块中的函数带有相应的函数手册链接
更清晰的手册界面
可以自定义手册的外观样式
支持换肤功能
更详尽的手册内容
附带非常实用用户笔记
可以集成于大多数ide和编辑器
2. 为什么要 DIY
不知为什么, 这么好的东东在
PHP 的官方网站上已经很久没有更新了 (最新的官方
版本是 2003.9.6 发布的). 尤其是在
PHP5 发布以后更是有不少内容都查不到, 所
以就只能发扬 DIY 精神, 来自己制作了. ^_^
3. 预备知识
cvs 客户端的使用.
Linux 环境下的基本操作, 以及软件的编译与安装.
4. 软件需求
cvs客户端软件:
我们要通过
PHP 官方网站的 cvs 服务器来取得
PHPdoc 的最新版本.
windows 环境下推荐使用 wincvs中文版
ncvs/>>
unix 阵营的操作系统一般都自带 cvs 客户端,
你可以在命令行下直接键入 "cvs version" 来检查 cvs 是否安装,
如果没有安装请从
中下载最新版
本的 cvs 客户端
Windows 操作系统:
需要在 windows 系统中运行 Microsoft Html Help Workshop 来生成
chm 文件
你也可以在
Linux下运行wine来模拟windows
Microsoft Html Help Workshop
微软发布的用语生成
chm 文件的工具
<<Microsoft Html Help
Workshop>>
Linux 操作系统:
我们需要在此进行手册和一些必备软件包的编译安装，
你也可以使用其他的 unix 阵营的系统，
或者干脆用 cygwin, vmware 等软件来在 Windows 下模拟一个
Linux 环境
PHP4.0或以上版本:
编译和生成
chm 文件时均需要用到
PHP 所以你需要再 windows 和
Linux 环境下
都安装
PHP.
本文所使用的环境:
两台pc, 分别装有 redhat 9 以及 windows 2000 professional
5. 开始 DIY
首先, 在
Linux 机中
安装 OpenJada 和 OpenSP
进入
Linux 控制台
代码:---------------------------
$mkdir /home/
PHPdoc
$cd /home/
PHPdoc
$wget " $wget " $cd openjade-1.3.2
$./configure
$make
$make install
$cd ../OpenSP-1.5.1
$./configure
$make
$make install
$cd ../
--------------------------------
然后, 我们要从
PHP 的官方 cvs 服务器中取得
PHPdoc 的最新版本
代码:---------------------------
$export CVSROOT=:pserver:cvsread@cvs.
PHP.net:/repository
$cvs -z9 checkout
PHPdoc
$cd
PHPdoc
$cvs update -dP -D"December 31, 2002 11:00pm" xsl
$cvs up -A xsl/version.xml xsl/docbook/html/chunker.xsl
--------------------------------
设置编译参数
代码:--------------------------
$autoconf
$./configure --with-
chm=yes --with-lang=en
----------------------------
这时, 要做一些小小的修正
用编辑器打开 /home/
PHPdoc/
PHPdoc/xsl/htmlhelp-db.xsl
在此文件中搜索 "@DOCBOOKXSL_HTML@",
将其替换为 "./docbook/html/chunk.xsl", 并存盘退出
然后再打开 /home/
PHPdoc/
PHPdoc/xsl/html-common.xsl
将如下代码加入文件尾部</xsl:stylesheet>一行之上, 并存盘退出
代码:------------------------
<xsl:template match="collabname" mode="titlepage.mode">
<xsl:apply-templates />
</xsl:template>
<xsl:param name="chunker.output.doctype-system"
select="'http://www.w3.org/TR/html4/loose.dtd'"/>
<xsl:param name="chunker.output.doctype-public" select="'-//W3C//DTD HTML
4.01 Transitional//EN'"/>
-----------------------------
然后继续执行编译操作,
代码:------------------------
$make
chm_xsl
----------------------------
待编译结束以后, 我们需要取得最新的
PHP 镜像站点列表, 和用户笔记文件
代码:------------------------
$cd htmlhelp
$wget " $wget " $bunzip2 all.bz2
cd ../
可以把生成的文件打个包, 传至 windows 机上
代码:---------------------
tar -czvf
PHPdoc.tar.gz ./htmlhelp
到这里, 需要再
Linux 平台上执行的操作就完成了
现在起操作转到windows环境中
首先, 解压缩刚才生成的
PHPdoc.tar.gz
由于我所取得的版本编译后所生成的一些文件中, 相关函数的链接存在错误,
所以需要修改一下 htmlhelp/filter_files.
PHP 文件
先在其头部加入如下代码
PHP代码:------------
//fix functions link error
function fix_function_link($m) {
$fname1 = 'function.'.strtolower(str_replace('_','-',$m[1])).'.html';
$fname2 = 'function.'.strtolower(str_replace('_','.',$m[1])).'.html';
if(file_exists("html/".$fname1)) {
return '<a href="'.$fname1.'"><b>'.$m[1].'()</b></a>';
}elseif(file_exists("html/".$fname2)) {
return '<a href="'.$fname2.'"><b>'.$m[1].'()</b></a>';
}else{
return '<a href="#" onclick="return false;"><b>'.$m[1].'()</b></a>';
}
}
然后在文件中找到如下这段代码
PHP代码:--------------------
// Read in the contents of the source file
$content = join("", file("$HTML_SRC/$filename"));
将其改为
PHP代码:------------
// Read in the contents of the source file
$content = join("", file("$HTML_SRC/$filename"));
$content = str_replace("»","»",$content);
$reg_fix = '/'.preg_quote('<a href="index.html"><b>', "/").'(w+)()'.preg_quote('</b></a>', "/").'/is';
$content = preg_replace_callback($reg_fix,'fix_function_link',$content);
$reg_fix = '/'.preg_quote('<a href=""><b>', "/").'(w+)()'.preg_quote('</b></a>', "/").'/is';
$content = preg_replace_callback($reg_fix,'fix_function_link',$content);
存盘后, 再将 "htmlhelplocal_vars.
PHP.src" 重命名为
"htmlhelplocal_vars.
PHP"
编辑 "htmlhelplocal_vars.
PHP",
将其中的 $HELP_WORKSHOP 变量值设置为 Html Help Workshop 的安装目录, 存盘退
出
将
PHP.exe 所在目录加入 path 环境变量中.
在 "运行" 中键入 cmd 进入控制台模式,并进入
PHPdoc.tar.gz 的释放目录
代码:-----------------
cd htmlhelp
make_
chm.bat
待其执行结束后,
Extended chm 版的
PHP 语法手册就生成完毕了.
储存在 htmlhelp/release 目录下
再下载
<<
PHP_manual_prefs.exe>>, 并保存在手册目录
执行此程序即可对手册中的右键菜单, 所用皮肤等进行设置了.
设置完成后, 双击
PHP_manual_en.
chm 即可浏览手册了.
