最近工作需要在研究开源的文档产品,举个例子吧,Spring和Hibernate的官方帮助手册就是借助这类产品生成的。
在这个方面,DocBook和Apache Forrest这两种基于XML的文档框架工具无疑是占有统治地位的。基本来说,这两种框架都可以让你自由的定义文档的布局、格式、章节,从而完成你的“著作”。它们需要你完全使用基于一种特定schema/dtd的XML书写文档,然后根据应用的样式表去生成诸如XHTML、PDF、RTF之类的最终文档产品。
对于一个基于Java 1.5平台的企业应用项目来说,我更倾向于使用DocBook,因为它看起来要更加成熟而且有更多的辅助工具,但是,相比较而言,Forrest似乎拥有更短的学习曲线。
我认为Forrest的XML方言能覆盖80%的应用场景,同时相对的容易上手。但是,如果是一个大型软件项目的话,很难想象不需要产生可打印格式的文档,这一点是DocBook的优势。
正如我上面所提及的,在使用DocBook撰写文档时,会有很多工具供你选择,尽管我没有发现多少特别杰出的(工具:-):
- Conglomerate - 这个工具看上去挺有发展前途的,但是,它只能运行在unix系统上。
- DocBook Template for OpenOffice - 使用这个工具生成“章节”时似乎有点毛病,不支持所有的DocBook特性。
- Vex - Vex是一个Eclipse的插件,看上去有发展前途,但是我认为它有些难用。
- Big list of docbook tools - 这是个什么东东,我不知道。
也许手写XML文档也不失为一个好的方法,但是如果能有一个称心应手的可视化工具辅助那就更爽啦,不是么?
最后,我要说的DocBook的另一个优势就是它有一些已经完成的书籍著作:
分享到:
相关推荐
Apache Click 框架的 Docbook 这个项目提供了一个修改过的来生成文档。 进行了以下更改: 升级到Apache FOP v0.95(此版本支持软分页符) 升级到Docbook XLS v1.75.0(此版本支持语法高亮) 包括 XSLTHL 语法高亮器...
2. **安装 Apache Ant**:Apache Ant 是一个用于构建 Java 应用程序的工具,同时也是 Docbook 转换流程中的重要组件。下载并安装最新版本的 Apache Ant,同样需要设置环境变量。 3. **安装 Docbook XSL 样式表**:...
1 docbook-xsl-ns-1.75.2.zip解压到D:\docbook 2 另外四个压缩包解压出来,把里面的bin,include和lib三个文件夹拷贝到D:\docbook\xsltproc目录下 2 环境变量Path中增加 D:\docbook\xsltproc\bin 3 新建一个bat,...
关于的DocBook的资料, 本人看过,觉得很不错,讲解很详细,应该对想学习DocBook的人有些帮助
《DocBook 5.0中文版》是一本深入讲解DocBook 5.0技术细节的权威指南,由Norman Walsh和Leonard Muellner撰写,旨在帮助读者掌握使用XML进行结构化文档创作的方法与技巧。本书不仅适合XML和DocBook的新手,也适合...
- **转换工具**:典型的有Apache FOP用于生成PDF,XSL-FO处理器如RenderX,以及基于命令行的工具如`dbtoepub`和`db2man`。 - **DocBook套件**:如DocBook XSL样式表,包含预定义的转换规则。 4. ** windows-...
标题“docbook-style-xsl.zip”表明这是一个包含DocBook风格XSL转换文件的压缩包。DocBook是一种XML架构,常用于编写技术文档,如手册、教程和参考指南。它允许内容作者专注于文档的内容,而不是排版,然后通过XSL...
DocBook是一个基于XML的标记语言,专门用于技术文档的编写。它的设计目的是为了简化书籍、文章、说明和手册等技术文档的制作流程,使其能够轻易转换成多种格式输出。从给出的内容中,我们可以提取出以下知识点。 ...
DocBook是一种XML(可扩展标记语言)文档格式,专门用于编写技术文档,如用户手册、教程、参考指南等。这个压缩包包含两份资源:"docbook - the definitive guide.chm" 和 "Writing documentation using DocBook.pdf...
《DocBook XML 4.2:构建技术文档的利器》 DocBook,作为一个标准化的XML词汇表,是用于编写技术文档的强大工具。DocBook XML 4.2版本是这一系列中的一个重要里程碑,它提供了丰富的元素和属性,使得作者能够详细地...
docbook2asciidoc, 将DocBook转换为AsciiDoc的XSL 这是将 DocBook 4.5转换为 AsciiDoc插件的样式表,最初由 bjepson 启动。依赖项这个项目有一个模块 ( https://github.com/oreillymedia/docbook2htmlbook ) 。
### DocBook 使用指南知识点概述 #### 一、简介与背景 **DocBook**是一种用于技术文档编写的语义标记语言,广泛应用于各种技术文档的创作之中。它采用XML(可扩展标记语言)作为基础,允许作者创建结构化的文档,...
DocBook DTD的官方文档。 设计为对DocBook DTD的清晰,简洁,规范的参考。
DocBook 是一种结构化的 XML 格式,常用于编写技术文档,如用户手册、软件文档、教程等。它提供了一套严谨的标记语言,使得内容的结构清晰,易于自动化处理和发布。这篇“docbook使用心得”博文链接分享了作者在使用...
DocBook 是一个流行的XML文档格式,它用于编写技术文档,如手册、教程、参考指南等。这个"docbook-xsl-1.73.2.zip"压缩包包含的是DocBook XSL样式表的1.73.2版本,这是一个关键组件在将DocBook XML文档转换成各种...
### DocBook知识点详解 #### 一、DocBook概述 **DocBook**是一种强大的文档标记语言标准,主要用于技术文档的编写,尤其是与计算机硬件和软件相关的书籍及论文。它支持多种语言,包括RELAX NG、SGML (Standard ...
英文名称:Writing Documentation Using DocBook 中文名称:Docbook写作指南 DocBook提供了一个使用SGML/XML撰写结构化文档的系统。这个系统非常适合于计算机类的文章、书籍、论文等的出版,当然并不仅仅限于计算机...
DocBook是一种广泛使用的标准,用于结构化和组织技术文档,特别是在软件开发领域。它提供了一套XML元素,这些元素用于定义技术文档的各种组成部分,如章节、摘要、代码示例等。"docbook-xml-4.5.zip" 是一个包含...
DocBook is a very popular set of tags for describing books, articles, and other prose documents, particularly technical documentation. DocBook is defined using the native DTD syntax of SGML and XML. ...