grops - 云端在线

程序：

您的姓名

grops - groff 的 PostScript 驱动程序

概要

摸索 [-glmv[-b n[-c n[-F DIR[-I DIR[-p 纸型[-P 序幕[-w n[档
...]

商品描述

摸索 翻译 GNU 的输出 的troff 到 PostScript。 一般 摸索 应该被调用
通过使用带有一个的 groff 命令 -Tps 选项。 （实际上，这是 groff 的默认设置。）
如果没有给出文件， 摸索 读取标准输入。 一个文件名 - 也导致 摸索
读取标准输入。 PostScript 输出被写入标准输出。 什么时候
摸索 由...运行 groff的 选项可以传递给 摸索 运用 groff的's -P 选项。

需要注意的是 摸索 不产生有效的文档结构（符合文档
结构约定）如果使用多个文件参数调用。 打印这样的
连接输出 有必要在打印程序中停用 DSC 处理或
预览器。 见部分 字体 安装 下面是如何安装字体的指南
摸索.

配置

命令行选项和它的参数之间可以有空格。

-bn 为较旧的打印机、损坏的后台处理程序和预览程序提供解决方法。 一般
摸索 生成符合文档的 PostScript LanguageLevel 2 输出
结构约定 3.0 版。 一些较旧的打印机、假脱机程序和预览程序
无法处理这样的输出。 的价值 n 控制什么 摸索 做它的
此类程序可接受的输出。 值为 0 会导致 grops 不使用任何
解决方法。

没有的话加1 %%开始文档设置 和 %%结束文档设置 评论应该是
生成； 这是被混淆的早期版本的 TranScript 所需要的
之间的任何事情 %%结束序言 评论和第一个 ％％页 评论。

如果包含文件中的行以开头，则添加 2 %! 应该被剥离； 这是
Sun 的网页浏览预览器需要它。

加4如果 ％％页, ％％预告片 和 %%结束序言 评论应该去掉
包含的文件； 这是不理解的假脱机程序所需要的 ％％开始-
文件 和 %%结束文档 意见。

如果 PostScript 输出的第一行应该是 %!PS-Adobe-2.0 宁
比 %!PS-Adobe-3.0; 将 Sun 的 Newsprint 与打印机一起使用时需要这样做
需要翻页。

如果文档中不应包含介质尺寸信息，则添加 16（这是，
既不使用 %%文档媒体 也不是 设置页面设​​备 PostScript 命令）。 这是
groff 1.18.1 及更早版本的行为； 旧打印机需要它
不懂 PostScript LanguageLevel 2. 如果
输出被进一步处理以获得封装的 PS (EPS) 文件 - 见下文。

默认值可以由

破 n

DESC 文件中的命令。 否则默认值为 0。

-cn 打印 n 每页的副本。

-FDIR 前置目录 DIR的/ dev姓名 到序言、字体和设备的搜索路径
描述文件； 姓名 是设备的名称，通常是 ps.

-g 猜测页面长度。 这将生成猜测页面的 PostScript 代码
长度。 只有当可成像区域垂直居中时，猜测才是正确的
这一页。 此选项允许您生成可以同时打印的文档
letter (8.5×11) 纸和 A4 纸上没有变化。

-IDIR 此选项可用于将目录添加到文件的搜索路径中
命令行和命名的文件 \X'ps： 进口' 和 \X'ps： 文件' 逃脱。 这
搜索路径用当前目录初始化。 这个选项可能是
指定不止一次； 然后按照指定的顺序搜索目录
（但在当前目录之前）。 如果要使当前目录为
在其他目录之前阅读，添加 -一世。 在适当的地方。

不会对具有绝对文件名的文件执行目录搜索。

-l 以横向格式打印文档。

-m 为文档打开手动进纸。

-p纸张大小
设置输出介质的物理尺寸。 这将覆盖 纸型,
纸张长度和 纸宽 命令在 倒序 文件; 它接受相同的
参数作为 纸型 命令。 见 格罗夫字体 (5) 了解详情。

-P序言文件
使用文件 序言文件 （在字体路径中）作为序言而不是
默认序言文件 序幕. 此选项覆盖环境变量
GROPS_PROLOGUE。

-wn 应使用厚度绘制线条 n 一个 em 的千分之一。 如果这个选项
未给出，线宽默认为 0.04 em。

-v 打印版本号。

用法

输入到 摸索 必须是格式输出 的troff(1). 这在
格罗夫输出（5）。

此外，所用设备的设备和字体描述文件必须满足一定的要求。
要求：分辨率必须是72倍的整数倍 尺码。 该
ps 设备使用 72000 的分辨率和 1000 的 sizescale。

设备描述文件必须包含有效的纸张尺寸； 看 格罗夫字体(5) 更多
信息。

每个字体描述文件必须包含一个命令

内部名称 名称

它说字体的 PostScript 名称是 名称. 它也可能包含一个命令

编码 编码文件

这表示 PostScript 字体应该使用中描述的编码重新编码
编码文件; 此文件应包含以下形式的一系列行：

字符 码

协调 字符 是角色的 PostScript 名称，并且 码 是它在
编码表示为十进制整数； 有效值在 0 到 255 的范围内。
从...开始 # 和空白行被忽略。 中给出的每个字符的代码
字体文件必须与编码文件中字符的编码相对应，或者与编码
如果不重新编码 PostScript 字体，则使用字体的默认编码。 这个
代码可以与 \N 转义序列 的troff 选择字符，即使
角色没有 groff 名称。 字体文件中的每个字符都必须存在于
PostScript 字体，字体文件中给出的宽度必须与字体文件中使用的宽度相匹配。
PostScript 字体。 摸索 假设具有 groff 名称的字符 空间 空白
（在页面上不做标记）； 它可以利用这样的字符来生成更多
高效且紧凑的 PostScript 输出。

需要注意的是 摸索 能够以 PostScript 字体显示所有字形，而不仅仅是 256。
编码文件 （或默认编码，如果没有指定编码文件）只是定义了
前 256 个字符的字形； 所有其他字形都可以通过额外的方式访问
编码向量 摸索 即时生产。

摸索 可以自动包含打印文档所需的可下载字体。
此类字体必须为 PFA 格式。 用 聚苯硫醚(1) 将 Type 1 字体转换为 PFB 格式。
任何可下载的字体，在需要时应包含在 摸索 必须列在
文件 /usr/share/groff/1.22.3/font/devps/download; 这应该由以下几行组成
申请

字体 文件名

协调 字体 是字体的 PostScript 名称，并且 文件名 是文件名
包含字体； 以开头的行 # 空行被忽略； 字段可能是
由制表符或空格分隔； 文件名 使用相同的机制进行搜索
用于 groff 字体度量文件。 这 download 文件本身也被搜索使用
这种机制； 当前，仅使用字体路径中第一个找到的文件。

如果包含可下载字体的文件或导入的文档符合 Adob​​e
文档结构约定，然后 摸索 解释文件中的任何注释
足以确保其自身的输出符合要求。 它还提供任何需要的
中列出的字体资源 download 文件以及任何需要的文件资源。
它还能够处理资源间的依赖关系。 例如，假设你有
一种名为 Garamond 的可下载字体，以及一种名为 Garamond-Outline 的可下载字体
这取决于 Garamond（通常定义为复制 Garamond 的字体
字典，并更改 PaintType），那么 Garamond 必须出现在之前
PostScript 文档中的 Garamond-Outline。 摸索 自动处理这个提供
Garamond-Outline 的可下载字体文件表明它对 Garamond 的依赖
通过文件结构公约，例如从
以下几行

%!PS-Adobe-3.0 资源字体
%%所需文档资源： 字体 加拉蒙
%%结束评论
%%包括资源： 字体 加拉蒙

在这种情况下，Garamond 和 Garamond-Outline 都需要列在 download
文件。 可下载字体不应在 %%文档提供-
资源中心 评论。

摸索 不解释 %%文档字体 注释。 这 %%所需文档资源,
%%文档提供的资源, %%包含资源, %%开始资源和 %%结束资源
评论（或者可能是旧的 %%所需文档字体, %%文档提供的字体, ％％包括-
字体, %%开始字体和 %%结束字体 注释）应该使用。

在默认设置中，有一些样式称为 R, I, B和 BI 安装在字体位置 1
到 4. 将字体分组到系列中 A, BM, C, H, HN, N, P和 T 有成员在
这些样式中的每一个：

AR 先锋书
AI 前卫书斜
AB 先锋派
ABI 前卫-半斜
BMR 文人灯
身高体重指数 Bookman-Light斜体
BMB 布克曼-黛米
BMBI Bookman-半斜体
CR 信使
CI 斜信使
CB 信使-大胆
CBI Courier-BoldOblique
HR 黑体
HI 斜体字体
HB 黑体粗体
哈佛商业学院 Helvetica-BoldOblique
氢能天然橡胶 Helvetica-窄
HNI Helvetica-窄-斜
HNB Helvetica-窄-粗体
高压钠灯 Helvetica-窄-粗斜体
NR NewCenturySchlbk-罗马
NI NewCenturySchlbk-斜体
NB NewCenturySchlbk-黑体
NBI NewCenturySchlbk-粗斜体
PR 帕拉蒂诺-罗马
PI 帕拉蒂诺-斜体
PB 帕拉蒂诺-粗体
PBI Palatino-Bold 斜体
TR 时代罗马
TI 时代-斜体
TB 时代大胆
TBI 时代粗斜体

还有以下字体不是家族成员：

中电 ZapfChancery-中斜体

还有一些特殊的字体叫做 S 对于 PS Symbol 字体，以及 SS，含有
取自 PS Symbol 的倾斜小写希腊字母。 Zapf Dingbats 可用作 ZD,
和 ZapfDingbats 的反向版本（符号指向相反的方向）
可作为 ZDR; 这些字体中的大多数字符都是未命名的，必须使用
\N.

默认颜色为 \m 和 \M 是黑色的； 对于在 'rgb' 颜色空间中定义的颜色
设置颜色 用于 'cmy' 和 'cmyk' 设置颜色，对于“灰色” 设置灰色。 注意
设置颜色 是 PostScript LanguageLevel 2 命令，因此在一些较旧的版本上不可用
打印机。

摸索 理解使用生成的各种 X 命令 \X 转义序列； 摸索 仅由
解释以 a 开头的命令 PS： 标签。

\X'ps： EXEC 码'
这将执行任意 PostScript 命令 码. 后记
currentpoint 被设置为 \X 执行前命令 码。 该
原点在页面的左上角，y 坐标向下增加
页。 一个程序 u 定义将 groff 单位转换为坐标系
实际上（前提是用户不更改比例）。 例如，

.nr x 1i
\X'ps： EXEC \nx u 0 里内托 中风'

画一条一英寸长的水平线。 码 可能会更改图形
状态，但任何更改仅保留到页面末尾。 一本字典
包含指定的定义 DEF 和 定义 在上面
字典堆栈。 如果您的代码向本词典添加定义，您应该
为他们分配空间使用 \X'ps 定义 n'. 任何定义只持续到
页面的结尾。 如果您使用 \Y 带有名称的参数的转义序列
一个宏， 码 可以扩展到多行。 例如，

.nr x 1i
。德 y
PS： EXEC
\nx u 0 里内托
行程
..
\YY

是另一种绘制一英寸长的水平线的方法。 注意单个反斜杠
在“nx”之前——定义宏“y”时使用数字寄存器的唯一原因
是将用户指定的维度“1i”转换为内部 groff 单位
转为 PS 单位 u 的程序。

摸索 将用户指定的 PostScript 代码包装到字典中，仅此而已。 在
特别是，它不会开始和结束插入的代码 保存 和 恢复,
分别。 如有必要，这必须由用户提供。

\X'ps： 文件 姓名'
这与 EXEC 命令，除了 PostScript 代码是从
文件 姓名.

\X'ps： DEF 码'
放置包含在的 PostScript 定义 码 在序言中。 应该有
每个最多一个定义 \X 命令。 长定义可以分成几个
\X 命令； 一切 码 参数简单地连接在一起，由
换行符。 定义放在自动推送的字典中
在字典堆栈上，当 EXEC 命令被执行。 如果您使用 \Y 逃生
带有命名宏的参数的序列， 码 可以扩展到多行。

\X'ps： 定义 n 码'
喜欢 DEF，除了 码 最多可包含 n 定义。 摸索 需要知道
有多少定义 码 包含以便它可以创建一个适当大小的
PostScript 字典来包含它们。

\X'ps： 进口 文件 LLX LLY 乌尔克斯 URY 宽度 [ 高度 ]'
从中导入 PostScript 图形 文件. 论据 LLX, LLY, 乌尔克斯和 URY 给
默认 PostScript 坐标系中图形的边界框； 他们
都应该是整数； LLX 和 LLY 是左下角的 x 和 y 坐标
图形的一角； 乌尔克斯 和 URY 是右上角的 x 和 y 坐标
图形的一角； 宽度 和 高度 是给出所需宽度的整数
和图形的 groff 单位的高度。

图形被缩放以使其具有此宽度和高度并进行平移以便
图形的左下角位于与 \X
命令。 如果省略高度参数，则在 x 和
y 方向，使其具有指定的宽度。

请注意，内容 \X 命令不被解释 的troff; 如此垂直
图形的空间不会自动添加，并且 宽度 和 高度
参数不允许附加缩放指标。

如果 PostScript 文件符合 Adob​​e 文档结构约定和
包含一个 %%边界框 注释，然后边界框可以自动
通过使用从 groff 中提取 公务员事务局 请求。

参见 格罗夫_tmac(5) 说明 PSPIC 宏提供了一个方便的
用于包含 PostScript 图形的高级界面。

\X'ps： 隐身'
\X'ps： 结尾的
不会为用这些括号括起来的文本和绘图命令生成输出
\X 命令。 这些命令旨在用于从 的troff is
在处理之前预览 摸索; 如果预览器无法显示
某些字符或其他结构，然后是其他替代字符或
结构可以通过用这些括起来来用于预览 \X 命令。

例如， 图形编辑视图 无法显示正确的 \（时间 性格因为
标准 X11 字体不提供； 这个问题可以通过执行
跟随请求

字符 \（时间 \X'ps： 隐形'\
\Z'\v'-.25m'\h'.05m'\D'l 9万 0'\h'.05m''\
\X'ps： endinvis'\(em

在这种情况下， 图形编辑视图 无法显示 \（时间 字符并画线，
而 摸索 打印 \（时间 字符并忽略该行（此代码已经
在文件中 电脑版 如果文档用于 摸索 预览
图形编辑视图).

如果 PostScript 程序 图书 已通过 ' 定义PS： DEF' 要么 'PS： 定义' 设备
命令，它在每一页的开头执行（在绘制任何内容或
格罗夫写的）。 例如，要在页面内容下方添加“草稿”一词
浅灰色，你可以用

。德 XX
PS： DEF
/BP钩子
{ gsave .9 设置灰色 剪辑路径 路径框 交易所 2 复制
.5 MUL 交易所 .5 MUL 翻译 晒黑 轮流 流行的 流行的
/NewCenturySchlbk-罗马 查找字体 200 比例字体 设置字体
（草案） DUP 字符串宽度 流行的 - 5 MUL -70 搬去 显示
商店 }
DEF
..
.devicem XX

或者，使用方形线帽和斜接线连接绘制线条和多边形
而不是通常使用的圆形线帽和线连接 摸索， 使用

。德 XX
PS： DEF
/BP钩子 { 2 设置线帽 0 设置线连接 } DEF
..
.devicem XX

（方形线帽，而不是对接线帽（0 setlinecap），在盒装中给出真正的角
表，即使绘制的线未连接）。

封装的 的PostScript
摸索 本身不发出边界框信息。 在 Ghostscript 的帮助下，
按照简单的脚本， 格罗夫2eps, 生成一个封装的 PS 文件。

#! / bin / sh的
groff的 -P-b16 $1 > $1.ps
gs -不暂停 -sDEVICE=bbox -- $1.ps 2> $1.b盒
口渴 -e "/^%%方向/r $1.bbox" \
-e "/^%!PS-Adobe-3.0/s/$/ EPSF-3.0/" $1.ps > $1.每股收益
rm $1.ps $1.b盒

说啊

格罗夫2eps FOO

转换文件 FOO 至 文件.

TrueType字体 和 other 字体 格式
TrueType 字体可用于 摸索 如果首先转换为 类型 42 格式，一个特殊的
PostScript 包装器等效于中提到的 PFA 格式 聚苯硫醚（1）。 有
生成 type42 包装器的几种不同方法，其中大多数涉及使用
PostScript 解释器，如 Ghostscript——见 gs（1）。

然而，最简单的方法是使用应用程序 ttftot42(1). 这个节目
使用 自由打字机(3)（1.3.1版）生成type42字体包装器和格式良好的AFM
可以提供给 修改(1) 创建适当的度量文件的脚本。 这
应将生成的字体包装器添加到 download 文件中。 ttftot42 源代码可以
下载自 ftp://www.giga.or.at/pub/nih/ttftot42/ ⟨ftp://www.giga.or.at/pub/nih/
ttftot42/⟩。

创建 type42 包装器的另一种解决方案是使用 FontForge，可从 http://
fontforge.sf.net ⟨http://fontforge.sf.net⟩. 这个字体编辑器可以转换大部分轮廓
字体格式。

字体 安装

本节对上述解释进行了总结； 它可以作为一步一步的
字体安装指南 摸索.

· 将您的字体转换为 groff 能够理解的字体。 这是 PostScript Type 1
PFA 格式的字体或 PostScript Type 42 字体，以及 AFM 文件。

PFA 文件中的第一个字符如下所示：

%!PS-AdobeFont-1.0:

PFB 文件的第一行也有这个，但字符串前面有一些
二进制字节。

Type 42 字体文件中的第一个字符如下所示：

%!PS-TrueTypeFont

这是 TrueType 字体的包装格式。 旧的 PS 打印机可能不支持它
（也就是说，他们没有内置的 TrueType 字体解释器）。

如果您的字体是 PFB 格式（此类字体通常以“.pfb”作为文件扩展名），
你可能会使用 groff 的 聚苯硫醚(1) 程序将其转换为 PFA。 对于 TrueType 字体，
尝试 ttftot42 or 字体锻造. 对于所有其他字体格式，请使用 字体锻造 哪个可以转换
大多数轮廓字体格式。

· 将 AFM 文件转换为 groff 字体描述文件 修改(1) 程序。
一个示例调用是

afmtodit Foo-Bar-Bold.afm 文本映射 FBB

它将公制文件“Foo-Bar-Bold.afm”转换为 groff 字体“FBB”。 如果你
有一个带有普通、粗体、斜体和粗斜体的字体系列，它是
推荐使用字母 R, B, I和 BI, 分别作为后缀
groff 字体名称使 groff 的 '.fam' 请求工作。 一个例子是 groff 的内置
Times-Roman 字体：字体系列名称是 T，并且 groff 字体名称是 TR, TB, TI,
和 TBI.

· 将 groff 字体描述文件和字体安装在“devps”子目录中
groff 找到的字体路径。 见 环境 部分 的troff(1) 男人
列出字体路径实际值的页面。 请注意， groff 不使用
AFM 文件（但无论如何存储它们是个好主意）。

· 在“devps/download”中注册必须下载到打印机的所有字体
文件。 仅读取字体路径中第一次出现的此文件。 这意味着
您应该将默认的“下载”文件复制到字体中的第一个目录
路径并在那里添加您的字体。 为了继续上面的例子，我们假设 PS
Foo-Bar-Bold.pfa 的字体名称是“XY-Foo-Bar-Bold”（PS 字体名称存储在
内部名称 'FBB' 文件中的字段），因此应将以下行添加到
'下载'。

XY-Foo-Bar-粗体 Foo-Bar-Bold.pfa

老 字体

groff 1.19.2 及更早版本包含一组略有不同的 35 Adob​​e 核心
字体； 不同之处主要是缺少“欧元”字形和减少的字距调整
对。 为了向后兼容，这些旧字体也安装在

/usr/share/groff/1.22.3/oldfont/devps

目录。

要使用它们，请确保 摸索 查找默认系统字体之前的字体（带有
相同的名称）：添加命令行选项 -F 至 摸索

groff的 -Tps -PF -P /usr/share/groff/1.22.3/oldfont ...

或者将目录添加到 groff 的字体路径环境变量中

GROFF_FONT_PATH=/usr/share/groff/1.22.3/oldfont

环境

GROPS_序言
如果这设置为 FOO， 然后 摸索 使用文件 FOO （在字体路径中）而不是
默认的序言文件 序幕. 选项 -P 覆盖此环境
变量。

GROFF_FONT_PATH
在其中搜索的目录列表 开发姓名 除了目录
默认的。 看 的troff（1）和 格罗夫字体(5) 了解更多详情。

SOURCE_DATE_EPOCH
用作创建的时间戳（表示为自 Unix 纪元以来的秒数）
时间戳代替当前时间。

使用 onworks.net 服务在线使用 grops