Extended CHM PHP 语法手册之 DIY

1. Extended CHM 的主要特点
可自定义右键菜单
php代码块以语法高亮显示
php代码块中的函数带有相应的函数手册链接
更清晰的手册界面
可以自定义手册的外观样式
支持换肤功能
更详尽的手册内容
附带非常实用用户笔记
可以集成于大多数ide和编辑器
详细信息请访问
<<http://mon.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("&amp;raquo;","&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 即可浏览手册了.（出处：Viphot）