帮助 > 打印和发布 > 为 PTC ALD 发布排除故障
  
PTC ALD 发布排除故障
创建 PTC ALD 快照
使用 PTC ALD 打印或发布 PDF 时,您可能需要排除发布过程的故障。此排除故障过程需要 PTC ALD 快照压缩文件。您需要使用以下其中一项创建 PTC ALD 快照文件:
set appsnapshot ACL 命令。
f=convert 发布请求发送到 Arbortext PE 服务器 时的 app-snapshot=yes 文档转换参数。此请求会将快照文件放置在事务存档中。有关事务存档的详细信息,请参考 Configuration Guide for Arbortext Publishing Engine
PTC ALD 快照压缩包含以下各项:
manifest.xml - 包含快照文件内容相关信息的 XML 文档。
inputDoc.xml - 进行了一些修改且发送到 PTC ALD 的文档。将对其进行展平,且其图形引用将指向 doc-graphics 目录。
doc-graphics - 包含 inputDoc.xml 所引用的图形副本的目录。
appsnap.log - 生成 PTC ALD 快照的事件日志。如果快照不完整,appsnap.log 将包含附加信息。
dynamic.dtddynamic.xsd - (可选) 可能需要 XML 文档类型定义 (DTD) 文件或 XML 方案 (XSD) 文件才能读取 inputDoc.xml。快照可以包含这些文件之一 (如读取 inputDoc.xml 需要)。例如,DITA 文档使用动态 DTD。
PTC ALD 快照不包含文档类型、样式表、PTC ALD 配置文件、以及 applicationcustom 目录的内容。您可使用工具 > 保存应用程序生成包含上述各项的压缩文件。
执行快照工具
生成 PTC ALD 快照压缩文件后,将使用执行 ALD 快照工具对 PTC ALD 快照文件运行发布过程。您可以使用 hints.xml 文件来覆盖在发布文档过程中 PTC ALD 所使用的部分参数。PTC ALD 快照文件不包含 hints.xml 文件。您可以在执行 ALD 快照对话框中提供文件的路径,或在执行排除故障之前直接将一个文件插入到快照存档中。解压快照压缩文件,将 hints.xml 文件复制到解压的目录中,然后再次压缩此目录。
要提供 hints.xml 文件,必须先创建一个。它是一种 XML 文档,提供要覆盖在创建快照时生效的某些发布参数的参数。此文件使用以下格式:
<app:AppSnapshotHints xmlns:app="http://arbortext.ptc.com/AppSnapshot">
<Hint name="parameter-name" value="parameter-value"/>
<Hint name="parameter-name" value="parameter-value"/>
<Hint name="parameter-name" value="parameter-value" />
</app:AppSnapshotHints>
支持的提示名称和值如下所示:
提示名称
cropmarks
指定 1 可显示裁剪标记。指定 0 可禁止显示这些标记。
datemark
指定 1 可显示日期标记。指定 0 可禁止显示这些标记。
printRange
指定要打印或发布到 PDF 的页面。您可指定页码、页面范围或二者的组合,例如 3-5,9,21-33
regmarks
指定 1 可显示注册标记。指定 0 可禁止显示这些标记。
APPChecksumPath
指定 1 可生成校验和文件。指定 0 可禁止生成校验和文件。文件置于与从快照生成 PDF 相同的目录中。
APPSavePath
指定 1 来保存在发布过程中生成的 PTC ALD 模板文件。指定 0 可禁止显示这些标记。文件置于与从快照生成 PDF 相同的目录中。
editstylesheet
指定要在发布前打开输入文档时使用的样式表的绝对路径。
stylesheet
指定要在发布过程中传递到 PTC ALD 的样式表的绝对路径。
APPConfigFile
指定要在发布过程中传递到 PTC ALDPTC ALD 配置文件的绝对路径。
在快照执行期间追踪活动
如果您在运行快照工具时出现问题,可使用诊断程序。从您的项目组快捷方式中启动 PTC Arbortext 诊断。然后将 ACL 全局变量 appsnapx::debug 设置为 2。发布命令行上或 custom\init 的脚本中的命令 set debug==extwin。然后再次执行快照工具并检查诊断窗口。有关诊断窗口的详细信息,请参阅 Configuration Guide for Arbortext Publishing Engine PDF 中的获得追踪信息
建议在“技术支持”的指导下使用快照为 PTC ALD 发布进行故障排除。