|
马上注册,结交更多好友,享用更多功能,让你轻松玩转社区。
您需要 登录 才可以下载或查看,没有帐号?立即注册
x
不懂的问题有很多高手帮你解决。但不要认为你是新手,就不能帮助别人,比如今天你学会了怎样安装PHP,明天还可能有朋友会问这个问题,你就可以给他解答,不要认为这是浪费时间,忙别人其实就是帮助自己。语法 Extended CHM PHP 语法手册之 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(" |
|