[文件] 在 Debian 建立 DocBook XML 編譯環境

[weily]

昨天把 DocBook XML 編譯環境搞定了，終於可以開始寫些文件了，小弟也是初學 DocBook XML，丟出這篇希望能拋磚引玉，吸引大家加入 DocBook XML 的行列，大家一起研究學習吧...

1.為什麼是 DocBook XML 4.2?
沒為什麼，因為這是 ldp 目前最推薦的文件標準，之前也試過 moto 大大的 linuxdoc sgml，只是覺得 ldp 目前推薦 DocBook XML 4.2，既然初學就直接跳進來了。

2.安裝軟體
apt-get install jade docbook-dsssl docbook-xml
剩下的套件會一併補全...

3.下載 ldp 最新文件樣式
下載 http://www.tldp.org/authors/tools/ldp.dsl
存到 /usr/share/sgml/docbook/stylesheet/dsssl/ldp/
(如果有系統潔癖的人可以 apt-get install ldp-docbook-dsssl，同一回事，只是文件樣式不見得是最新的。)

4. 下載 ldp 文件範本(DocBook XML 4.2)
下載 http://www.tldp.org/authors/template/Sample-HOWTO.xml 至個人工作目錄

5. 編譯文件
小弟寫個小 Makefile 來偷懶...ccc

# Makefile for compile xml
SOURCE = $(shell ls *.xml)

JADE = jade

DSLFILE = /usr/share/sgml/docbook/stylesheet/dsssl/ldp/ldp.dsl
DCLFILE = /usr/lib/sgml/declaration/xml.dcl

all:
$(JADE) -t xml -i html -d $(DSLFILE)#html $(DCLFILE) $(SOURCE)

clean:
@rm -f *.html *~ *.bak
# End of Makefile

存成Makefile，然後 make 就 ok 了...
不過該目錄下只能有一個 xml 檔，多個就不知道了，我猜會出錯...ccc

6. 撰寫自己的文件
直接拿 Sample-HOWTO.xml 來改就好了，至於要不要像 moto 大大那樣每個 tag 都解釋一下...嗯...我考慮一下...ccc

7. 中文支援
小弟試過完全沒有問題，直接把 Sample-HOWTO.xml 改成中文就 ok 了...

8. 恭喜您加入 DocBook XML 的行列
有問題請回報，謝謝...

[訪客]

能把你做的文件放在網路讓我參考一下嗎？

[訪客]

其實 Debian 上可以隨裝即用 DocBook，包含 DSSSL/XSL 等樣式表(stylesheets) 與格式轉換處理器等一應俱全。除了常見的文章/書籍用的樣式表，Debian 官方套件中還有可以作為簡報或網站用途的樣式表(都是 XSL Stylesheets)。

個人是用 xsltproc 轉譯格式，配合 XInclude ，還蠻適合將章節分檔，以作為大型文件計畫用途。如果熟習 XML/XSL/XSLT 技巧，利用現有的樣式表延伸出不同的網頁與風格都十分方便。

除了用一般文字編輯器編輯外，有一個友善的 XML 編輯器軟體計畫稱為 Conglomerate，他提供了一個比較友善的編輯介面，樹狀的標籤格式，早先版本可以自動解讀不同的 XML 格式現在改為內建支援格式，DocBook 是主要的編輯格式，使用者不用強記標籤名稱，而從介面自動選取，由於 DocBook 支援將近四百個不同的元素，這樣對於新手較容易入門。同時支援匯出功能，可使用 XSLT 引擎轉出 HTML 等格式。主要的缺點是 .... 現在的版本很不穩定。

-DJ

[actt]

請問一下喔...最近在用docbook弄些文件...但遇到一個問題...

因為在文件裡圖片的編號都是自動產生的...但當我文章想要引用這些編號的時候該怎麼引用呢..??

假設說我第一章有圖Figure 1-1.

那我想要在文章中寫說"如Figure 1-1.所示"之類的句子的話...

那要怎麼辦呢...??只能用數的嗎...有其他方法嗎..??

謝謝...

[weily]

用數的?? 萬一在之前插入一張圖...
那豈不是全部的文章都要全部都要改過...

其實 xml 就跟 latex 一樣，希望作者把心力花在寫文件上，剩下的雜事交給 tool 去做就好了...

廢話講完了...作法：

在圖 xml 處：
<figure id="test1" >
<title>我是 test1 圖</title>
<mediaobject>
<imageobject>
<imagedata fileref="fig1.jpg" format="JPG"></imagedata>
</imageobject>
</mediaobject>
</figure>

在引用文 xml 處：
如<xref linkend="test1" />所示...blah blah blah...

chapter, sect1~sect5, table 等很多地方都可以用 xref...

DocBook: The Definitive Guide 是 docbook 的聖經，想學 docbook 可以看，以下網址有這本書：http://www.docbook.org/tdg/en/

btw, 順道感謝 DJ 兄, 小弟目前也改用 xsltproc 轉譯文件...

[lincoln]

昨天把 DocBook XML 編譯環境搞定了，終於可以開始寫些文件了，小弟也是初學 DocBook XML，丟出這篇希望能拋磚引玉，吸引大家加入 DocBook XML 的行列，大家一起研究學習吧...

1.為什麼是 DocBook XML 4.2?
沒為什麼，因為這是 ldp 目前最推薦的文件標準，之前也試過 moto 大大的 linuxdoc sgml，只是覺得 ldp 目前推薦 DocBook XML 4.2，既然初學就直接跳進來了。

2.安裝軟體
apt-get install jade docbook-dsssl docbook-xml
剩下的套件會一併補全...

3.下載 ldp 最新文件樣式
下載 http://www.tldp.org/authors/tools/ldp.dsl
存到 /usr/share/sgml/docbook/stylesheet/dsssl/ldp/
(如果有系統潔癖的人可以 apt-get install ldp-docbook-dsssl，同一回事，只是文件樣式不見得是最新的。)

4. 下載 ldp 文件範本(DocBook XML 4.2)
下載 http://www.tldp.org/authors/template/Sample-HOWTO.xml 至個人工作目錄

5. 編譯文件
小弟寫個小 Makefile 來偷懶...ccc

# Makefile for compile xml
SOURCE = $(shell ls *.xml)

JADE = jade

DSLFILE = /usr/share/sgml/docbook/stylesheet/dsssl/ldp/ldp.dsl
DCLFILE = /usr/lib/sgml/declaration/xml.dcl

all:
$(JADE) -t xml -i html -d $(DSLFILE)#html $(DCLFILE) $(SOURCE)

clean:
@rm -f *.html *~ *.bak
# End of Makefile

存成Makefile，然後 make 就 ok 了...
不過該目錄下只能有一個 xml 檔，多個就不知道了，我猜會出錯...ccc

6. 撰寫自己的文件
直接拿 Sample-HOWTO.xml 來改就好了，至於要不要像 moto 大大那樣每個 tag 都解釋一下...嗯...我考慮一下...ccc

7. 中文支援
小弟試過完全沒有問題，直接把 Sample-HOWTO.xml 改成中文就 ok 了...

8. 恭喜您加入 DocBook XML 的行列
有問題請回報，謝謝...

我想學docbook，我按照這個方法安裝，沒有錯誤訊息，應該是有安裝成功，請問一下，要將.xml 與.sgml 輸出成.html檔，指令應該怎樣下?看了網路上另一篇老貢生的文章(http://www.study-area.org/tips/doctrans/doctrans.html )，方法與debian 的不一樣，可否詳細說明一下，謝謝。