编译chm格式中文PHP手册
最近从官网下载的chm文件格式的样式出错了,看着太费劲,新下载的几个版本错误仍然没修复,这只好自己整了,这其中走了不少弯路,总算是完成了,通过观察phd代码,之所以chm手册的样式丢失是因为样式文件(http://php.net/styles/site.css)没有了,
- 一、安装php(需要开启bz2扩展,用于从官网下载所有评论,如果要编译不带评论的,则不需开启),把php目录加入系统环境变量中,好从命令行调用
- 二、安装pear(安装文档http://pear.php.net/manual/en/installation.getting.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