[分享]輕輕鬆鬆撰寫 Linux 文件

[pwchi]

剛剛和swallowman討論了一夥，似乎GentooDoc也是不錯的選擇。
根據swallowman兄的測試，GentooDoc採用UTF-8編碼，轉換成HTML文件時，能夠正確相容中文語系。

另外，GentooDoc只保留撰寫說明文件所需的功能標籤，所以不會像DocBook那樣龐大而複雜。

就我目前比較看來，GentooDoc似乎是撰寫文件的好東西。

大家有何看法，歡迎討論。

[訪客]

如何取得 GentooDoc 的套件呢？

Google 怎麼找不到

[wctang]

大家有時間可以看看：
http://www.tldp.org/HOWTO/Software-Rele ... ation.html
中文版：
http://cldp.linuxforum.net/Software-Rel ... ation.html
至於linuxdoc 已沒有人維護，可以看看他們目前的作法：
http://www.tldp.org/authors/index.html#resources

提出我的建議：
我覺得 docbook xml 是比較好且通用的作法。就連 GPL 的官方網站都有 DocBook 的格式：
http://www.gnu.org/copyleft/gpl.html

雖然沒有去看 debiandoc 等文件格式，不過應該是定義 sgml dtd 格式，如此的話， docbook 應該會有更好的功能(可能會比較複雜吧…我猜)

工具方面，各個平台應該都沒問題，debian 下有 docbook2html 等，windows 下也有 cygwin 的工具。

中文方面，理論上應該可以不論用什麼編碼來寫都沒問題，也都可以轉成各種編碼，(基於 xml )，但以我目前的測試，在 windows 下用 cygwin 的 libxslt 裡的 xsltproc 工具來做，至少 utf-8 xml 轉成 utf-8 xhtml 的中文是沒問題的。

當然 DocBook 或許會格式太多，可以先依照一個 template 來填空，如：
http://www.tldp.org/authors/template/Sample-HOWTO.xml，或是 Gnome 的文件應該也有所規範。

還有看到一個有趣的東西，叫 WikiText，是用 wiki 的文件格式來產生 Docbook 文件，可以獲得大家共同線上編寫文件的功能，而且也可以產生通用文件格式，不過這東西還剛起步，應該還不能拿來用吧…

缺點：
比較複雜…設定上。
要配合 CSS 來讓文件變美觀，不過我覺得這不是缺點就是了…

以上是我的建議…

[pwchi]

經過實驗與驗證之後，如果要製作DocBook中文文件，建議存成UTF-8內碼格式。
因為在UTF-8內碼進行文件格式轉換時，可正確相容中文內容。

所以建議要製作DocBook的中文文件時，請存成UTF-8內碼格式，再進行轉換工作。

[Edward G.J. Lee]

有沒有人用過DocBook？
不知道中文的支援怎麼樣。
http://docbook.sourceforge.net/index.html

http://freebsd.sinica.edu.tw/zh-tut.php
這邊的 整頁模式(html, txt, pdf), 章節模式(html) 都是用 docbook 產生的.
所以中文沒問題的啦 :p

more information:
http://freebsd.sinica.edu.tw/zh-tut/howtoget.html

那是使用 edwar 修訂過及寫了個 macro 的 jadetex 才能如此。使用 DocBook/linuxdoc 的話，這大概是目前比較好的方式了。