2
0

README 1.4 KB

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