欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  后端开发

ExtendedCHMPHP语法手册之DIY_PHP

程序员文章站 2022-06-17 13:02:49
...
手册 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
--------------------------------------------------------------------------------

这时, 要做一些小小的修正
用编辑器打开 /home/phpdoc/phpdoc/xsl/htmlhelp-db.xsl
在此文件中搜索 "@DOCBOOKXSL_HTML@",
将其替换为 "./docbook/html/chunk.xsl", 并存盘退出
然后再打开 /home/phpdoc/phpdoc/xsl/html-common.xsl
将如下代码加入文件尾部一行之上, 并存盘退出

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