为 HTML 帮助发布文档 (仅限 Windows)

先决条件：Arbortext Publishing Engine、Arbortext Styler 或 Web/Wireless Composer 选项和 HTML Help Workshop

可使用 Arbortext Editor 将 XML 文档变换为 HTML 帮助。文件 > 发布 > 用于 HTML 帮助选项将文档分为单独的 HTML 主题，然后将这些主题合并为一个 .chm 文件。默认情况下，Arbortext Editor 配置为基于 Arbortext XML DocBook (axdocbook.dtd) 文档类型的文档创建 HTML 帮助文件。要基于其他 DTD 将文档发布为 HTML 帮助，可联系咨询服务。

用于 HTML 帮助选项将显示在发布菜单上，但只有在安装 Microsoft 的 HTML Help Workshop 后才能使用。可从 Microsoft 的网站 http://www.microsoft.com 下载最新版本。由于此下载版本可能未与标准下载选项一同列出，因此可在 MSDN 库中搜索，且确保安装完整的 Workshop 而不是仅安装“查看器”。

您必须启动，然后关闭一次 HTML Help Workshop，才能选取文件 > 发布 > 用于 HTML 帮助。

如果文档中含有图形，则必须以像素为单位指定图形宽度和深度属性（如果希望在 HTML 输出中设置这些属性）。Web 浏览器无法解释用像素以外的其他单位指定的图形宽度和深度属性。

在 HTML 输出中，带有 TeX 输入的方程将显示为空白框。

要针对 HTML 帮助发布文档：

1. 要用 CJK 语言发布 HTML 帮助，首先必须将 Windows 区域设置和默认语言设置设置为所需的语言。有关更改区域设置和语言的信息，请参考 Windows 操作系统文档。

2. 选取文件 > 发布 > 用于 HTML 帮助。针对 HTML 帮助发布对话框随即打开。

3. 在另存为字段中，指定要保存的 HTML 帮助文件的路径及文件名。单击浏览以查找现有文件。

4. 如果希望在文档发布后通过“HTML 帮助查看器”显示此文档，请选择查看帮助文件选项。

如果选择查看帮助文件选项且您的文档文件名称中含有“和”符号 (& 符号)，Arbortext Editor 将做出其不能启动“HTML 帮助查看器”的响应。请选择是以在查看器已禁用的情况下进行发布，或选择否以取消发布过程。

5. 在样式表列表中选择相应的样式表。支持 Web 发布的样式表同样适用于 HTML 帮助。单击浏览以查找未在列表中显示的现有样式表。

如果您使用 Arbortext Publishing Engine 发布文档，则列表会显示 Arbortext Publishing Engine 服务器中可用的样式表。样式表名称中将显示符号 (pe)。本地样式表会被忽略，您不能将其连同文档一起发送到服务器。

6. 如果发布了具有关联 DITAVAL 文件的 DITA 文档，则在 DITAVAL 文件列表中选择该文件。单击浏览可查找未在列表中显示的现有 DITAVAL 文件。

7. 如果文档具有更改跟踪，可在任意更改跟踪状态下发布文档。默认情况下，会选择“编辑”窗口中的更改跟踪视图，除非从 DITA 映射进行发布。

如果从 DITA 映射发布，默认情况下，选择已应用更改。从 DITA 映射发布时，选择的更改跟踪视图仅应用于从 DITA 映射引用的主题。DITA 映射本身以及其他引用的映射始终使用已应用更改进行发布，而与选择的更改跟踪视图无关 (即使映射有更改跟踪标注)。

◦ 突出显示的更改 - 显示所有建议的更改，这些更改以修订标记突出显示。

◦ 已应用更改 — 显示所有建议的已合并到文档中的更改，这些更改不带修订标记。

8. 如果选取排队事务，则从已排队的事务 (可从工具菜单获得) 列表中检索结果时，将提示您输入另存为文件名，并询问您是否查看帮助文件。在此对话框中选取排队事务将清除另存为和查看帮助文件值。如果您在这些字段中输入了值，则清除排队事务复选框后，它们会再次显示。

9. 选取是否输入事务名称。事务名称将会在从工具菜单中的已排队的事务列表中检索结果时显示出来。

您可以输入在默认情况下使用的事务名称，也可以通过在已排队的事务名称对话框中输入值来为特定的输出类型输入事务名称。

10. 如果要对文档应用配置，请单击设置配置文件以访问设置配置文件对话框。单击确定或取消，退出设置配置文件对话框。仅当已为选定文档类型配置了配置文件时，设置配置文件按钮才会可用。

11. 如果要创建发布规则，单击创建规则打开创建新发布规则，可在其中创建用于发布 HTML 帮助的新发布规则或规则集。

发布到 HTML 帮助时要注意以下事项：

• 如果您使用 Arbortext Publishing Engine 发布文档，则必须在 Arbortext Publishing Engine 服务器上安装 HTML Help Workshop。如果返回发布的 HTML 帮助文件时，复选了查看帮助文件，则 Arbortext Editor 会将其显示在本地“HTML 帮助查看器”中。

• 由于某些字符实体的显示不正确，因此 Arbortext Editor 在发布过程中将其替换。在 Arbortext-path\composer\htmlHelpNavEntSub.xml 中对替换字符实体进行了定义。此文件仅控制针对 HTML 帮助导航窗格的实体替代；其并不支持针对 HTML 帮助内容窗格的实体替代。

• Arbortext Styler 支持三种不同的方法来将 CSS 信息包括在 HTML 输出中。有关详细信息，请参考 CSS files in HTML outp。

• Microsoft HTML 帮助编译器 (hhc.exe) 无法在路径含有以句点开头的文件夹名称的目录中创建 .chm 文件。如果 APTCACHE 环境变量指定含有此类文件夹的目录，则在试图创建 .chm 文件时，“帮助编译器”将失败。解决方法是使用 APTCACHE 环境变量指定不包含以句点开头的文件夹名称的目录。