牽著老婆滿街逛

全文請看這個link：DocBook指南

1. 概述

DocBook提供了一個使用SGML/XML撰寫結(jié)構(gòu)化文檔的系統(tǒng)。這個系統(tǒng)非常適合于計算機類的文章、書籍、論文等的出版，當然并不僅僅限于計算機類。DocBook已經(jīng)被Linux、FreeBSD等眾多的項目制定作為文檔撰寫格式，并且有越來越多的組織和個人開始使用。

本文只是一個簡要指南。收集了一些DocBook的學(xué)習(xí)資料，和我自己的一些心得。

如果想快速了解DocBook，可以看這里：DocBook的HelloWorld起步。
2. DocBook語法

學(xué)習(xí)DocBook，基本的語法是一定要掌握的，即便你使用所見即所得編輯器。下面是學(xué)習(xí)DocBook語法的一些資源：

? ? *

? ?? ?Writing Documentation Using DocBook

? ?? ?一個非常好的英文Docbook語法教程。也可以作為常備的速查手冊。

? ? *

? ?? ?DocBook 助你完成傳世之作

? ?? ?中文的教程。入門必看。有助于了解DocBook的全貌。
? ? *

? ?? ?DocBook學(xué)習(xí)

? ?? ?中文語法教程。也提到了DocBook格式轉(zhuǎn)換的內(nèi)容，特別是XSLT部分，是比較好的中文資料。

3. DocBook編輯器

DocBook可以用任何文本編輯器來編輯。但是為了提高生產(chǎn)力，我們可以使用一些更方便的工具。

? ? *

? ?? ?DocBookAuthoringTools

? ?? ?這是一個DocBook書寫工具的列表。比較全面。

但上述列表還并不能大全。至少還遺漏了Kate，Quanta Plus和OpenOffice（當然還有其他一些形形色色的XML編輯器）。前面兩個都是KDE的項目，只能在KDE環(huán)境下運行。OpenOffice編輯DocBook我還沒有用過。

? ? *

? ?? ?Kate編輯DocBook XML文檔

? ?? ?這是我2002年翻譯的一篇文章。
? ? *

? ?? ?Quanta as a Docbook Editor

? ?? ?Quanta Plus是一個不錯的Html/XML編輯器，用來編輯DocBook也非常好。

我推薦的編輯器：

? ? *

? ?? ?XMLMind XML Editor

? ?? ?這是我現(xiàn)在用的DocBook編輯器。所見即所得方式。基于Java，標準版免費，可以跨平臺使用。不過我是在Linux環(huán)境用。

? ?? ?我用過不少的DocBook編輯器，這是我看見過最好用的。
? ? *

? ?? ?Quanta Plus

? ?? ?非所見即所得方式。基于KDE。

4. 轉(zhuǎn)換DocBook

DocBook格式的文件可以轉(zhuǎn)換成很多文件格式來發(fā)布。比如：Html,Rtf,Pdf,甚至Word。

在 DocBook學(xué)習(xí) 和 DocBook助你完成傳世之作兩篇文章中，介紹了 OpenJade和Saxon兩種轉(zhuǎn)換工具和它們的使用方法。

按照我很早以前的印象，使用OpenJade將DocBook轉(zhuǎn)換成RTF和Html，中文是正常的。使用其他工具，基本上多少會遇到一點中文方面的麻煩。

如果你使用XMLMind XML Editor標準版，那么在DocBook菜單下面已經(jīng)內(nèi)置了轉(zhuǎn)換成Html的工具（標準版不能將DocBook轉(zhuǎn)換成其他格式）。不過XMLMind轉(zhuǎn)換出來的html文件編碼都是iso-8859-1的。

另外，你還可以關(guān)注一下在Windows下使用的Chinese DocBook Environment（CDBE）。

下面介紹我自己使用的轉(zhuǎn)換方法。環(huán)境是Ubuntu Linux。

4.1. DocBook->Html

4.1.1. 環(huán)境準備

? ? *

? ?? ?安裝xsltproc

? ? *

? ?? ?安裝docbook-xsl

? ? *

? ?? ?建立合適的xsl

? ?? ?找到我們剛才安裝的docbook-xsl中的docbook.xsl，把它copy成docbook_utf8.xsl(因為我的系統(tǒng)語言設(shè)定是utf

。

cp /path/html/docbook.xsl /path/html/docbook_utf8.xsl

? ?? ?編輯這個docbook_utf8.xsl，找到：

<xsl: output method="html"
? ?? ?? ?? ?encoding="ISO-8859-1"
? ?? ?? ?? ?indent="no"/>

? ?? ?替換為：

<xsl: output method="html"
? ?? ?? ?? ?encoding="utf8"
? ?? ?? ?? ?indent="yes"/>

? ?? ?在這段話之后，我們添加：

<xsl: param name="html.stylesheet" select="'style.css'"></xsl:param>
<xsl: param name="table.borders.with.css" select="1"></xsl:param>
<xsl: param name="l10n.gentext.language" select="'zh_cn'"></xsl:param>
<xsl: param name="admon.graphics" select="1"></xsl:param>
<xsl: param name="section.autolabel" select="1"></xsl:param>
<xsl: param name="section.label.includes.component.label" select="1"></xsl:param>
<xsl: param name="ulink.target" select="'_blank'"></xsl:param>

? ?? ?這些是樣式表參數(shù)，它的具體意義請參考HTML Parameter Reference，這是DocBook Xsl文檔的一部分。
? ? *

? ?? ?建立轉(zhuǎn)換腳本

? ?? ?創(chuàng)建新文件/usr/bin/docbook2html,內(nèi)容如下：

#/bin/sh
xsltproc /path/html/docbook_utf8.xsl $*

? ?? ?將其設(shè)置為可執(zhí)行文件。

4.1.2. 轉(zhuǎn)換步驟

docbook2html YourDocBook.xml>YourDocBook.html

這樣，我們就得到了html結(jié)果。

這個Html可以使用同級目錄下的style.css來美化輸出。

你可以去網(wǎng)上找那些docbook轉(zhuǎn)化出來的html（根據(jù)docbook的風格是很容易識別的），然后把它們使用的css下載下來使用就可以了。

比如：

? ? *

? ?? ?http://www.sagehill.net/docbookxsl/
? ? *

? ?? ?http://worldhello.net/doc/docbook_howto/index.html
? ? *

? ?? ?http://pyrecord.freezope.org/docbook/index.html

我使用的是XMLMind XML Editor轉(zhuǎn)換出來的html所帶的css。

posted on 2006-07-14 10:58 楊粼波閱讀(1647) 評論(0) 編輯收藏引用所屬分類: 學(xué)習(xí)筆記

只有注冊用戶登錄后才能發(fā)表評論。
【推薦】100%開源！大型工業(yè)跨平臺軟件C++源碼提供，建模，組態(tài)！

相關(guān)文章: CxImage使用掩碼色設(shè)置透明色的圖 MFC獲取窗口可視狀態(tài)的兩種API方法 IsWindowVisible無法獲取到正確的狀態(tài)？基于Dialog程序,啟動時不顯示主窗口,只顯示子窗口的實現(xiàn) 絕對好用 Linux操作系統(tǒng)的8個經(jīng)典技巧 Putty相關(guān)的知識 Vim7中的Tab功能犯了一個最愚蠢的錯誤=.= 有關(guān)MFC的C1189錯誤的解決一些DX的資源

網(wǎng)站導(dǎo)航: 博客園 IT新聞 BlogJava 博問 Chat2DB 管理

青青草原综合久久大伊人导航_色综合久久天天综合_日日噜噜夜夜狠狠久久丁香五月_热久久这里只有精品

牽著老婆滿街逛

導(dǎo)航

統(tǒng)計

公告

常用鏈接

留言簿(11)

隨筆分類(466)

隨筆檔案(1513)

文章分類(46)

文章檔案(45)

相冊

收藏夾(39)

工具官網(wǎng)

技術(shù)網(wǎng)站

開源網(wǎng)站

其他窩點

收藏網(wǎng)站

銀行官網(wǎng)

友情鏈接

資源共享

搜索

積分與排名

最新評論

閱讀排行榜

Docbook寫作指南