2. 安装

首先从这个地方

• ftp://sunsite.unc.edu/pub/Linux/utils/text/sgml-tools-0.99.0.tar.gz

你可以从 SGML-Tools WWW Page 取得最新的资讯．

sgml-tools-0.99.0.tar.gz 包含了所有你需要用来写 SGML 文件并转换为 groff, LaTeX, HTML, GNU info, LyX, 与 RTF 的东西．除此之外，你可能还需要下列的工具---SGML 系统并不需要这些，但我建议你取得这些工具以方便你转换文件，在你公开散布你的文件前将先确定它们看起来没问题．

1. groff. 你必须使用 1.08 或更新的版本．你可以从 ftp://prep.ai.mit.edu/pub/gnu 取得．在 ftp://sunsite.unc.edu/pub/Linux/utils/text 可找到 Linux 的执行档．你必需使用 groff 让你的 SGML 文件产生纯文字档． nroff 不行!
2. TeX 与 LaTeX. 这几乎在每个地方都有，你应该可以毫无困难地找到并安装 (在 sunsite.unc.edu 可以找到 Linux 的执行档) 当然，如果你要用 LaTeX 来格式化你的 SGML 文件你才需要 TeX/LaTeX．
3. flex. lex 可能不行．你可以从 ftp://prep.ai.mit.edu/pub/gnu 取得．
4. gawk 与 GNU info tools, 用来格式化与预视 info 档案． 在 ftp://prep.ai.mit.edu/pub/gnu, 或 ftp://sunsite.unc.edu/pub/Linux/utils/text 可以找到 gawk， 还有 ftp://sunsite.unc.edu/pub/Linux/system/Manual-pagers 可找到 GNU info tools. awk 不行．
5. LyX (一个半所见即所得(quasi-WYSIWYG) 的 LaTeX 界面)，可在 ftp://ftp.via.ecp.fr 找到．

2.1 安装软体

安装与设定 SGML-Tools 所需的步骤是：

1. 首先，在某处解开 sgml-tools-0.99.0.tar.gz 的压缩档． 它将产生 sgml-tools-0.99.0 的目录．在那里解开都没有关系，只是不要把里面的东西搬离 sgml-tools-0.99.0 目录就行．
2. 阅读 INSTALL 档，它包含了安装过程的细节．

如果一切顺利，你就可以使用它了．

译注: 其实就是执行 install 这支 shell script，回答它的问题就行了!

2.2 编排 SGML 文件

例如说你想要编排一份 SGML 文件叫 foo.sgml，这里有一份简短的说明如何输出成不同的格式．完整的选项列表请参考 man pages．

产生纯文字输出

如果你想产生纯文字档，使用这个指令：

% sgml2txt foo.sgml 

请注意我已调整 groff 转换为纯文字输出．也就是说，我将页首，页码，边框等去掉． 经过一些修改你可以从 groff 的输出产生 PostScript 与 DVI 格式，但我建议你用 LaTeX 比较好．

你可以为 man pages 产生 groff 的原始档，而用 groff -man 将其编排． 执行这个指令：

% sgml2txt -man foo.sgml 

产生 LaTeX, DVI 或 PostScript 输出

要从 SGML 原始档产生 LaTeX 文件，就用：

% sgml2latex foo.sgml 

如果你希望产生 PostScript 输出(经由 dvips)，可用 -p 选项：

% sgml2latex -p foo.sgml 

或者你可以加上 -d 选项产生 DVI 档：

% sgml2latex -d foo.sgml 

产生 HTML 输出

如果你希望输出 HTML 档，用这指令：

% sgml2html -img foo.sgml 

这将产生 foo.html, foo-1.html, foo-2.html, 等等 --- 每一章一个档案．foo.html 是首页，可以用你的 WWW 浏□器观看． 确定你所有的 HTML 档在同一目录下，因为它们是用相对的 URL 彼此参考的． HTML 档的图示目录指向 $SGMLTOOLSLIB/icons 所定义的目录． 这些档都应被拷贝到最後的位置上．$SGMLTOOLSLIB/ 定义在 SGML 转换程序的最开头．

如果你使用 sgml2html 而没有加上 -img 选项的话，产生的 HTML 文件会加上导读用的 "Previous", "Next", 以及 "Table of Contents" 标签． 你可以藉由在 $SGMLTOOLSLIB/rep/html/<filename> 建立一个档案以盖过这些预设， 并且以你自己的话来取代它们．该档案的格式如下所示： he following format:

        PrevPage:  newvalue
    NextPage:  newvalue
        TOC:     newvalue

产生 GNU Info 格式的输出

如果你想要将你的档案编排成 GNU Info 浏览程式接受的格式，只要使用下列指令：

% sgml2info foo.sgml 

产生 LyX 格式的输出

欲产生 LyX 格式的出，使用这个指令：

% sgml2lyx foo.sgml 

产生 RTF 格式的输出

如果你想产生 RTF 格式的输出，执行这个指令：

% sgml2rtf foo.sgml 

这将会产生 foo.rtf, 以及 foo-1.rtf, foo-2.rtf, 等等档案---文件的每一节自成一个档案．

检查 SGML 语法

如果你只是想从 SGML 转换中抓出你的错误，可以使用 sgmlcheck 这个指令稿． 例如：

% sgmlcheck foo.sgml 

2.3 ISO 8859-1 字元集

ISO 8859-1 (latin1) 字元集可以用在纯文字 LaTeX, HTML, LyX, 以及 RTF 输出的国际字元(GNU Info 未来可能支援 ISO 8859-1)． 要使用这项功能的话，可以加上 -l 选项给编排指令稿，例如：

% sgml2txt -l foo.sgml