6.38. Groff-1.18.1.1

Groff 软件包包含几个处理和格式化文本的程序。Groff 把标准的文本和特殊的命令翻译成格式化的输出,就像你在 man 手册页里看到的那样。
预计编译时间:0.4 SBU
所需磁盘空间:39.2 MB

6.38.1. 安装 Groff

  • 应用下面的patch来添加 "ascii8" 和 "nippon" 设备到 Groff:
    patch -Np1 -i ../groff-1.18.1.1-debian_fixes-1.patch
    

    注意:这些设备在转换一些非 ISO-8859-1 编码的非英语的 man 手册页时,会用到。现在对于 Groff-1.19.x 没有同样功能的patch。

  • 许多屏幕字体没有 Unicode 的单引号和破折号。告诉 Groff 使用等价的 ASCII 字符:
    sed -i -e 's/2010/002D/' -e 's/2212/002D/' 
    - e 's/2018/0060/' -e 's/2019/0027/' font/devutf8/R.proto
    
  • Groff 希望环境变量 PAGE 包含缺省的纸张尺寸。对于在美国的人来说,应当使用 PAGE=letter ,如果你住在其他地方,可能需要把 PAGE=letter 改成 PAGE=A4 。
  • 为编译 Groff 做准备:
    PAGE=<paper_size> ./configure --prefix=/usr --enable-multibyte
    
  • 编译软件包:make
  • 这个软件包没有附带测试程序。
  • 安装软件包:make install
  • 有些文档程序,比如 xman ,没有下面的符号链接会不能正常工作:
    ln -sv eqn /usr/bin/geqn
    ln -sv tbl /usr/bin/gtbl
    

6.38.2. Groff 的内容

  • 安装的程序:
    • addftinfo, afmtodit, eqn, eqn2graph, geqn(→eqn), grn, grodvi, groff, groffer, grog, grolbp, grolj4, grops, grotty, gtbl(→tbl), hpftodit, indxbib, lkbib, lookbib, mmroff, neqn, nroff, pfbtops, pic, pic2graph, post-grohtml, pre-grohtml, refer, soelim, tbl, tfmtodit, troff
  • 简要描述:
    • addftinfo:读取一个 troff 字体文件并增加一些 groff 系统使用的附加点阵字体。
    • afmtodit:建立同 groff 和 grops 一起使用的字体文件。
    • eqn:将嵌于 troff 输入文件中的方程描述翻译成 troff 能够理解的命令
    • eqn2graph:把 EQN 等式转换成反图像
    • geqn:指向 eqn 的连接
    • grn:groff 的 gremlin 文件预处理器
    • grodvi:groff 的产生 TeX dvi 格式的驱动
    • groff:groff 文档格式系统的前端。通常它调用 troff 程序和对指定设备适用的后处理器
    • groffer:把 groff 文件和 man 文档显示在 X 和 tty 上
    • grog:读取文件然后猜测使用 -e, -man, -me, -mm, -ms, -p, -s, -t 中的哪个 groff 参数来打印文件。并把带有这个参数的 groff 命令输出到标准输出。
    • grolbp:LBP-4 和 LBP-8 激光打印机系列的 groff 驱动
    • grolj4:产生适用于HP Laserjet4 打印机的 PCL5 格式的 groff 驱动
    • grops:将 GNU troff 的输出翻译成 PostScript
    • grotty:将 GNU troff 的标准输出翻译成适合类打字机设备的格式
    • gtbl:指向 tbl 的连接
    • hpftodit:使用 groff -Tlj4 从一个 HP-tagged 字体文件中创建 groff 使用的字体文件。
    • indxbib:建立同 refer, lookbib, lkbib 一起使用的文件的文献数据库的反向列表
    • lkbib:在文献数据库中搜索包括指定关键字的条目,并将其输出到标准输出
    • lookbib:打印一个标准错误的提示,除非标准输入不是终端。从标准输入读入关键字搜索在指定文件中的文献数据库中的含有这些关键字的条目,并将结果输出到标准输出。
    • mmroff:一个简易的 groff 预处理器
    • neqn:将方程格式化,使其成为适应 ASCII 输出的脚本
    • nroff:这个脚本用 nroff 命令仿真 groff 命令
    • pfbtops:将 .pfb 格式的 Postscript 字体翻译成 ASCII 码
    • pic:将内嵌于 troff 或 TeX 输入文件中的图像编译成 troff 或 TeX 理解的指令
    • pic2graph:把 PIC 图表转换成反图像
    • post-grohtml:将GNU troff 的输出翻译成 HTML
    • pre-grohtml:将GNU troff 的输出翻译成 HTML
    • refer:将一个文件拷贝到标准输出并丢弃 .[ 和 .] 之间作为引用的内容和在 .R1 和 .R2 之间解释如何处理这些引用的命令
    • soelim:读取文件将其中的 .so 文件 表格替换为 文件 的内容
    • tbl:将内嵌于 troff 或者 TeX 输入文件中的表格编译成 troff 或者 TeX 理解的指令
    • tfmtodit:建立 groff -Tdvi 使用的字体文件
    • troff:和 Unix 的 troff 高度兼容。一般运行 groff 来调用它,groff 依照合适的顺序并使用合适的参数来执行预处理程序和后处理程序。
下一节:gzip 包含用 Lempel-Ziv 编码(LZ77)来压缩和解压文件的程序。
预计编译时间:少于 0.1 SBU
所需磁盘空间:2.2 MB