根据鄙人的使用经验,感觉相对于普通的 CHM 手册,Extended CHM 版则额外提供了以下几种主要特性:
1、附带非常实用用户注释,其价值不亚于用户手册,这是最大的优点!
2、可以使用自定义的 CSS 文件来切换外观,可自定义右键菜单;
3、PHP 代码块以语法高亮显示;
4、PHP 代码块中的函数为超链接形式,点击自动跳转至相应的函数;
5、可以很方便地集成于大多数 IDE 和编辑器;
尽管 Extended CHM 格式的 PHP 手册提供了这么多优秀特性,但 PHP 官方网站却只提供了英文版,始终没有提供简体中文版。因此我就趁空闲之机编译了这套手册。虽然网上也有其他热心 PHPER 编译提供的中文版,但大多只是简单的从 CVS 上 Checkout 编译了一下,并没有针对中文版的特殊情况做些处理,因此就出现了诸如“不能搜索中文”、“搜索到的条目中文标题显示为乱码”或“页面中某些中文显示为数字编码”等 BUG,本版本几乎完美的解决了这些 BUG ,欢迎大家测试使用,反馈请到 http://www.php.net 和 http://www.yAnbiN.org,我只负责编译问题。:-)
压缩包内的文件说明:
php_manual_zh.chm 是手册的主文件,如果你只需要纯文本的手册,可以只保留这个文件。
php_manual_notes.chm 是手册对应章节的用户注释部分,不能单独打开,只能配合 php_manual_zh.chm 使用。这是一个很有用的东东,补充了一些手册没有的或不宜加入的部分,并且是随时更新的。
php_manual_prefs.js 负责为上面两个 chm 文件载入相应的 skin ,并且提供了对自定义右键菜单功能的支持。
context.ini 即是右键菜单的定义部分。你可以使用 php_manual_prefs.exe 这个 GUI 程序来配置,也可以直接手动编辑context.ini文件,但是编辑前注意和 php_manual_prefs.js 相关部分对应。
/skins/ 这个目录保存的即是一些另外的skin(High和Low两种Skin已经内置在两个chm文件中),可以根据自己的喜好来定。
mirrors.ini 里面保存所有php.net的镜像网址,在手册主文件当中,有个在线版本的连接,可以在 php_manual_prefs.exe 中定义采用哪个镜像来访问。
附上一条使用技巧--在 EditPlus 中集成本手册的方法:
【工具(Tools)】-->【用户工具(User Tools)】-->【添加工具(Add Tool)】:
菜单文本(Menu Text):PHP 手册
命令(Command): HH X:XXXXXXphp_manual_zh.chm (此处X:XXXX替换为您的 chm 帮助文件的位置)
参数(Argument): ::/_function.html#$(CurWord)
初始目录(Initial): $(FileDir) (可不填)
使用方法:把点击某一关键词,然后按快捷键(如:Ctrl+1,这个快捷键可以在【工具(Tools)】菜单下看到)即可。