牽著老婆滿街逛

嚴以律己,寬以待人. 三思而后行.
GMail/GTalk: yanglinbo#google.com;
MSN/Email: tx7do#yahoo.com.cn;
QQ: 3 0 3 3 9 6 9 2 0 .

Docbook寫作指南

全文請看這個link：DocBook指南

1. 概述

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

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

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

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

? ? *

? ?? ?Writing Documentation Using DocBook

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

? ? *

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

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

? ?? ?DocBook學習

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

3. DocBook編輯器

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

? ? *

? ?? ?DocBookAuthoringTools

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

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

? ? *

? ?? ?Kate編輯DocBook XML文檔

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

? ?? ?Quanta as a Docbook Editor

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

我推薦的編輯器：

? ? *

? ?? ?XMLMind XML Editor

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

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

? ?? ?Quanta Plus

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

4. 轉換DocBook

DocBook格式的文件可以轉換成很多文件格式來發布。比如：Html,Rtf,Pdf,甚至Word。

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

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

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

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

下面介紹我自己使用的轉換方法。環境是Ubuntu Linux。

4.1. DocBook->Html

4.1.1. 環境準備

? ? *

? ?? ?安裝xsltproc

? ? *

? ?? ?安裝docbook-xsl

? ? *

? ?? ?建立合適的xsl

? ?? ?找到我們剛才安裝的docbook-xsl中的docbook.xsl，把它copy成docbook_utf8.xsl(因為我的系統語言設定是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>

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

? ?? ?建立轉換腳本

? ?? ?創建新文件/usr/bin/docbook2html,內容如下：

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

? ?? ?將其設置為可執行文件。

4.1.2. 轉換步驟

docbook2html YourDocBook.xml>YourDocBook.html

這樣，我們就得到了html結果。

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

你可以去網上找那些docbook轉化出來的html（根據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轉換出來的html所帶的css。

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

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

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

網站導航: 博客園 IT新聞 BlogJava 博問 Chat2DB 管理

牽著老婆滿街逛

導航

統計

公告

常用鏈接

留言簿(11)

隨筆分類(466)

隨筆檔案(1513)

文章分類(46)

文章檔案(45)

相冊

收藏夾(39)

工具官網

技術網站

開源網站

其他窩點

收藏網站

銀行官網

友情鏈接

資源共享

搜索

積分與排名

最新評論

閱讀排行榜

Docbook寫作指南