快捷搜索:

ExtendedCHMPHP语法手册之DIY

Extended CHM PHP 语法手册之 DIY

1. Extended CHM 的主要特征

可自定义右键菜单

php代码块以语法高亮显示

php代码块中的函数带有响应的函数手册链接

更清晰的手册界面

可以自定义手册的外不雅样式

支持换肤功能

更详尽的手册内容

附带异常实用用户条记

可以集成于大年夜多半ide和编辑器

具体信息请造访

>

2. 为什么要 DIY

不知为什么, 这么好的东东在 php 的官方网站上已经好久没有更新了 (最新的官方

版本是 2003.9.6 宣布的). 尤其是在 php5 宣布今后更是有不少内容都查不到, 所

以就只能发扬 DIY 精神, 来自己制作了. ^_^

3. 预备常识

cvs 客户真个应用.

linux 情况下的基础操作, 以及软件的编译与安装.

4. 软件需求

cvs客户端软件:

我们要经由过程 php 官方网站的 cvs 办事器来取得 phpdoc 的最新版本.

windows 情况下保举应用 wincvs中文版

>

unix 阵营的操作系统一样平常都自带 cvs 客户端,

你可以在敕令行下直接键入 "cvs version" 来反省 cvs 是否安装,

假如没有安装请从

> 中下载最新版

本的 cvs 客户端

Windows 操作系统:

必要在 windows 系统中运行 Microsoft Html Help Workshop 来天生 chm 文件

你也可以在linux下运行wine来模拟windows

Microsoft Html Help Workshop

微软宣布的用语天生 chm 文件的对象

>

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

将如下代码加入文件尾部一行之上, 并存盘退出

代码:--------------------------------------------------------------------------------

--------------------------------------------------------------------------------

然后继承履行编译操作,

代码:--------------------------------------------------------------------------------

$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 ''.$m[1].'()';

}elseif(file_exists("html/".$fname2)) {

return ''.$m[1].'()';

}else{

return ''.$m[1].'()';

}

}

--------------------------------------------------------------------------------

然后在文件中找到如下这段代码

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('', "/").'(\w+)\(\)'.preg_quote('', "/").'/is';

$content = preg_replace_callback($reg_fix,'fix_function_link',$content);

$reg_fix = '/'.preg_quote('', "/").'(\w+)\(\)'.preg_quote('', "/").'/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_en.chm 即可浏览手册了.

您可能还会对下面的文章感兴趣: