pdfroff - 云端在线

程序：

您的姓名

pdfroff - 使用 groff 创建 PDF 文档

概要

pdfroff [-abcegilpstzCEGNRSUVXZ[-d cs[-f FAM[-F DIR[-I DIR[-L ARG[-m 姓名]
[-M DIR[-n NUM[-o 名单[-P ARG[-r cn[-T 开发[-w 姓名[-W 姓名]
[--发射-ps[--no-toc-重定位[--no-kill-null-pages[--样式表=姓名]
[--no-pdf-输出[--pdf-输出=姓名[--无参考字典]
[--参考字典=姓名[--报告进展[--保持临时文件] 文件
...
pdfroff -h | - 帮帮我
pdfroff -v | - 版 [选项 ...]

商品描述

pdfroff 是 GNU 文本处理系统的包装程序， groff的. 它透明地
处理多次通过的机制 groff的 处理，当应用于适当标记
up groff的 源文件，以便格式化目录和正文文本
分开，然后按正确的顺序组合在一起，作为最终出版
单个 PDF 文档。 提供了进一步可选的“样式表”功能； 这允许
对于需要在目录之前的内容定义，在
发表的文件。

对于每次调用 pdfroff， 终极的 groff的 输出流由
GhostScript 解释器，生成完成的 PDF 文档。

pdfroff 不假设也不限制使用任何 groff的
用户可以选择使用的宏包，以实现所需的文档
格式; 然而，它 不 包括特定的内置支持 pdf标记 宏包，
如果用户选择使用它。 具体来说，如果 pdfhref 宏，定义在
pdfmark.tmac 包，用于定义公共引用标记或指向此类的动态链接
参考标记，然后 pdfroff 执行尽可能多的预格式化 groff的 按要求通过，向上
最大限制为 四，为了编译文档参考字典，
解析引用，并扩展链接的动态定义内容。

用法

命令行按照正常的 GNU 约定进行解析，但有一个
例外 — 当指定任何短格式选项时（即单字符选项
由单个连字符引入），如果该选项需要一个参数，那么它 必须 be
独立指定（即，它可以 而不去 被附加到任何一组其他单
字符短格式选项）。

长格式选项名称（即由双连字符引入的名称）可以缩写为
它们的最小长度明确的初始子串。

除此以外， pdfroff 用法与 groff的 本身。 确实，除了
的 -h, -v及 -T 开发 短格式选项和所有长格式选项，它们被解析
内部通过 pdfroff, 命令行上指定的所有选项和文件名参数
传递给 groff的, 控制 PDF 文档的格式。 最后，
pdfroff 接受所有选项和参数，如在 groff的(1) 也可以是
被视为所有标准的权威参考 pdfroff 选项和参数
用法。

配置

pdfroff 接受所有短格式选项（即，由单个连字符引入的选项），
哪些可用 groff的 本身。 在大多数情况下，这些只是通过
透明地 groff的; 但是，以下内容由专门处理 pdfroff.

-h 与...一样 - 帮帮我; 见下文。

-i 在所有其他指定的输入文件之后处理标准输入。 这是通过的
透明地 groff的，但是，如果与其他选项组合在一起，它 必须 成为第一个
群组。 将它隐藏在一个组中会破坏标准输入处理，在
多次通过 groff的 处理上下文 pdfroff.

-T 开发 只有 -T ps 得到支持 pdfroff. 试图指定任何其他设备原因
pdfroff 中止。

-v 与...一样 - 版; 见下文。

参见 groff的(1) 用于描述所有其他简短形式的选项，这些选项是透明的
通过传递 pdfroff 至 groff的.

所有长格式选项（即由双连字符引入的选项）都在本地解释
by pdfroff; 他们是 而不去 传递给 groff的，除非下文另有说明。

- 帮帮我 原因 pdfroff 显示其使用语法和支持选项的摘要，
然后退出。

--发射-ps
抑制最终的输出转换步骤，导致 pdfroff 发出 PostScript
输出而不是 PDF。 这对于捕获中间 PostScript 可能很有用
输出，当使用专门的后处理器时，例如 礼物 例如，在
默认位置 GhostScript的 PDF 作家。

--保持临时文件
禁止删除临时文件，这通常发生在 pdfroff 具有
完成PDF文档格式化； 这可能很有用，调试格式时
问题。

见章节 FILES, 用于描述所使用的临时文件 pdfroff.

--no-pdf-输出
可与 --参考字典=姓名 选项（如下所述）到
运行时消除 PDF 格式的开销 pdfroff 创造一个
参考词典，用于不同的文档。

--无参考字典
可用于消除创建参考字典的开销，当它
已知目标 PDF 文档不包含公共引用，由
pdfhref 宏。

--no-toc-重定位
可用于消除多余的 groff的 处理通行证，这是必需的
生成目录，并将其重定位到 PDF 文档的开头，
在处理任何缺少自动生成的表格的文档时
内容。

--no-kill-null-pages
在准备模拟手动整理步骤时，传统上
需要搬迁一个 表 of Contents 到文档的开头， pdfroff
将一些空页描述累积到中间 的PostScript
输出流。 在最后的整理步骤中，这些空页通常是
从完成的文件中丢弃； 此选项强制 pdfroff 把他们留在
的地方。

--pdf-输出=姓名
指定用于生成的 PDF 文档的名称； 如果未指定，则
PDF 输出被写入标准输出。 未来的版本 pdfroff 可以用这个
选项，在生成的参考字典中对文档名称进行编码。

--参考字典=姓名
指定用于生成的参考词典文件的名称； 如果
未指定，参考字典是在一个临时文件中创建的，它是
删除时 pdfroff 完成对当前文档的处理。 这个选项
必须 指定，如果需要保存参考字典，用于
放置在其他 PDF 文档中的参考文献。

--报告进展
原因 pdfroff 在开始时显示关于标准错误的信息性消息
每个 groff的 处理通行证。

--样式表=姓名
指定一个名称 输入 文件, 用作格式化的样式表
要放置的内容 before 目录，格式为 PDF
文档。

- 版
原因 pdfroff 以显示版本标识消息。 整个命令
行然后透明地传递给 groff的， 在一个 一种 通过操作 仅由，为了
显示相关的 groff的 版本信息，退出前。

环境

可以设置和导出以下环境变量以修改
pdfroff.

PDFROFF_COLLATE
指定用于整理已完成 PDF 文档的程序。

此整理步骤可能需要移动 表 of Contents 到开始
完成的 PDF 文档，当使用传统的宏包格式化时，打印
他们在最后。 但是，用户通常不需要指定
PDFROFF_COLLATE,（实际上，不鼓励这样做）。 如果未指定，
pdfroff 使用 口渴(1) 默认情况下，这通常就足够了。

If PDFROFF_COLLATE is 指定，那么它必须充当过滤器，接受一个列表
文件名参数，并将其输出写入 标准输出 流，从那里通过管道传输
以及 PDFROFF_POSTPROCESSOR_COMMAND, 生成完成的 PDF 输出。

指定时 PDFROFF_COLLATE，通常还需要指定
PDFROFF_KILL_NULL_PAGES.

PDFROFF_COLLATE 被忽略，如果 pdfroff 被调用 --no-kill-null-pages
选项。

PDFROFF_KILL_NULL_PAGES
指定要传递给 PDFROFF_COLLATE 程序。

通常不需要指定 PDFROFF_KILL_NULL_PAGES。 该
内部默认值是 口渴(1) 脚本，旨在去除完全空白
整理的输出流中的页面，哪些应该适用于大多数
的应用 pdfroff. 但是，如果有任何替代方案 口渴(1) 指定为
PDFROFF_COLLATE，那么很可能对应的替代规范
PDFROFF_KILL_NULL_PAGES 是必须的。

就像 PDFROFF_COLLATE, PDFROFF_KILL_NULL_PAGES 被忽略，如果 pdfroff
被调用 --no-kill-null-pages 选项。

PDFROFF_POSTPROCESSOR_COMMAND
指定用于从 PostScript 进行最终文档转换的命令
中间输出到 PDF。 它必须充当过滤器，将其输出写入
标准输出 流，并且必须接受任意数量的 档 ... 参数，与
特殊情况 - 代表 标准输入 流。

如果未指定， PDFROFF_POSTPROCESSOR_COMMAND 默认为

gs -dBATCH -d安静 -不暂停 -安全 -sDEVICE=pdfwrite -s输出文件=-

GROFF_TMPDIR
标识所在的目录 pdfroff 应该创建临时文件。 如果
GROFF_TMPDIR is 而不去 指定，那么变量 TMPDIR, TMP 和 TEMP 旨在
依次考虑，作为可能的临时文件存储库。 如果这些都不是
设置，然后在当前目录中创建临时文件。

GROFF_GHOSTSCRIPT_INTERPRETER
指定要调用的程序，当 pdfroff 转换 groff的 PostScript 输出
到 PDF。 如果 PDFROFF_POSTPROCESSOR_COMMAND 指定，然后命令命名它
指定是 隐含地 分配给 GROFF_GHOSTSCRIPT_INTERPRETER, 覆盖任何
环境中指定的显式设置。 如果 GROFF_GHOSTSCRIPT_INTERPRETER is
未指定，则 pdfroff 搜索过程 PATH, 寻找一个程序
GhostScript 解释器的任何众所周知的名称； 如果没有 GhostScript
可以找到口译员， pdfroff 中止。

GROFF_AWK_解释器
指定要调用的程序，当 pdfroff 正在提取参考
字典条目来自 groff的 中间消息流。 如果
GROFF_AWK_解释器 没有指定，那么 pdfroff 搜索过程 PATH,
寻找任何首选程序，“gawk”、“mawk”、“nawk”和“awk”，在
这个命令; 如果这些都没有找到， pdfroff 发出警告消息，以及
继续处理； 但是，在这种情况下，不会创建参考词典。

操作系统类型 通常由操作系统自动定义， 操作系统类型 用于
Microsoft Win32/MS-DOS 平台 仅由, 推断默认 路径分隔符
字符，在解析进程时使用 PATH 寻找外部
帮助程序。

路径分隔符
如果设置， 路径分隔符 覆盖默认的分隔符，(':' on
POSIX/UNIX 系统，推断自 操作系统类型 在 Microsoft Win32/MS-DOS 上），使用
解析过程时 PATH 搜索外部帮助程序。

显示进度
如果将其设置为非空值，则 pdfroff 总是表现得好像
--报告进展 在命令行上指定选项。

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