DocBook

2014年12月30日 (二) 04:00的版本

DocBook是一种用于文档处理的语义标记语言。它本来是打算用于编写有关计算机硬件和软件的技术文档，但它可以用于任何其它类型的文件。作为一个语义语言，DocBook让用户创建文件的内容在一个表达中立的表格中，体现了逻辑结构的内容；它的内容可以发布成各种不同的格式，包括HTML，XHTML，EPUB，PDF格式，man文件和HTML帮助等，而不需要用户在源文件中做任何的更改。

DocBook是一种XML语言。在其最新版本 5.0中，DocBook的语言被正式定义为由RELAX NG Schema集成Schematron规则。（也有W3C XML schema+ Schematron和文档类型定义（DTD）的schema版本可用，但这些被认为是非标准。） 作为一个语义语言，DocBook文件没有说明其内容“看起来像”，而是意义上的那些内容。例如，不是抽象的解释如何为一篇文章做可视化格式的摘要，DocBook只是说，在特定部分是一个摘要。它是一个外部处理工具或应用程序来决定在一页上的摘要应该和它看起来应该像什么。（实际上，决定是否应该包括在最终输出中。） DocBook提供了大量的语义元素标记。它们分为三大类：结构，块级和内联。

• DocBook: The Definitive Guide
• Writing Documentation Using DocBook

新闻

您可以在Wikipedia上了解到此条目的英文信息 DocBook Thanks, Wikipedia.

• 自http://www.docbook.org/atom/whatsnew.xml加载RSS失败或RSS源被墙

安装

Windows

从 http://www.zlatkovic.com/pub/libxml/ 下载最终版

• libxml2
• libxslt
• iconv

把bin目录的文件都 copy 到 c:\docbook 下，并设置PATH环境变量

下载样式表并解压到c:\docbook\docbook-xsl-ns

Build

• HOW-TO: Compiling the DocBook

Structure of the DocBook DTD

Debian

#apt-get install xsltproc //XSLT command line processor
#apt-get install rxp // A validating XML parser
#apt-get install docbook
#apt-get install docbook-utils - Convert Docbook files to other formats (HTML, RTF, PS, man, PDF)
#apt-get install docbook-xsl - stylesheets for processing DocBook XML files to various output formats
#apt-get install sgmltools-lite - convert DocBook SGML source into HTML using DSSSL

相关包

docbook-defguide - DocBook: The Definitive Guide - HTML version
docbook-doc - Documentation for the DocBook DTD.
docbook-dsssl - modular DocBook DSSSL stylesheets, for print and HTML
docbook-dsssl-doc - documentation for the DocBook DSSSL stylesheets
docbook-ebnf - EBNF module for the XML version of the DocBook DTD
docbook-html-forms - Extension to DocBook XML for generating html forms
docbook-jrefentry - DocBook XML JRefEntry DTD
docbook-mathml - Extension to DocBook XML for using MathML markup
docbook-simple - Simplified DocBook XML Doctype and css stylesheets.
docbook-slides - XML Slides DTD and XSL Stylesheets
docbook-slides-demo - Demo presentation slides for the docbook-slides package
docbook-to-man - converter from DocBook SGML into roff man macros
docbook-website - XML Website DTD and XSL Stylesheets
docbook-xml - standard XML documentation system, for software and systems
docbook-xsl-stylesheets-ko - Stylesheets for processing DocBook XML files to HTML and FO in korean.
docbook2x - Converts DocBook/XML  documents into man pages and TeXinfo
doclifter - Convert troff to DocBook

相关下载：http://sourceforge.net/projects/docbook/

例子

http://www.w3.org/XML/Binary/2005/03/test-data/Docbook/examples/

xsltproc docbook-xsl-1.72.0/html/docbook.xsl mybook.xml > mybook.html
xsltproc docbook-xsl-1.72.0/html/docbook.xsl mybook.xml > mybook.pdf
xsltproc docbook-xsl-1.72.0/html/docbook.xsl mybook.xml > mybook.ps
xsltproc docbook-xsl-1.72.0/html/docbook.xsl mybook.xml > mybook.rtf

利用样式表生成单页的html文档，生成文档名为debian.html，生成的文档位于当前目录。

$ xsltproc --stringparam html.stylesheet docbook.css /usr/share/sgml/docbook/docbook-xsl-1.65.1/html/docbook.xsl
debian.xml>debian.html

利用样式表生成多页的html文档，每章和每小节都会生成独立的一个html文档，生成文档位于当前目录。

$ xsltproc --stringparam html.stylesheet docbook.css /usr/share/sgml/docbook/docbook-xsl-1.65.1/html/chunk.xsl debian.xml

用-o选项可指定生成文档的路径

图书

• 《DocBook 5.1: The Definitive Guide》
• 《DocBook 5: The Definitive Guide》

链接

• http://docbook.sourceforge.net/
• http://www.docbook.org/
• http://docs.huihoo.com/docbook/

<discussion>characters_max=300</discussion>