编译chm格式中文PHP手册

作者: zengde 分类: 笔记 发布时间: 2017-07-23 09:50

最近从官网下载的chm文件格式的样式出错了,看着太费劲,新下载的几个版本错误仍然没修复,这只好自己整了,这其中走了不少弯路,总算是完成了,通过观察phd代码,之所以chm手册的样式丢失是因为样式文件(http://php.net/styles/site.css)没有了,

  • 一、安装php(需要开启bz2扩展,用于从官网下载所有评论,如果要编译不带评论的,则不需开启),把php目录加入系统环境变量中,好从命令行调用

 

 

  • 三、安装phd,在命令行中输入
    pear install doc.php.net/phd
    pear install doc.php.net/phd_php
    pear install doc.php.net/phd_pear
  • 四、安装Html Help Workshop.

 

  • 五、安装svn,然后获取php文档
    svn checkout https://svn.php.net/repository/phpdoc/modules/doc-zh doc-zh
    

    然后进入doc-zh中执行

    php doc-base/configure.php --with-lang=zh --enable-chm

    执行后会在doc-zh的doc-base中生成几个文件(.manual.xml,developer.template.xml,install-unix.xml,install-win.xml,manual.xml,version.xml)

 

  • 六、修改phd中的package/php/chm.php的182行”preferred_charset” => “cp936″为”preferred_charset” => “gb2312″,不然生成的chm目录乱码。

 

  • 七、复制官网样式中的theme-base.css和theme-medium.css,加上
    body{
     margin:0;
     background: #F2F2F2;
     color: #333;
    }
    a:link,
    a:visited {
      color: #369;
    }

    放入D:\svn\doc-zh\make_chm_style.css文件中。

    然后执行

    phd -d D:\svn\doc-zh\doc-base/.manual.xml --package PHP --format enhancedchm --css D:\svn\doc-zh\make_chm_style.css -L zh
    

    如果是不带评论的,执行

    phd -d D:\svn\doc-zh\doc-base/.manual.xml --package PHP --format chm --css D:\svn\doc-zh\make_chm_style.css -L zh
    
  • 八、打开html help workshop,打开上一步生成的php_manual_zh.hhp,最后compile,一会后,打开生成的php_manual_zh.chm,大功告成!

 

除了生成chm外还有其他格式

1.php格式(如同官网),需要安装先git,执行

phd -d D:\svn\doc-zh\doc-base/.manual.xml --package PHP --format php
git clone http://git.php.net/repository/web/php.git E:\wwwroot\php-web

复制C:\Users\zeng\output\php-web到E:\wwwroot\php-web\manual\zh中,然后执行

E:
cd E:\wwwroot\php-web
php -S localhost:8080

2.html格式

phd -d D:\svn\doc-zh\doc-base/.manual.xml --package PHP --format xhtml --css D:\svn\doc-zh\make_chm_style.css 

生成结果C:\Users\zeng\output\php-chunked-xhtml