Linux 版 (精华区)

发信人: clx (楚留香), 信区: Unix
标  题: SGML-Tools 使用说明中译版(03)
发信站: 紫 丁 香 (Sat Jun 27 17:20:50 1998), 转信

SGML-Tools 使用说明中译版 : 安装
Previous: 简介
Next: 使用 SGML-Tools 撰写文件 


2. 安装

首先从这个地方 

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

取得 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．

2.2.1. 产生纯文字输出

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

     % sgml2txt foo.sgml 

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

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

     % sgml2txt -man foo.sgml 

2.2.2. 产生 LaTeX, DVI 或 PostScript 输出

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

     % sgml2latex foo.sgml 

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

     % sgml2latex -p foo.sgml 

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

     % sgml2latex -d foo.sgml 

2.2.3. 产生 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．

2.2.4. 产生 GNU Info 格式的输出

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

     % sgml2info foo.sgml 

2.2.5. 产生 LyX 格式的输出

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

     % sgml2lyx foo.sgml 

2.2.6. 产生 RTF 格式的输出

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

     % sgml2rtf foo.sgml 

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

2.2.7. 检查 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)．


SGML-Tools 使用说明中译版 : 安装
Previous: 简介
Next: 使用 SGML-Tools 撰写文件 

--
※ 来源:．紫 丁 香 bbs.hit.edu.cn．[FROM: 202.118.244.16]