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

[moto]

hi all ,

最近剛完成的新文章，主要用意希望大家一起來寫文件..

摘要：
======================================
本文件將教您如何撰寫 Linux 文件，透過簡單的標籤語法及 zh-sgmltools 的一些指令，就可以輕輕鬆鬆產生 html、txt、tex ..等格式的漂亮文件。
======================================

文章網址：

http://linux.nctu.edu.tw/web/moto/topic ... uxdoc.html

或者由本站 『 topics 』 底下可以找到..
icon_mrgreen.gif

[umm]

謝謝 moto 大大分享此文章

小弟有ㄍ問題.....

利用 bg5sgml2html 產生的文件.....

能否只輸出一頁(一ㄍHTML檔).......不依章節分頁........??

[moto]

謝謝 moto 大大分享此文章

小弟有ㄍ問題.....

利用 bg5sgml2html 產生的文件.....

能否只輸出一頁(一ㄍHTML檔).......不依章節分頁........??

唉...我也想過這個問題...目前只有用 bg5sgml2txt 才能如此..轉成 html 的話似乎是沒有這樣的功能...而且可惜的是..linuxdoc 也沒在維護了..所以新功能..應該不會出現..除非自己改嚕..

另外..這陣子我看了 debiandoc ...作法跟 linuxdoc 很類似..也有定義好的 dtd .. 不過..中文方面我一直 try 不出來....

有興趣的話不妨安裝底下幾個軟體：

debiandoc-sgml 1.1.72 1.1.72 1.1.72 install
debiandoc-sgml-doc 1.1.12 1.1.12 1.1.12 install
debiandoc-sgml-doc-pt-br 1.1.6 1.1.6 1.1.6 install

然後可以看 /usr/share/doc/debiandoc-sgml-doc/ 裡頭有 sgml 範例檔...

[umm]

唉...我也想過這個問題...目前只有用 bg5sgml2txt 才能如此..轉成 html 的話似乎是沒有這樣的功能...而且可惜的是..linuxdoc 也沒在維護了..所以新功能..應該不會出現..除非自己改嚕..

另外..這陣子我看了 debiandoc ...作法跟 linuxdoc 很類似..也有定義好的 dtd .. 不過..中文方面我一直 try 不出來....

有興趣的話不妨安裝底下幾個軟體：

debiandoc-sgml 1.1.72 1.1.72 1.1.72 install
debiandoc-sgml-doc 1.1.12 1.1.12 1.1.12 install
debiandoc-sgml-doc-pt-br 1.1.6 1.1.6 1.1.6 install

然後可以看 /usr/share/doc/debiandoc-sgml-doc/ 裡頭有 sgml 範例檔... :D

關於 debiandoc ㄉ中文....
是不是要加參數 "-l zh_TW.Big5"...........??

[moto]

唉...我也想過這個問題...目前只有用 bg5sgml2txt 才能如此..轉成 html 的話似乎是沒有這樣的功能...而且可惜的是..linuxdoc 也沒在維護了..所以新功能..應該不會出現..除非自己改嚕..

另外..這陣子我看了 debiandoc ...作法跟 linuxdoc 很類似..也有定義好的 dtd .. 不過..中文方面我一直 try 不出來....

有興趣的話不妨安裝底下幾個軟體：

debiandoc-sgml 1.1.72 1.1.72 1.1.72 install
debiandoc-sgml-doc 1.1.12 1.1.12 1.1.12 install
debiandoc-sgml-doc-pt-br 1.1.6 1.1.6 1.1.6 install

然後可以看 /usr/share/doc/debiandoc-sgml-doc/ 裡頭有 sgml 範例檔...

關於 debiandoc ㄉ中文....
是不是要加參數 "-l zh_TW.Big5"...........??

我有大概 try 過...但是轉出來的中文都是亂碼..

[umm]

關於 debiandoc ㄉ中文....
是不是要加參數 "-l zh_TW.Big5"...........??

我有大概 try 過...但是轉出來的中文都是亂碼.. :? :cry:

好像是個 bugㄟ........

說說小弟ㄉ步驟好ㄌ..........

首先用 vim 打一份含有中文字的 debiandoc.sgml 文件
然後執行

代碼: 選擇全部

debiandoc2html -l zh_TW.Big5 debiandoc.sgml

用瀏覽器看該 html 檔.....的卻是亂碼........
但回到原 .sgml 發現原本中文字也變亂碼ㄌ.........

此時再把該中文亂碼...改回中文字.......

再執行一次..

代碼: 選擇全部

debiandoc2html -l zh_TW.Big5 debiandoc.sgml

發現中文就出現ㄌ........真是太神奇ㄌmoto........QQ

[moto]

關於 debiandoc ㄉ中文....
是不是要加參數 "-l zh_TW.Big5"...........??

我有大概 try 過...但是轉出來的中文都是亂碼..

好像是個 bugㄟ........

說說小弟ㄉ步驟好ㄌ..........

首先用 vim 打一份含有中文字的 debiandoc.sgml 文件
然後執行

代碼: 選擇全部

debiandoc2html -l zh_TW.Big5 debiandoc.sgml

用瀏覽器看該 html 檔.....的卻是亂碼........
但回到原 .sgml 發現原本中文字也變亂碼ㄌ.........

此時再把該中文亂碼...改回中文字.......

再執行一次..

代碼: 選擇全部

debiandoc2html -l zh_TW.Big5 debiandoc.sgml

發現中文就出現ㄌ........真是太神奇ㄌmoto........QQ

真的是太神奇了...也太奇怪了...請 umm 兄再次確認 bug...
如果 debiandoc 中文 ok ..那舊太棒了...畢竟還有人在維護....
linuxdoc 已經沒維護了...麻煩您囉...

[Shardad]

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

[moto]

umm 兄，可否提供您的測試檔，我這邊可以測測看..有沒有問題..

[jthchang]

請問關於下面這頁中

http://linux.nctu.edu.tw/web/moto/topic ... oc-11.html

eps file 那一行是什麼意思??

[moto]

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

應該還不錯吧...我猜...

dockbook 也是個複雜的東西 ( 對我來說 .. )

本來有想過學 latex ， but 要安裝軟體太複雜...為了要支援中文..可能這個 package 要 upgrade ..那個 package 要用某一版..也許某個 package 又沒有包好的 deb ...呼呼...太麻煩了...所以後來放棄..不然先前看到果正兄的文章真的很想試試看..但是實在沒有那麼多時間去摸索這些東西...所以還是乖乖用 linuxdoc + sgml 來寫囉..

這一陣子跟 umm 兄一起測試了 debiandoc ，發現中文處理沒問題...但是 debiandoc 似乎不支援 image 相關的 tag ，我也找不到支援 table 的語法.. .. 所以目前也是觀察中..原則上還是會用 linuxdoc + sgml 來寫作..

[moto]

請問關於下面這頁中

http://linux.nctu.edu.tw/web/moto/topic ... oc-11.html

eps file 那一行是什麼意思??

規定的語法...經過測試..一定要有那一行..不然會有錯誤訊息..eps file 不一定要存在...

[pwchi]

我建議應該將LDP Author Guide(http://www.tldp.org/LDP/LDP-Author-Guide/)
文件中文化。

由於LDP Author Guide是撰寫LDP文件的標準依據，如果能將其中文化，
對於國內的HOWTO文件寫作與CLDP等各項中文文件計畫，將有莫大的幫助。

LDP Author Guide以DOCBOOK為編寫標準。[/url]

[moto]

好主意... .. pwchi 兄不如您起個頭..帶領大家來完成這部份工作...

[statue]

有沒有人用過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