DocBook

编写技术文档，我想谁都遇到过。很多人都用MS Word，不可否认Word的功能确实非常强大，但是用Word有一些缺点无法避免： 1) 写文档的时候，不得不兼顾文档的格式，这是件很头痛的事情，至少对我来说。经常是最后不得不Review好几遍，就是为了统一格式，即使使用模板也不能避免这个问题。 2) 无法进行有效的版本控制，因为Word保存的是二进制格式，这就不能使用CVS的版本控制功能，只能手工合并

Transition Docbook 版本0.1 版权 © 2005 lt 本文档采用docBook-xml-4.2标准书写,使用saxon6.5.3输出html和fo,用fop0.20.5把fo转换成pdf。 刚开始用docbook写文档觉得非常的不适应，毕竟比起用所见即所得的编辑工具来，要费事很多，其中文档的转换我就很费周折， 最终通过查阅网上资料得以解决，希望本文能给正在为转换docbook

《Mac配置docbook工具链》

Markdown 编写原文档相对容易，但也需要一些指定格式符号，并生成的html文件与pdf文件，没有目录，并且pdf文件没有页数。如果要添加目录或者页数，需要编程脚本实现，门槛较高。 Docbook 编写原文档需要校验xml的格式，门槛较高，但是根据已有的模板，可相对容易。并且生成的html文件有目录，生成pdf文件有目录以及页数。

  我使用Docbook写文档大约才一两个月的时间，但关注Docbook已经很久了，在网上也阅读了很多中文及英文的Docbook文档。一直没用 Docbook的主要原因是Docbook 4.2的编译环境配置看起来很繁琐。我曾经尝试配置过一次，但看到一大堆catalog配置、SGML配置、OpenJade配置，最终放弃了。 直到有一天，我看到benr写的Playing With DocBook 5.

http://xiaowang.net/doc/docbook/index.html 界面: 学习 Docbook      下一页 学习 Docbook 创作一个标准化的文档 Wei Wang xiaowang.net <wangwei0609 at gmail.com>      下一页      第 1 章 My first chapter  转自:http://xiaowang.net/b

我们创建了一张图像，拟在HTML页面及PDF文档中显示。当图像太大时，由于PDF文档一般是A4纸，空间极其有限，可能无法完全显示全部图像。 一种解决的方法是分别为HTML及PDF创建大小不同的图像，然后分别为HTML及PDF指定相应的图像。但这种方法使工作量倍增。 DocBook的<imagedata>的width属性的含义与HTML中的width属性含义不同。对于<imagedata>，widt

今天终于再也受不了DocBook源文档那糟糕的可读性、用xslt转换时的超慢速度，对我日常写的简单的文章，它带来的维护成本实在是有些高，试用了一下txt2tags，很满意，源文档的可读性很好，同时又支持到多种格式的转换，速度也很快，不能说LaTex和DocBook不好，但对我目前写的东西，txt2tags应该是最合适的了，简单的问题就应该用简单的办法来解决！查了一下wiki，像txt2tags之类

经过 析软网团队和 i18n-zh团队的全力合作，终于结束了对 DocBook 5.0 : The Definitive Guide 除元素参考之外的部分的翻译。这为广大中文 DocBook 爱好者们提供了一份不可多得的参考材料，元素参考部分的中文翻译将在未来的一个月内完成，欢迎 DocBook fans 们的关注。 《DocBook 5.0 :权威指南》目前仅有 HTML 版本，PDF 版本将在

Docbook 做为一个文档格式，在开源社区比较流行 优点： 跨平台，如word就不能在linux中显示 中间格式，可以随便转到相关的目标格式，比如html(单，多），pdf 在版本仓库中，可以比较，因为它是xml文本 对maven的项目比较合适，因为有相关的maven plugin支持它 开源 缺点： 编辑工具只是普通的xml工具，不能做到所见即所得  

经过 析软网团队和 i18n-zh团队的全力合作，终于结束了对 DocBook 5.0 : The Definitive Guide 所有内容的翻译。这为广大中文 DocBook 爱好者们提供了一份不可多得的参考材料。 《DocBook 5.0 :权威指南》目前仅有 HTML 版本，PDF 版本将在未来的几天内发布，请感兴趣的同志们密切关切本blog、 析软网 和 i18n-zh 。 此文档目前是

[综合]用DocBook直接写CSDN的Blog 1. DocBook DocBook非常适合写科技类文章，具体介绍可以在网上看看。 写DocBook也可以采用工具的，见http://blog.csdn.net/kernelspirit/archive/2006/12/13/1441163.aspx 写CSDN的Blog也可以用DocBook来写，我的Blog现在基本上都是用DocBook来写，写

  参考： http://addcn.blogbus.com/logs/94311060.html http://www.haogongju.net/art/992927 http://www.haogongju.net/art/1000907 http://dev.sei.pku.edu.cn/trac/pkuas/wiki/%E5%A6%82%E4%BD%95%E7%94%A8docbook%

DocBook书写CSDN blog 琴剑 <keensword007@sina.com>   本文使用docbook书写，您可以在这里获得xml文件   Copyright © 2008 琴剑 Abstract 描述了使用DocBook书写blog遇到的换行问题及解决方法 我现在开始使用DocBook书写文档了，blog也不例外。使用DocBook的优点就是一份源文件能够有多种展现形式，比如可以

决定开始研究“文档持续集成”，于是到处搜资料，找到了DocBook 。根据最近看了DocBook的各种介绍，愈发觉得它正是我所需要的东西。 几点发现： 1。一个叫做“梁老师”的人搭建了一个“中国DocBook环境CDBE”，研究一下。 http://wiki.woodpecker.org.cn/moin/CDBE 2。国人的OpenSource，研究一下。 http://www.newsmth.n

Docbook提供了整个书写结构化文档的体系，它使用SGML/XML定义了一系列文档元素，并可以利用工具把原始的文档源文件转换成各种文档 格式。它最适合用来书写计算机文档、论文。很多开源软件项目都使用Docbook来写自己的文档。在我看来，使用Docbook写文档的好处有以下几点： * 内容与格式分离 我们用Word写文档时，除了书写文档内容之外，还要经常对文档的样式进行排版。我们都知道，排版很是

docbook默认是不能够对字体进行颜色设置的。但是通过扩展可以达到对html和pdf输出的颜色设置。 （一）首先，我们来谈论一下如何对html的输出进行颜色设置。 对html的输出情况下要简单一些，只需要通过css样式控制即可，而且这个docbook是内嵌支持的。 在docbook的xml文件中，我们如下书写： 这是一个测试DocBook<emphasis role="mytestclass">

这是一个最基本的 Docbook 文档 <?xml version='1.0' encoding="UTF-8"?> <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.5/zh_cn" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> “分子元素”一节中详细介绍

Apache 2.0 uses Doxygen to document the APIs and global variables in the the code. This will explain the basics of how to document using Doxygen. Brief Description To start a documentation block, use

DocBook XSL 可以将 DocBook 转化为 EPUB 的样式表的最新版本。这个 DocBook XSL 包还包括生成完整 EPUB 档案的 Ruby 脚本

Sphinx简单来说，是一个文档生成工具，用于把reStructuredText 格式的源文件生成诸如HTML, PDF, LaTex一类的格式。编辑者无须亲自处理文本的格式, 程序会自动根据源文件里的设置产生格式, 以及自动生成章节链接等工作。 和 DocBook一样，Sphinx可以看做是一个把文本格式处理和文字编辑分开的工具。举个例子来说吧，大家一定都曾有过上学时用Word痛苦地修改论文 的

作业控制语言（JCL）是多虚拟存储（MVS）的命令语言，它是 IBM 大型机计算机中常用的操作系统。 JCL 识别要执行的程序，所需的输入和输入/输出的位置，并通过作业控制语句通知操作系统。

实体可以用来作这件事情 有两个文件一个是主文件docbook.xml，包含文件头和文档信息；另一个文件file.xml是文档内容，主文件如下： <?xml version='1.0' encoding="UTF-8"?> <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5/zh_cn" "http://www.oasis-open.org/