docbook-2-pdf - 云端在线

程序：

您的姓名

sgml2x — 使用 DSSSL 样式表轻松格式化 SGML/XML 文档

概要

sgml2x [选项[sgml 文件 | xml文件 ]

文档类- 2目标格式 [选项[sgml 文件 | xml文件 ]

产品描述

sgml2x 允许使用 DSSSL 样式表轻松格式化 SGML 或 XML 文档，以及
提供以下功能：

· 每个文档类有多个可能的样式表

· 使用别名轻松指定样式表，支持参数
继承权

· 通过在一个简单的新定义文件中添加一个新的样式表来轻松集成新的样式表
配置目录

· 调用者可以指定一个类似 PATH 的配置目录列表，默认为
系统范围、每个用户和每个项目的配置目录

· 自动选择要使用的默认样式表，基于指定的
优先级

· 将任意选项传递给 玉(1)

用于查找样式表和输出格式的文档类现在是
仅源自调用程序的名称，因此您需要调用它
通过符号链接编程 docbook-2-pdf.

sgml2x 是作为外壳包装器实现的 玉(1) （或者，最好， 开玉(1),
虽然我们使用通用名称 玉 在整个文档中）， 玉器(1) 和别的
工具。

如果没有 玉tex.cfg 文件附近的文件，默认一个被复制，这使
PDF书签的制作。

附加选项

-c|- 目录 检索目录
使用指定的 SGML 目录而不是系统默认值。

-C|--confdirs 目录列表
使用（空格分隔的）配置目录列表。 这个选项是
累积，即您可以使用多个 -C 选项和列表将是
串联。

列表元素应该从最通用的配置（例如系统范围）中排序
到最具体的（例如项目范围的）。

如果通过此选项提供任何目录，则默认目录列表将为
忽略了。

-D|--dssslproc dssl-处理器
使用 dssl-处理器 应用样式表，而不是默认的。 这个
处理器必须支持 玉- 类似的选项，例如 -V.

当这个选项不存在时，第一个在 dsslproc 来自 confdirs 的文件是
采取。 看 “文件” 以获得更多细节。

-h| - 帮帮我 显示帮助信息并退出。

-j|- 玉 dssl-处理器
过时的同义词 --dssslproc.

--jadetex过滤器 perl 过滤器
使用 perl 过滤器对 jadetex 输出进行后处理。

这对于在某些特定位置强制分页以克服样式表很有用
问题，或者在 TeX 没有足够模式的情况下强制连字符，或者做任何
你会想到的其他聪明的转变。

查看 示例/命令行 文件以供可能的用途。

-n|--不作为
打印命令而不是运行它们。 有助于了解低级
工具，以及用于调试命令行。

-o|--openjade
本篇 选项 is 过时的. 开玉 现在是可用时的默认值。 用
--dssslproc 或者 dsslproc 配置文件强制特定处理器。

这个选项曾经使用 开玉(1) 作为 DSSSL 处理器而不是 玉(1).

-O|--jadeopts 翡翠期权
传递给的附加选项 玉(1). 这个选项是累积的，你可以
指定其中的几个，提供的选项将被连接起来。

-q|- 安静的
将详细程度设置为 安静

-r|- 评论
在文档中渲染文档备注的内容（备注 元素
文档书 4, 评论 DocBook 3) 中的元素，使产生的输出成为
仅供内部使用 文件，在封面上印上粗体警告。

这是一个特定于文档类和样式表的特性，并不是所有的样式表都会使用
本。

-s|- 风格 样式
选择输出样式以覆盖（最终文档派生的）默认值。

当前可用于特定文档类和每种输出格式的样式是
依赖于配置目录的内容，并且可以用
- 帮帮我 选项。

请注意，在构建过程中指定此选项是一种很好的做法，以便您获得
无论可用的样式表如何，都可以获得可重现的结果。

-v|--详细
增加冗长。 可以多次指定此选项。

--冗长 N
将详细程度设置为 N. 详细级别定义如下：

安静 仅打印错误

默认 只打印错误和警告

详细 也打印通知

追踪 还可以在运行时打印重要的命令（如 --不作为 确实）。

调试 同时打印调试信息

-V|- 版
打印程序版本并退出。

配置

sgml2x 使用配置目录树而不是配置文件，因此它是
其他软件包易于插入，破坏现有设置的风险很低。

样式层次结构位于名为 风格 在每个配置中
目录。 该程序的旧版本过去常常将这些层次结构直接放在
配置目录。

一个配置目录为每个已知的文档类包含一个目录，命名为
文档类昵称（例如 文档书）。 这些 docclass 目录包含一个子
每类输出格式的目录（目前，仅 HTML 和 打印 支持）。

目前，实现问题强制限制文档类的昵称
和样式表：它们只能包含字母数字和下划线字符。 这个
限制可能会在未来的版本中删除，但在此之前不会发生
脚本被改写为另一种语言。

这些目录中的每一个都包含每个可用样式的一个文件。 这些文件的名称
可能只包含字母数字字符，并用作样式的昵称。 这个
文件包含带有 键： 折扣值 模式，当前有以下键
支持：

Id 样式表的公共标识符

说明 样式的简短描述，将显示在帮助消息中

pdf覆盖, ps覆盖,
rtf覆盖, 重载" 10 要设置的打印样式表中的 dsssl 符号
至 #t （或 符号=折扣值 对，适合作为参数 玉's -V 选项），
用于给定的打印格式。

每个覆盖行只允许一个符号。 要为多个符号定义值，请使用
几行。

继承 这个继承自的样式表的昵称，以避免不必要的
样式定义的重复。

目前，这只会导致继承 *覆盖 参数。

优先 一个正整数，用于在无法选择时帮助选择默认样式
从文档中导出。 较高的值有更高的机会被视为
默认。 注意对超专业风格使用低优先级
通用文档类型，以便它不会被错误使用。

例如，当前推荐的 DocBook 样式表策略来自
Norman Walsh 的情况如下（如果经验证明它不充分，可能会改变）。

10 基本样式表，通常必须定制。

0 任何为超专业目的而编写的样式表（例如
营销产品表）。

1000 组织生成的所有文档的默认样式。 通常一个
轻量定制，具有布局偏好，组织的
logo之类的。

10-100 基本样式表的杂项通用自定义。

当您编写具有优先级的样式表的改进版本时 n，你
通常要选择更高的优先级。

档

/etc/sgml/sgml2x/

〜/.sgml2x/

./sgml2x/ 默认配置目录，配置文件在
搜索。 请参阅文档 --confdirs 以获得更多细节。

配置文件/风格/
定义可用样式的层次结构。 看 “配置” 更多
细节。

配置文件/dssslproc
包含要查找的 dsssl 处理器的有序列表的文件，由
换行符和/或空格。 以 a 开头的行 # 字符被视为
注释。 常见值包括 开玉 和 玉.

此处指定的 DSSSL 处理器应接受 -V 和 -D 玉相容
命令行选项。

从最具体的开始寻找配置目录
一，这样，使用默认的 confdirs，项目设置可能会覆盖用户
设置，这反过来可能会覆盖系统设置。

特殊价值 false 可用于停止搜索并防止查看
更通用的目录。 例如，如果一个项目必须使用
openjade-1.4devel 命令而不是其他，它可以指定 openjade-1.4devel false
在其 dsslproc 文件中。

注意事项

使用时 openjade-1.4devel 作为 DSSSL 处理者，您会看到有关顶级的投诉
由生成的级别流对象 文档类型.dsl, 并自动确定文件-
类型将失败。 否则，此错误是无害的。 如何处理这个问题的想法，或
确认 openjade-1.4devel 太严格了，将不胜感激:)

未来

未来版本的计划功能包括：

· 集成索引生成器

· 为代码示例集成了一个漂亮的打印引擎

· 要链接的转换的规范

· 子集文档类的声明，以允许与样式的任何文档类一起使用-
适用于其超集文档类的工作表。

· 在临时位置工作，以免污染工作目录
临时文件。 这并不像听起来那么容易，因为它破坏了一个文档
指使用相对路径的图像文件。 那可以看成是玉虫，
然而。

浏览完整的待办事项列表并向我们发送更多想法！

版权

版权所有 © 2001-2003 Alcove & Yann Dirson。

sgml2x 根据 GNU 通用公共许可证第 2 版获得许可。

本文档根据 GNU 自由文档许可证，版本 1 获得许可。

联系我们 us

sgml2x 是的一部分 壁龛书 项目 （链接 至 网址 http://www.alcove-
labs.org/en/software/alcovebook/) 。 请使用 壁龛书 邮件 名单 （链接 至 网址
https://savannah.gnu.org/mail/?group_id=533) 与开发人员和用户取得联系。

错误和功能请求列表可用 通过 a 网路 接口 （链接 至 网址
https://savannah.gnu.org/support/?group_id=533) . 请用它来提交问题和
想法。

我们 还

开玉(1), 玉(1), 玉器(1), 整理索引.pl(1).

sgml2x(1)

使用 onworks.net 服务在线使用 docbook-2-pdf