深究Extended CHM PHP 语法手册之 DIY

2016-10-14 00:00:00临风 网页程序设计

  这时, 要做一些小小的修正

  用编辑器打开 /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 即可浏览手册了.

[网页程序设计]相关推荐

[网页程序设计]相关栏目推荐
查看更多
上一篇:PHP程序员解决问题8大级别的能力 下一篇:C#开发和调用Web Service实例