`
huqi
  • 浏览: 96229 次
  • 性别: Icon_minigender_1
  • 来自: 北京
文章分类
社区版块
存档分类
最新评论

DocBook vs Apache Forrest

阅读更多

最近工作需要在研究开源的文档产品,举个例子吧,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的另一个优势就是它有一些已经完成的书籍著作:

分享到:
评论
1 楼 gis_gps 2008-11-25  
我下载了XXE,但还不知道怎么使用它?是不是要先了解DocBook的语法?

相关推荐

    click-docbook:Apache Click 框架的 Docbook

    Apache Click 框架的 Docbook 这个项目提供了一个修改过的来生成文档。 进行了以下更改: 升级到Apache FOP v0.95(此版本支持软分页符) 升级到Docbook XLS v1.75.0(此版本支持语法高亮) 包括 XSLTHL 语法高亮器...

    windows下配置docbook

    2. **安装 Apache Ant**:Apache Ant 是一个用于构建 Java 应用程序的工具,同时也是 Docbook 转换流程中的重要组件。下载并安装最新版本的 Apache Ant,同样需要设置环境变量。 3. **安装 Docbook XSL 样式表**:...

    DocBook5安装文件

    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的人有些帮助

    DocBook 5.0中文版

    《DocBook 5.0中文版》是一本深入讲解DocBook 5.0技术细节的权威指南,由Norman Walsh和Leonard Muellner撰写,旨在帮助读者掌握使用XML进行结构化文档创作的方法与技巧。本书不仅适合XML和DocBook的新手,也适合...

    使用DocBook

    - **转换工具**:典型的有Apache FOP用于生成PDF,XSL-FO处理器如RenderX,以及基于命令行的工具如`dbtoepub`和`db2man`。 - **DocBook套件**:如DocBook XSL样式表,包含预定义的转换规则。 4. ** windows-...

    docbook-style-xsl.zip

    标题“docbook-style-xsl.zip”表明这是一个包含DocBook风格XSL转换文件的压缩包。DocBook是一种XML架构,常用于编写技术文档,如手册、教程和参考指南。它允许内容作者专注于文档的内容,而不是排版,然后通过XSL...

    docbook 指南

    DocBook是一个基于XML的标记语言,专门用于技术文档的编写。它的设计目的是为了简化书籍、文章、说明和手册等技术文档的制作流程,使其能够轻易转换成多种格式输出。从给出的内容中,我们可以提取出以下知识点。 ...

    DocBook文档

    DocBook是一种XML(可扩展标记语言)文档格式,专门用于编写技术文档,如用户手册、教程、参考指南等。这个压缩包包含两份资源:"docbook - the definitive guide.chm" 和 "Writing documentation using DocBook.pdf...

    docbook-xml-4.2.zip

    《DocBook XML 4.2:构建技术文档的利器》 DocBook,作为一个标准化的XML词汇表,是用于编写技术文档的强大工具。DocBook XML 4.2版本是这一系列中的一个重要里程碑,它提供了丰富的元素和属性,使得作者能够详细地...

    docbook2asciidoc, 将DocBook转换为AsciiDoc的XSL.zip

    docbook2asciidoc, 将DocBook转换为AsciiDoc的XSL 这是将 DocBook 4.5转换为 AsciiDoc插件的样式表,最初由 bjepson 启动。依赖项这个项目有一个模块 ( https://github.com/oreillymedia/docbook2htmlbook ) 。

    DocBook的使用指南(English Version)

    ### DocBook 使用指南知识点概述 #### 一、简介与背景 **DocBook**是一种用于技术文档编写的语义标记语言,广泛应用于各种技术文档的创作之中。它采用XML(可扩展标记语言)作为基础,允许作者创建结构化的文档,...

    DocBook:权威指南DocBook: The Definitive Guide

    DocBook DTD的官方文档。 设计为对DocBook DTD的清晰,简洁,规范的参考。

    docbook使用心得

    DocBook 是一种结构化的 XML 格式,常用于编写技术文档,如用户手册、软件文档、教程等。它提供了一套严谨的标记语言,使得内容的结构清晰,易于自动化处理和发布。这篇“docbook使用心得”博文链接分享了作者在使用...

    docbook-xsl-1.73.2.zip

    DocBook 是一个流行的XML文档格式,它用于编写技术文档,如手册、教程、参考指南等。这个"docbook-xsl-1.73.2.zip"压缩包包含的是DocBook XSL样式表的1.73.2版本,这是一个关键组件在将DocBook XML文档转换成各种...

    Writing Documentation Using DocBook

    英文名称:Writing Documentation Using DocBook 中文名称:Docbook写作指南 DocBook提供了一个使用SGML/XML撰写结构化文档的系统。这个系统非常适合于计算机类的文章、书籍、论文等的出版,当然并不仅仅限于计算机...

    docbook-xml-4.5.zip

    DocBook是一种广泛使用的标准,用于结构化和组织技术文档,特别是在软件开发领域。它提供了一套XML元素,这些元素用于定义技术文档的各种组成部分,如章节、摘要、代码示例等。"docbook-xml-4.5.zip" 是一个包含...

    DocBook文档管理工具

    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. ...

Global site tag (gtag.js) - Google Analytics