牽著老婆滿街逛

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

導(dǎo)航

<

2012年11月

>

日

一

二

三

四

五

六

28

29

30

31

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

1

2

3

4

5

6

7

8

統(tǒng)計(jì)

隨筆 - 1513
文章 - 45
評(píng)論 - 907
引用 - 0

公告

言論：
1.每日自?。?/br> 2.享受人生；
3.盡力而為；
4.堅(jiān)持不懈；
5.切莫急躁；
6.慎言敏行；
7.動(dòng)心忍性；
8.上善若水。

常用鏈接

留言簿(11)

隨筆分類(466)

隨筆檔案(1513)

文章分類(46)

文章檔案(45)

相冊(cè)

收藏夾(39)

搜索

積分與排名

積分 - 2523553
排名 - 2

閱讀排行榜

Docbook寫作指南

全文請(qǐng)看這個(gè)link：DocBook指南

1. 概述

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

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

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

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

? ? *

? ?? ?Writing Documentation Using DocBook

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

? ? *

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

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

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

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

3. DocBook編輯器

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

? ? *

? ?? ?DocBookAuthoringTools

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

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

? ? *

? ?? ?Kate編輯DocBook XML文檔

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

? ?? ?Quanta as a Docbook Editor

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

我推薦的編輯器：

? ? *

? ?? ?XMLMind XML Editor

? ?? ?這是我現(xiàn)在用的DocBook編輯器。所見即所得方式?；贘ava，標(biāo)準(zhǔn)版免費(fèi)，可以跨平臺(tái)使用。不過我是在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，中文是正常的。使用其他工具，基本上多少會(huì)遇到一點(diǎn)中文方面的麻煩。

如果你使用XMLMind XML Editor標(biāo)準(zhǔn)版，那么在DocBook菜單下面已經(jīng)內(nèi)置了轉(zhuǎn)換成Html的工具（標(biāo)準(zhǔn)版不能將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)境準(zhǔn)備

? ? *

? ?? ?安裝xsltproc

? ? *

? ?? ?安裝docbook-xsl

? ? *

? ?? ?建立合適的xsl

? ?? ?找到我們剛才安裝的docbook-xsl中的docbook.xsl，把它c(diǎn)opy成docbook_utf8.xsl(因?yàn)槲业南到y(tǒng)語言設(shè)定是utf

。

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

? ?? ?編輯這個(gè)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ù)，它的具體意義請(qǐng)參考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é)果。

這個(gè)Html可以使用同級(jí)目錄下的style.css來美化輸出。

你可以去網(wǎng)上找那些docbook轉(zhuǎn)化出來的html（根據(jù)docbook的風(fēng)格是很容易識(shí)別的），然后把它們使用的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) 評(píng)論(0) 編輯收藏引用所屬分類: 學(xué)習(xí)筆記

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

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

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

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

牽著老婆滿街逛

導(dǎo)航

統(tǒng)計(jì)

公告

常用鏈接

留言簿(11)

隨筆分類(466)

隨筆檔案(1513)

文章分類(46)

文章檔案(45)

相冊(cè)

收藏夾(39)

工具官網(wǎng)

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

開源網(wǎng)站

其他窩點(diǎn)

收藏網(wǎng)站

銀行官網(wǎng)

友情鏈接

資源共享

搜索

積分與排名

最新評(píng)論

閱讀排行榜

Docbook寫作指南