今天小编来给大家介绍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中文版
<
ncvs/>>
unix 阵营的操作系统一般都自带 cvs 客户端,
你可以在命令行下直接键入 "cvs version" 来检查 cvs 是否安装,
如果没有安装请从
<
本的 cvs 客户端
Windows 操作系统:
需要在 windows 系统中运行 Microsoft Html Help Workshop 来生成 chm 文件
你也可以在linux下运行wine来模拟windows
Microsoft Html Help Workshop
微软发布的用语生成 chm 文件的工具
<
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
--------------------------------------------------------------------------------
