Mon 14 Aug 2006
根据鄙人的使用经验,感觉相对于普通的 CHM 手册,Extended CHM 版则额外提供了以下几种主要特性:
- 附带非常实用用户注释,其价值不亚于用户手册,这是最大的优点!
- 可以使用自定义的 CSS 文件来切换外观,可自定义右键菜单;
- PHP 代码块以语法高亮显示;
- PHP 代码块中的函数为超链接形式,点击自动跳转至相应的函数;
- 可以很方便地集成于大多数 IDE 和编辑器。
尽管 Extended CHM 格式的 PHP 手册提供了这么多优秀特性,但 PHP 官方网站却只提供了英文版,始终没有提供简体中文版。因此我就趁空闲之机编译了这套手册。虽然网上也有其他热心 PHPER 编译提供的中文版,但大多只是简单的从 CVS 上 Checkout 编译了一下,并没有针对中文版的特殊情况做些处理,因此就出现了诸如“不能搜索中文”、“搜索到的条目中文标题显示为乱码”或“页面中某些中文显示为数字编码”等 BUG。而本版本几乎完美的解决了这些 BUG ,欢迎大家测试使用,反馈请到PHP 官方站点和抚琴居,我只负责编译问题。:-)
压缩包内的文件说明:
- 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:\XXXXXX\php_manual_zh.chm (此处X:\XXXX替换为您的 chm 帮助文件的位置)
参数(Argument): ::/_function.html#$(CurWord)
初始目录(Initial): $(FileDir) (可不填)
使用方法:把点击某一关键词,然后按快捷键(如:Ctrl+1,这个快捷键可以在【工具(Tools)】菜单下看到)即可。
点此下载PHP 手册中文版(Extended CHM 格式)
August 19th, 2006 at 23:24
lengend 就编译过好几次集成用户注释的版本。你可以去 http://www.ugia.cn 看看
August 21st, 2006 at 16:11
多谢哥们提醒。
我最早用的大概就是 lengend 这个版本。但 lengend 编译的仅仅是带了注释。我认为还有以下几个方面有待改进:
1、注释和文档没有分开。这样就不能分开更新。
2、注释也没有带全文索引,这样搜索关键字的时候就不能在注释里面搜索。
3、有些内容没有出现在目录当中,比如“安装与配置”一章、关于 PHP 扩展开发的“PHP 和 Zend 引擎内部资料”一章,以及“附录”等部分,这些都没有在目录中显示。
这些瑕疵应该说是传统 CHM 手册就有的,因此,我觉得lengend 的带注释版其实不是扩展 CHM 版本,而是给每一页加上注释的传统 CHM 版。^_^
August 21st, 2006 at 21:53
谢谢你提供的这个PHP手册,使用起来非常方便
谢谢你的辛苦劳动
November 3rd, 2006 at 16:03
请问有办法把这个集成到ZDE中吗?
November 3rd, 2006 at 19:50
另外,Zend API 一章没有译的,怎么不把你这里的:深入 PHP 内核 弄进去啊?
November 5th, 2006 at 19:48
暂时还没有办法将其集成到 ZDE,因为 ZDE 是用 Java 编写的,对帮助文件似乎也不是标准的 Win32 调用。
Zend API 一章暂时还在翻译,打算翻译完了再提交上去。但限于个人水平,不保证一定通过。:)
September 19th, 2007 at 22:55
本,支持,很好,很强大~
November 30th, 2007 at 22:05
嗯,下来用用,谢谢!