DocBook

2014年12月30日 (二) 04:03的最后版本

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提供了大量的语义元素标记。它们分为三大类：结构，块级和内联。

[编辑] 新闻

您可以在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://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选项可指定生成文档的路径

[编辑] 图书

[编辑] 链接

<discussion>characters_max=300</discussion>

@@ 第1行： / 第1行： @@
+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提供了大量的语义元素标记。它们分为三大类：结构，块级和内联。
+*[http://book.huihoo.com/docbook-the-definitive-guide/docbook.html DocBook: The Definitive Guide]
+*[http://docs.huihoo.com/xml/using-docbook/ Writing Documentation Using DocBook]
+==新闻==
 {{SeeWikipedia}}
+*<rss>http://www.docbook.org/atom/whatsnew.xml|short|date|max=10</rss>
+==安装==
+Windows
+从 http://www.zlatkovic.com/pub/libxml/ 下载最终版
+* libxml2
+* libxslt
+* iconv
+把bin目录的文件都 copy 到 c:\docbook 下，并设置PATH环境变量
-DocBook  is an XML vocabulary that lets you create documents in a presentation-neutral form that captures the logical structure of your content. Using free tools along with the DocBook XSL stylesheets, you can publish your content as HTML pages and PDF files, and in many other formats.
+下载[http://sourceforge.net/projects/docbook/ 样式表]并解压到c:\docbook\docbook-xsl-ns
+Build
 *[[HOW-TO: Compiling the DocBook]]
-*DocBook: The Definitive Guide - http://books.huihoo.org/docbook-the-definitive-guide/docbook.html
-*Writing Documentation Using DocBook - http://docs.huihoo.com/xml/using-docbook/
-==Install==
 [[Image:docbook-module-flowchart.gif|thumb|right|Structure of the DocBook DTD]]
 Debian
@@ 第35行： / 第51行： @@
   doclifter - Convert troff to DocBook
 相关下载：http://sourceforge.net/projects/docbook/
-==Examples==
+==例子==
 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
@@ 第50行： / 第66行： @@
 用-o选项可指定生成文档的路径
-==Links==
+==图书==
+*[http://book.huihoo.com/docbook-5.1-the-definitive-guide/docbook.html 《DocBook 5.1: The Definitive Guide》]
+*[http://book.huihoo.com/docbook-5-the-definitive-guide/docbook.html 《DocBook 5: The Definitive Guide》]
+==链接==
 *http://docbook.sourceforge.net/
 *http://www.docbook.org/
-*[http://www.ringkee.com/note/opensource/docbook.htm DocBook学习笔记]
+*http://docs.huihoo.com/docbook/
-*[http://ldp.huihoo.org/linuxfocus/ChineseGB/May2002/article201.shtml 编辑DocBook XML文档]
 {{Comment}}