Next Previous Contents

2. 安装

首先从这个地方

取得 sgml-tools-0.99.9.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
□例请参阅 deutsch

产生 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 
你也可以在 SGML 原始文件中使用 ISO 8859-1 字元,它们会自动被转换成对应文件格式的适当逸出字元(escape codes).


Next Previous Contents