目前套件中提供十個指令稿,包括處理 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.