hantsy

  • 关注
  • 短消息
  • 送银子
文章
0
评论
1
推荐
0
收藏
0
社区会龄
7 年
个人网站
hantsy.cublog.cn
个人简介
还没有输入个人简介……

评论了

  • 2012-01-25 14:54

    >docbook格式是最有名的(从SGML演化过来?),Orielly和Pragmatic出版社缺省就用它,它能 很方便的转化出出版要的各种样式。如Jenkins - the definition guide开源书就是采用docbook。但由于是XML格式,很多人不习惯,而且多人网上协作不是很方便。 DOCBOOK 只是一套规范格式,它可以用 SGML,XML 来写,XML的语法定义格式有DTD,XML Schema,Relax NG。我喜欢最常用的方式,使用 DTD 定义,XML来写,使用 XLST 和一些工具来输出其它格式。 从出版的角度,DOCBOOK 几乎是其它工具无法超越的。 不管是markdown, 还是textile 最初都是为输出 HTML为准备,正如 markdown 网站所说的那样,markdown 是 writing format, HTML 是它的最终 publishing format ,而且 markdown 相对较弱,主要针对以文为主文章,在文本表示方面远不如 DOCBOOK。DocBook 从一开始就考虑了多种格式的输出。而 markdown 只是定义们简化 HTML 编写过程,这样带来的问题,没有原生的输出其他格式,特别是 PDF,现在的方案都是通过中间格式转换。 SUN 和 Oreilly是 DOCBOOK 最初的推动力。目前 DOCBOOK 广泛用于开源社区文档组织,如大家熟悉的 Hibernate,Spring,JBoss 及 Redhat 其他商业产品(不过现在 JBoss 有部分移植到 Confluence Wiki上)的文档几乎都是用 Docbook。 非常可惜的, DOCBOOK 入门容易,但要自定义输出样式,需要对 DOCBOOK 规范和转换过程相当熟悉,这对国内的出版来说,似乎是难题,目前没有一家有自己的一套输出样式(我想 Oreilly和 Programtic 都有自己修改的一套样式,写完了DocBOOK 文件后,只要使用它们的样式输出来就是漂亮的文档了。)。