documentation/manual/zh/README

   1 需要的软件：
   2
   3 - autoconf
   4 - make
   5 - xsltproc
   6 - xmllint
   7
   8 在 Windows 下，应当使用 Cygwin 或其他 GNU 开发工具。
   9
  10 如何从 DocBook 生成文档：
  11
  12 - run "autoconf" in this dir
  13 - run "./configure" in this dir
  14 - run "make"
  15
  16 HTML 文件生成并存放在“html”文件夹。
  17
  18 在编写内容时，可以通过执行下面的命令来验证改动：
  19
  20   "make check"
  21
  22 这可以验证整个手册的 XML 是否正确。
  23
  24 也可以通过执行命令验证单个文件是否正确：
  25
  26   "make XMLFILE=filename.xml check1"
  27
  28 filename.xml 可以用相对“module_specs”目录的路径指定。
  29
  30 DocBook 资源：
  31
  32 http://www.ibiblio.org/godoy/sgml/docbook/howto/index.html
  33 http://opensource.bureau-cornavin.com/crash-course/index.html
  34 http://ds9a.nl/docbook/
  35 http://www.sagehill.net/docbookxsl/index.html
  36 http://docbook.org/tdg/en/html/part2.html DocBook tag reference
  37
  38 同时将创建 CHM 项目文件，用于生成 CHM 帮助文件。
  39 你需要安装 MsHtmlHelpWorkshop。
  40
  41 通过命令行进入之前使描述的用 make 生成的 html 文件所在的目录。
  42 然后调用：
  43  "C:/path/to/workshop/hhc htmlhelp.hhp"
  44 "C:/path/to/workshop/" 是 MsHtmlHelpWorkshop 的安装路径。
  45
  46 这将生成一个 "Zend_Framework_LANGUAGE.chm" 文件。
  47 在这个文件中你会看到索引以及内容。
  48
  49 补充：中文手册在生成 CHM 文件之前，请使用 tools/convEncoding.php 对 hhp 和 hhc 文件进行编码预处理。详情请看 tools/README.txt