ExtendedCHMPHP语法手册之DIY

　　 
　　1. Extended CHM 的主要特点
　　
　　可自定义右键菜单
　　php代码块以语法高亮显示
　　php代码块中的函数带有相应的函数手册链接
　　更清晰的手册界面
　　可以自定义手册的外观样式
　　支持换肤功能

　　更详尽的手册内容
　　附带非常实用用户笔记
　　可以集成于大多数ide和编辑器
　　详细信息请访问
　　<<http://www.php.net/docs-echm.php>>
　　
　　2. 为什么要 DIY
　　
　　不知为什么, 这么好的东东在 php 的官方网站上已经很久没有更新了 (最新的官方
　　版本是 2003.9.6 发布的). 尤其是在 php5 发布以后更是有不少内容都查不到, 所
　　以就只能发扬 DIY 精神, 来自己制作了. ^_^
　　
　　3. 预备知识
　　
　　cvs 客户端的使用.
　　linux 环境下的基本操作, 以及软件的编译与安装.
　　
　　4. 软件需求
　　
　　cvs客户端软件:
　　我们要通过 php 官方网站的 cvs 服务器来取得 phpdoc 的最新版本.
　　windows 环境下推荐使用 wincvs中文版
　　<<http://www.8848software.com/wi
　　ncvs/>>
　　unix 阵营的操作系统一般都自带 cvs 客户端,
　　你可以在命令行下直接键入 "cvs version" 来检查 cvs 是否安装,
　　如果没有安装请从
　　<<http://www.cvshome.org>> 中下载最新版
　　本的 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 "http://prdownloads.sourceforge.net/openjade/openjade-1.3.2.tar.gz"
　　$wget "http://prdownloads.sourceforge.net/openjade/OpenSP-1.5.1.tar.gz"
　　$tar -zxvf *.tar.gz
　　$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 "http://www.php.net/include/mirrors.inc"
　　$wget "http://www.php.net/backend/notes/all.bz2"
　　$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("&raquo;","»",$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);
　　
　　存盘后, 再将 "htmlhelp\local_vars.php.src" 重命名为
　　"htmlhelp\local_vars.php"
　　编辑 "htmlhelp\local_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 即可浏览手册了.

原文转自：http://www.ltesting.net