目前套件中提供十個指令稿,包括處理 BIG5 碼的 bg5sgmlcheck
, bg5sgml2html
, bg5sgml2txt
, bg5sgml2latex
, bg5sgml2lyx
,
以及處理 GB 碼的 gbsgmlcheck
, gbsgml2html
, gbsgml2txt
, gbsgml2latex
, gbsgml2lyx
,
分別對應 SGMLtools 中的 sgmlcheck
, sgml2html
, sgml2txt
, sgml2latex
及 sgml2lyx
.
大部份的指令都可加上原來 SGMLtools 對應指令的選項(options),只有些許例外,見
註。
現以處理 BIG5 碼的指令稿為例,分別說明如下:
用來檢查 SGML 檔案格式是否正確。用法:
bg5sgmlcheck [options] file.sgml [file2.sgml ...]
所有 sgmlcheck
可用的選項(options)都可用在 bg5sgmlcheck
上。
可一次檢查數個檔案。副檔名 .sgml
可省略。
將 SGML 檔案轉換為 HTML 格式。用法:
bg5sgml2html [options] file.sgml [file2.sgml ...]
所有 sgml2html
可用的選項都可用在 bg5sgml2html
上。可一次轉換數個檔案。副檔名 .sgml
可省略。
將 SGML 檔案轉換為純文字格式。用法:
bg5sgml2txt [options] file.sgml [file2.sgml ...]
可一次檢查數個檔案。副檔名 .sgml
可省略。選項
--width=NUMBER
設定輸出寬度為 NUMBER
. 預設是 80 行。--noidx
不產生各章節的索引。可節省時間。請注意目前尚不支援 sgml2txt
專用的選項,如 --man
等。
將 SGML 檔案轉換為 tex, dvi, PostScript 格式。使用方法:
bg5sgml2latex [options] file.sgml [file2.sgml ...]
同樣地,所有 sgml2latex
可用的選項都可用在 bg5sgml2latex
上。
可一次轉換數個檔案。副檔名 .sgml
也可省略。
然而與 sgml2latex
不同的是 bg5sgml2latex
預設產生 tex 檔案,而非 dvi 檔。
如果想轉換為 dvi 或 PostScript 檔案,你還必須安裝 ChiTeX 或 CJK 套件。可從這裡取得 rpm 檔案:
ftp://ftp.linux.org.tw/pub/CLDP/rpm/ chitex-6.1.1-x.i386.rpm
選項
--output=tex
產生 tex 檔案(預設)。--output=dvi
輸出 dvi 檔案。--output=ps
輸出 PostScript 檔案。--output=all
同時輸出 tex, dvi, PostScript 檔案。--clean
刪除轉換過程中產生的暫存檔。--stop
編譯 tex 檔案遇到錯誤時暫停下來(預設是繼續編譯下去)。--font=FONT
指定中文字型為 FONT,一 ChiTeX 或 CJK 字型巨集名稱。--zhtex=CJK
產生 CJK 檔案。比較特別的是 --output=tex
, --output=dvi
, --output=ps
選項可以並存,表示同時輸出這些格式。例如:
bg5sgml2latex --clean --font=kai \
--output=tex --output=ps file.sgml
表輸出 tex 及 PostScript 檔,中文字型使用 \kai, 並刪除轉換過程中產生的 .aux
, .toc
等檔案。
將 SGML 檔案轉換為 LyX 格式。用法:
bg5sgml2lyx [options] file.sgml [file2.sgml ...]
可將 sgml2lyx
的選項都可用在 bg5sgml2lyx
上。一次可轉換數個檔案。副檔名 .sgml
可省略。
處理 GB 碼的指令稿使用方式完全同上。
--debug
, -d
是相同的。
如果該選項有附帶參數,在 bg5sgmltools
中你必須使用長的格式,例如用 --papersize=a4
而別用 -p a4
.