为 HTML 帮助发布文档 (仅限 Windows)
可使用 Arbortext Editor 将 XML 文档变换为 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 输出中设置这些属性)。Web 浏览器无法解释用像素以外的其他单位指定的图形宽度和深度属性。
在 HTML 输出中，带有 TeX 输入的方程将显示为空白框。
|
要针对 HTML 帮助发布文档：
1. 要用 CJK 语言发布 HTML 帮助，首先必须将 Windows 区域设置和默认语言设置设置为所需的语言。有关更改区域设置和语言的信息，请参考 Windows 操作系统文档。
2. 选取 > > 。针对 HTML 帮助发布对话框随即打开。
3. 在另存为字段中，指定要保存的 HTML 帮助文件的路径及文件名。单击浏览以查找现有文件。
4. 如果希望在文档发布后通过“HTML 帮助查看器”显示此文档，请选择查看帮助文件选项。
|
|
如果选择查看帮助文件选项且您的文档文件名称中含有“和”符号 (& 符号)，Arbortext Editor 将做出其不能启动“HTML 帮助查看器”的响应。请选择是以在查看器已禁用的情况下进行发布，或选择否以取消发布过程。
|
5. 在样式表列表中选择相应的样式表。支持 Web 发布的样式表同样适用于 HTML 帮助。单击浏览以查找未在列表中显示的现有样式表。
如果您使用 Arbortext Publishing Engine 来发布文档，则列表会显示 Arbortext Publishing Engine 服务器中可用的样式表。样式表名称中将显示符号 (pe)。本地样式表会被忽略，您不能将其连同文档一起发送到服务器。
7. 如果文档具有变更跟踪，则可以在任意变更跟踪状态下发布文档。默认情况下，会选择“编辑”窗口中的变更跟踪视图，除非从 DITA 映射进行发布。
如果从 DITA 映射发布，则默认情况下，选择已应用变更。从 DITA 映射发布时，选择的变更跟踪视图仅应用于从 DITA 映射引用的主题。DITA 映射本身以及其他引用的映射始终使用已应用变更进行发布，而与选择的变更跟踪视图无关 (即使映射有变更跟踪标注)。
选项如下：
◦ 突出显示的变更 - 显示所有建议的变更，这些变更以修订标记突出显示。
◦ 已应用变更 - 显示所有建议的已合并到文档中的变更，这些变更不带修订标记。
◦ 原始 - 显示原始文档，而不将建议的变更合并到文档中。
8. 如果选取排队事务，则从已排队的事务 (可从工具菜单获得) 列表中检索结果时，将提示您输入另存为文件名，并询问您是否查看帮助文件。在此对话框中选取排队事务将清除另存为和查看帮助文件值。如果您在这些字段中输入了值，则清除排队事务复选框后，它们会再次显示。
排队事务行为由一组 Arbortext Publishing Engine控制。
9. 选取是否输入事务名称。从工具菜单中的已排队的事务列表中检索结果时，会显示事务名称。
您可以输入在默认情况下使用的事务名称，也可以通过在已排队的事务名称对话框中输入值来为特定的输出类型输入事务名称。
11. 如果要创建发布规则，单击创建规则打开创建新发布规则，可在其中创建用于发布 HTML 帮助的新发布规则或规则集。
12. 在针对 HTML 帮助发布对话框中单击确定。
发布到 HTML 帮助时要注意以下事项：
• 如果您使用 Arbortext Publishing Engine 来发布文档，则必须在 Arbortext Publishing Engine 服务器上安装 HTML Help Workshop。如果返回发布的 HTML 帮助文件时，复选了查看帮助文件，则 Arbortext Editor 会将其显示在本地“HTML 帮助查看器”中。
• 由于某些字符实体的显示不正确，因此 Arbortext Editor 在发布过程中将其替换。在 Arbortext-path\composer\htmlHelpNavEntSub.xml 中对替换字符实体进行了定义。此文件仅控制针对 HTML 帮助导航窗格的实体替代；其并不支持针对 HTML 帮助内容窗格的实体替代。
• Microsoft HTML 帮助编译器 (hhc.exe) 无法在路径含有以句点开头的文件夹名称的目录中创建 .chm 文件。如果 APTCACHE 环境变量指定含有此类文件夹的目录，则在试图创建 .chm 文件时，“帮助编译器”将失败。解决方法是使用 APTCACHE 环境变量指定不包含以句点开头的文件夹名称的目录。
有时，HTML Help Workshop 在当前版本的 Microsoft Windows 中进行配置时会遇到一些问题。HTML Help Workshop 安装完成后，Arbortext Styler 中应该会显示菜单选项 > > 。如果禁用该选项，则表示 Arbortext Styler 不能识别用于 HTML 帮助文件的程序。
要修复此问题，可强制将 *.hhp 文件与 HTML Help Workshop 关联起来：
1. 创建一个名为 "dummy.hhp" 的空文件。
2. 在 Windows 资源管理器中，双击该文件。您会收到来自 Windows 的关于希望使用哪个程序来打开该文件的提示。选择 More programs 选项，然后导航至 C:\Program Files (x86)\HTML Help Workshop，然后选择 hhw.exe。请确保 Always use this program 选项处于选定状态。
3. 如果 Arbortext Styler 处于打开状态，则将其关闭并重新打开。“HTML 帮助发布”选项目前可供使用。