DocBook vs Apache Forrest

翻译 2007年10月05日 15:49:00

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

从LaTex到DocBook到txt2tags

今天终于再也受不了DocBook源文档那糟糕的可读性、用xslt转换时的超慢速度,对我日常写的简单的文章,它带来的维护成本实在是有些高,试用了一下txt2tags,很满意,源文档的可读性很好,同时又支...
  • hansoft
  • hansoft
  • 2006年02月25日 21:23
  • 2383

Forrest 2015年第三季度内存数据库分析报告

Forrester于2015年Q3发布了最新的内存数据库平台分析报告,SAP网站有PDF版本可以下载。概述内存数据库的需求源于对实时(real time)的需求,无论是实时分析还是实时交易处理。传统的...
  • stevensxiao
  • stevensxiao
  • 2016年05月11日 18:30
  • 6047

DocBook学习(v1.6.7)

DocBook学习 修订版本 1.6.7(http://www.woodpecker.org.cn:9081/doc/XML/docbook_step_1.6.6/src/html/)版权 © 200...
  • snaill
  • snaill
  • 2006年05月14日 14:02
  • 3148

从架构标准化层面,谈运维的角色转变和价值体现

2017-08-17 赵成(谦益) DBAplus社群 本文首发于 Forrest随想录 订阅号( id:forrest_thinking),经作者同意授权转载 下面我将从架构...
  • u011277123
  • u011277123
  • 2017年08月18日 10:15
  • 218

发布Docbook(0)

介绍 发布DocBook讲述了用于发布DocBook的框架.它是教你如何轻松的以多种不同格式发布作品或文章. 你可以在线阅读本文也可以下载它(详见第12章).这个框架是基于很多人的工作的,他们为其中的...
  • 23_ray
  • 23_ray
  • 2004年10月01日 11:04
  • 652

DocBook 5 快速起步教程

内容概要 DocBook是一个写作、排版、出版的利器。本文介绍如何在Mac OS X系统中安装DocBook 5,并使用它来撰写一本简单的书。最后,实现自动生成HTML及PDF文档的目标。 Doc...
  • tanghw
  • tanghw
  • 2011年10月09日 08:48
  • 10718

中文docbook转换成PDF

1、下载libxslt工具 链接:在 Windows上使用DocBook写帮助文档 解压到:D:\GnuWin32\docbook\libxslt 2、下载fop 0.95 链接:...
  • e_wsq
  • e_wsq
  • 2012年08月08日 14:00
  • 884

初识DocBook(编写技术文档的工具)

突然在Linux下看到一堆命令
  • xuyunzhang
  • xuyunzhang
  • 2014年05月29日 14:22
  • 2173

DITA与DocBook对比分析

DITA和DocBook是数字出版领域的两种标准,通过定义规范化的文档描述规则,来解决文档交付过程中遇到的问题。面向不同类型的交付出版物,DITA和DocBook各有见长,但在实际应用中也有自身的限制...
  • xsc2001
  • xsc2001
  • 2014年02月24日 15:19
  • 690

学习 Docbook 创作一个标准化的文档

http://xiaowang.net/doc/docbook/index.html界面: 学习 Docbook ...
  • greenerycn
  • greenerycn
  • 2007年01月27日 23:56
  • 1057
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:DocBook vs Apache Forrest
举报原因:
原因补充:

(最多只允许输入30个字)