Frank Brückner 202c1b3443 Fixes #683 - Zend_Form_Element_Button::isChecked has wrong documentation %!s(int64=9) %!d(string=hai) anos
..
figures 59ede1801c Creating 1.12 release branch %!s(int64=13) %!d(string=hai) anos
html 59ede1801c Creating 1.12 release branch %!s(int64=13) %!d(string=hai) anos
module_specs 202c1b3443 Fixes #683 - Zend_Form_Element_Button::isChecked has wrong documentation %!s(int64=9) %!d(string=hai) anos
ref d58c384199 Update copyright to 2015. %!s(int64=11) %!d(string=hai) anos
tools 59ede1801c Creating 1.12 release branch %!s(int64=13) %!d(string=hai) anos
Makefile.in d58c384199 Update copyright to 2015. %!s(int64=11) %!d(string=hai) anos
README 59ede1801c Creating 1.12 release branch %!s(int64=13) %!d(string=hai) anos
configure.in d58c384199 Update copyright to 2015. %!s(int64=11) %!d(string=hai) anos

README

需要的软件:

- autoconf
- make
- xsltproc
- xmllint

在 Windows 下,应当使用 Cygwin 或其他 GNU 开发工具。

如何从 DocBook 生成文档:

- run "autoconf" in this dir
- run "./configure" in this dir
- run "make"

HTML 文件生成并存放在“html”文件夹。

在编写内容时,可以通过执行下面的命令来验证改动:

"make check"

这可以验证整个手册的 XML 是否正确。

也可以通过执行命令验证单个文件是否正确:

"make XMLFILE=filename.xml check1"

filename.xml 可以用相对“module_specs”目录的路径指定。

DocBook 资源:

http://www.ibiblio.org/godoy/sgml/docbook/howto/index.html
http://opensource.bureau-cornavin.com/crash-course/index.html
http://ds9a.nl/docbook/
http://www.sagehill.net/docbookxsl/index.html
http://docbook.org/tdg/en/html/part2.html DocBook tag reference

同时将创建 CHM 项目文件,用于生成 CHM 帮助文件。
你需要安装 MsHtmlHelpWorkshop。

通过命令行进入之前使描述的用 make 生成的 html 文件所在的目录。
然后调用:
"C:/path/to/workshop/hhc htmlhelp.hhp"
"C:/path/to/workshop/" 是 MsHtmlHelpWorkshop 的安装路径。

这将生成一个 "Zend_Framework_LANGUAGE.chm" 文件。
在这个文件中你会看到索引以及内容。

补充:中文手册在生成 CHM 文件之前,请使用 tools/convEncoding.php 对 hhp 和 hhc 文件进行编码预处理。详情请看 tools/README.txt