• Adobe RoboHelp 教程

Adobe RoboHelp 快速指南



Adobe RoboHelp - 概述

Adobe RoboHelp 是 Adobe 推出的一款流行的帮助创作工具 (HAT)。行业专业人士使用它向广大受众提供引人入胜的帮助内容、电子学习资源、组织政策知识库文章,无论设备的形状尺寸如何。最新版本的 RoboHelp(2017 版本)帮助您轻松创建新一代响应式 HTML5 布局,从而实现无缝导航和丰富的交互性。

RoboHelp 最初由Gen Kiyooka创建,并于1992年由Blue Sky Software发布。Blue Sky Software 被Macromedia收购,后者随后于2005年被Adobe收购。Adobe RoboHelp 2017 的版本号为 13.0,尽管从技术上讲,考虑到 Macromedia 发布的先前版本,它是 21 版。

RoboHelp 已从一个简单的 HAT 发展成为一个多功能工具,它可以帮助您创建电子书甚至网站。RoboHelp 可以使用以下单一来源布局 (SSL) 输出到各种帮助格式:

  • 响应式 HTML5
  • 电子书
  • Microsoft HTML 帮助
  • JavaHelp
  • Oracle 帮助
  • Eclipse 帮助
  • Adobe AIR 帮助
  • 标准 Word 和 PDF 文档

内容交付面临的最大挑战之一是确保目标受众能够查看内容。RoboHelp 允许内容创建者创建适用于 Android 和 iOS 的原生应用程序,无需任何额外软件。

凭借最新版本中众多新功能,Adobe RoboHelp 仍然是创建引人入胜的帮助、电子学习和技术内容的行业标准 HAT,它以动态的方式满足目标受众的不同需求。它易于使用——经验丰富的作者和新手都能轻松上手。

Adobe RoboHelp - 新功能

RoboHelp 2017 版本包含许多新功能。这些包括:

  • 新一代 HTML5 布局
  • 自动完成
  • 缩略图支持
  • 响应式 HTML5 布局中的收藏夹
  • 行李文件文件夹导入
  • 变量视图

让我们详细了解它们。

新一代 HTML5 布局

RoboHelp 2017 版本承诺帮助您创建视觉上引人入胜的无边框 HTML5 布局。这些布局提供卓越的搜索和导航体验,并预装了许多功能,例如主题滑块、显示/隐藏小部件等。响应式设计使内容能够很好地缩放以适应不同尺寸的屏幕。

自动完成

现在,在输入前几个字符后,您可以在响应式 HTML5 输出的搜索字段中获得预测性搜索结果。结果会立即出现,并且具有上下文相关性,用户无需输入完整的搜索字符串。结果根据关键字在内容中的频率进行排名。

缩略图支持

您现在可以发布图像的缩略图,这可以减少页面加载时间,节省带宽,同时也能适应移动设备。如果需要,用户只需单击缩略图即可加载更大的图像。可以维护标准的缩略图大小,以保持内容的一致性。

响应式 HTML5 布局中的收藏夹

现在可以使用新的 Indigo 主题响应式 HTML5 布局将主题标记为收藏夹并添加自定义链接。

行李文件文件夹导入

您现在可以通过将文件夹添加到项目中,只需单击一下即可添加存储在文件夹中的多个行李文件,从而轻松导入包含支持信息的文件夹。

变量视图

您现在可以通过键盘快捷键或上下文菜单轻松在变量名称及其值之间切换。您可以切换单个变量或所有变量,以准确查看您的受众将看到的内容。

Adobe RoboHelp - 服务器

Adobe RoboHelp Server 是一种基于服务器的帮助解决方案。您可以将帮助内容上传到服务器,然后服务器可以提供实时最终用户反馈。它可以记录用户提出的查询数据。RoboHelp Server 可以以图形方式显示用户如何在帮助系统中导航。

Server

您可以使用创作工具创作内容,其中可以包含多个项目,并将整个项目上传到 RoboHelp Server。RoboHelp Server 包括自动项目合并,允许作者在不同的时间表上处理不同的项目,并将所有项目发布到同一服务器。作者还可以将不同语言编写的项目发布到同一服务器。

RoboHelp Server 还可以与 Oracle 或 MS SQL Server 等数据库服务器接口,并生成报表和日志。对用户查询的响应通过 Apache HTTP Server 传回。

Adobe RoboHelp - 工作区概述

典型的 RoboHelp 工作区包含称为窗格、面板、栏窗口的元素。让我们来看一下工作区的一些组件。

Workspace

快速访问工具栏

快速访问工具栏提供对常用命令的访问。可以自定义它以访问您最常访问的命令。

默认命令包括:全部保存、复制、粘贴、撤消和重做。

Toolbar

选项卡

选项卡是组合在一起的命令的逻辑组。一个选项卡包含相关功能的命令。选项卡具有上下文相关性,并根据内容和格式的类型而变化。

Tabs

文档面板

文档面板通常包含三行选项卡,如下面的屏幕截图所示。

Document Pane

下面解释这些选项卡。

  • 第一行是选项卡式文档面板。每个选项卡包含一个项目。您可以同时处理多个项目,并在这些项目之间复制粘贴资源。

  • 第二行是设计和HTML视图面板。对于任何给定的文档,您可以在正在处理的设计和设计HTML代码之间切换。您可以编辑HTML以获得更精细的控制。HTML代码会在您继续处理设计时自动生成。

  • 第三行显示文档区域选择器。这些帮助您跳转到文档的各个部分,例如段落、标题和超链接。

窗格

窗格是可以停靠在工作区任何位置的面板,以便访问所有以逻辑方式分组的功能。例如,“项目管理器”窗格显示项目的所有组件。窗格可以组合在一起,也可以在工作区中自由浮动。

您还可以使它们自动隐藏或将它们移动到不同的显示器。

Pods

Adobe RoboHelp - 使用选项卡

RoboHelp 通过将命令组织到选项卡中,使查找和识别与特定功能关联的命令变得容易。选项卡以类似于 Microsoft Office 程序套件的类似功能区的方式组织。

功能区包含几个选项卡,包括:

  • 文件
  • 项目
  • 编辑
  • 插入
  • 审阅
  • 协作
  • 输出
  • 工具

让我们详细了解这些内容。

文件

创建新项目、打开、保存现有项目、查看最近的项目和更改程序设置。

File

项目

创建、导入、编辑和删除项目组件,例如主题、代码片段、标签和变量。您可以保存项目中当前未保存的更改。

Project

编辑

创建和编辑样式表、文本格式和内容标记。

Edit

插入

插入对象,例如表格、图像、Adobe Captivate 内容和代码片段。

Insert

审阅

跟踪更改,接受和拒绝文档审阅中的更改。

Review

协作

在用户之间共享项目资源并启用版本控制。

Collaborate

输出

创建、搜索、设置、生成、查看和打开 RoboHelp 输出。

Output

工具

您可以创建和查看报表。RoboHelp 附带许多脚本,您可以使用这些脚本执行某些命令。从此选项卡中的“脚本”列表中选择并执行脚本。

Tools

Adobe RoboHelp - 使用窗格

窗格是工作流程或相关功能的浮动或停靠窗口,以逻辑方式组织。要打开窗格,请转到“项目”选项卡,然后在“打开”部分中,单击“窗格”图标以显示窗格列表。从列表中选择一个窗格。您可以停靠窗格,也可以让它在桌面上浮动。您还可以自动隐藏窗格或将其打开为选项卡式文档。

RoboHelp 包含许多类型的窗格。其中一些包括:

  • 启动窗格
  • 项目管理器窗格
  • 输出设置窗格

让我们详细讨论这些内容。

启动窗格

启动窗格通常显示为选项卡式文档,但与任何其他窗格一样,您可以使其浮动甚至停靠它。它通常是 RoboHelp 工作流程的起点。

Started Pod

启动窗格包含四个部分,分别是:

  • 最近的项目- 显示最近打开的项目列表。

  • 创建- 允许您选择要创建的帮助文件的类型。

  • 导入 − 从 Microsoft Word、Adobe FrameMaker、Adobe PDF 文件、HTML 或其他支持的格式导入内容。

  • 资源 − 包含帮助资源、研讨会和知识库文章的链接,帮助您充分利用 RoboHelp。

项目管理器窗格

项目管理器面板包含用于存储和编辑项目文件的所有不同文件夹。项目管理器面板为每种内容类型都有默认文件夹。

例如,项目中的所有图像都存储在“图像”文件夹下,视频和声音存储在“多媒体”文件夹下,等等。

Project Manager Pod

项目管理器面板还包含附属文件文件夹,其中包含作为项目一部分的间接链接的文件。附属文件可能包括 – PDF 文件、PowerPoint 演示文稿等。双击附属文件文件夹中的文件会在其关联的应用程序中打开该文件。

输出设置窗格

输出设置面板可帮助您根据目标设备查看和修改内容的输出。它包含不同输出组件的分层组织,例如窗口、母版页、皮肤、设备配置文件、屏幕布局等。

Output Setup Pod

右键单击任何容器以更改其属性。

例如 – 如果要更改MS_HTML输出窗口的尺寸,请右键单击“窗口”文件夹中的 MS_HTML 容器,然后选择希望窗口在屏幕上显示的方式。

Adobe RoboHelp - 环境

工作区元素(如窗口、面板和其他元素)的排列称为环境。环境可以根据用户的需要进行自定义。可以保存特定窗口和面板的排列作为环境。

然后,可以通过从窗口右上角的工作区菜单中选择环境来调用环境。环境保存在“.rhs 文件”中,可以与其他作者交换。

创建和保存环境

排列工作区中的所有面板。单击 RoboHelp 窗口右上角“工作区”旁边的下拉箭头。单击保存...并选择工作区的位置和名称。

General

加载已保存的环境

单击 RoboHelp 窗口右上角“工作区”旁边的下拉箭头,然后选择加载…

浏览到.rhs文件的文件位置,然后单击“打开”以加载环境。

删除环境

要删除环境,请导航到磁盘上存储 .rhs 文件的位置,然后只需删除与该环境相关的 .rhs 文件。

Adobe RoboHelp - 键盘快捷键

键盘快捷键有助于快速完成任务,RoboHelp 具有许多键盘快捷键,可帮助您更快地完成工作。您还可以自定义自己的键盘快捷键。

创建键盘快捷键

以下几点将解释如何在 RoboHelp 中创建键盘快捷键。

  • 快速访问工具栏旁边的下拉菜单中,选择更多命令选项。

  • 常规部分的用户界面选项下,单击自定义键盘快捷键

  • 类别下拉列表中选择一个选项卡类别,然后选择要为其分配键盘快捷键的命令。

  • 按新的快捷键框中,输入键盘快捷键或组合,然后单击分配。如果已分配键盘快捷键,则它将显示在按键分配:框中。

  • 完成所有键盘快捷键的分配后,单击关闭以关闭对话框。

  • 您还可以通过选择导出将键盘快捷键列表导出为CSV 文件

Keyboard Shortcuts

删除键盘快捷键

以下几点将解释如何在 RoboHelp 中删除键盘快捷键。

  • 要删除已分配的快捷键,请导航到自定义键盘快捷键…对话框,然后单击要删除其键盘快捷键的命令。

  • 然后单击删除以删除分配给该命令的键盘快捷键。

  • 要将键盘快捷键恢复为默认设置,请选择全部重置

Adobe RoboHelp - 常规设置

要配置常规程序选项,请转到文件选项卡,然后转到选项,并选择“常规”部分以更改设置。

以下屏幕截图概述了一些重要的设置:

General Settings

常规设置的首选项

以下是 RoboHelp 中常规设置的首选项。

  • 在文件名中使用下划线 − 主题文件名使用单词之间的下划线保存,这是 HTML 项目所需的。

  • 自动检查更新 − 退出时检查更新。您也可以通过选择文件→帮助→帐户和更新→更新…来启用此选项。

  • 允许编辑多个主题 − 在设计编辑器中不同的选项卡中打开主题并允许编辑。

  • 在打开任何项目之前清除项目缓存(.cpd 文件) − 这有助于每次打开项目时都删除旧的<ProjectName>.cpd 文件,并从项目文件创建一个新的<ProjectName>.cpd 文件。

  • 记住项目状态 − 确保 RoboHelp 记住已打开文件和面板的位置,以便下次打开程序时项目将以相同的状态打开。

命令生成

以下是 RoboHelp 中的命令列表。

  • 自动编译过时的文件 − 当输出文件过期时,自动生成您的主要布局。

  • 自动显示输出视图 − 在项目生成时,在程序窗口底部显示输出视图。

  • 将 RoboHelp 编辑的主题转换为 HTML − 将 XHTML 主题转换为输出中的 HTML。使用第三方编辑器创建或编辑的主题不会转换。

  • 在启动页面上显示学习资源 − 显示或隐藏启动页面上包含学习资源流的区域。

Adobe RoboHelp - 项目概述

项目是成为最终用户看到的帮助系统的一组源文件。项目文件以.xpj 格式存储,并包含项目的信息和属性。

项目文件包含以下组件:

  • 内容
  • 属性
  • 导航

让我们详细讨论这些内容。

内容

项目内容包括主题和有关主题、图像、索引、TOC 等位置的信息。

属性

在新项目中,使用默认属性。这些属性包括标题、语言、窗口等设置,可以根据需要进行修改。

导航

项目包括 TOC、索引和全文搜索,使用户能够导航内容。

项目文件

RoboHelp 项目包含以下文件:

  • 主项目文件 (XPJ)
  • 文件夹文件 (FPJ)
  • 单一来源布局文件 (SSL)
  • 辅助项目文件 (APJ) 和
  • 其他类型的文件

让我们详细讨论一下这些文件。

主项目文件 (XPJ)

项目文件 (.xpj) 基于 XML。旧的 .mpj 文件会在最新版本的 RoboHelp 中转换为 XPJ 文件。

文件夹文件 (FPJ)

FPJ 文件列出文件夹内容。只有在文件夹的 FPJ 文件中列出的子文件夹和主题才会显示。

单一来源布局文件 (SSL)

存储单一来源布局的属性,并在您编辑属性时进行修改。

辅助项目文件 (APJ)

窗口、附属文件、地图文件、字体集等组件具有相应的 APJ 文件,这些文件会被修改或编辑。

其他类型的文件

项目中的其他类型的文件包括:

  • 浏览序列 (BRS)
  • 主题 (HTM)
  • TOC (HHC)
  • 索引 (HHK)
  • 词汇表 (GLO)
  • 图像和多媒体文件(文件名扩展名不同)
  • 样式表 (CSS)

创建和管理项目

您可以从头开始创建项目,也可以从外部文件(例如 FrameMaker、Word 或 PDF)导入数据来创建项目。

创建新项目

以下几点描述了如何在 RoboHelp 中创建新项目。

  • 可以通过选择文件→新建项目或使用“新建”下“入门”面板中的“更多”选项来创建一个新项目。

  • 在新项目对话框中,双击项目类型。您可以在创建项目后更改项目类型。

New
  • 新建项目向导对话框中,指定项目标题、文件名、磁盘位置和第一个主题的标题等选项,然后单击完成以创建项目。

New Project

通过导入文档创建项目

以下步骤说明了如何在 RoboHelp 中通过导入文档来创建项目。

  • 您可以通过从外部来源(例如 FrameMaker 或 Word 文档)导入内容来创建新项目。

  • 转到新建项目对话框文件→新建项目,或使用“新建”下“入门”面板中的“更多”选项。选择“导入”选项卡。

  • 选择您需要导入的文档类型,然后单击“确定”。

  • 新建项目向导对话框中,指定项目标题、文件名、磁盘位置和第一个主题的标题等选项,然后单击“完成”以创建项目。

Import Document

Adobe RoboHelp - 打开项目

您可以在启动 RoboHelp 时使用入门面板或通过传统方式使用文件菜单来打开项目。

从入门面板打开项目

入门面板显示最近打开的项目列表。单击要打开的项目名称。如果您没有看到所需的项目,请单击“打开项目”,然后导航到磁盘上项目的存放位置。

Opening Project Starter Pod

从文件菜单打开项目

单击“文件”选项卡,然后选择“打开项目”。单击本地或网络路径,然后从磁盘中选择一个项目。

如果您正在打开在旧版 RoboHelp 中创建的项目,系统将要求您将项目转换为新格式。

Opening Project File Menu

配置项目设置

要更改项目的设置,请在“项目”选项卡中,单击“文件”部分中的“项目设置”。

Project Settings

您可以更改项目标题、主要输出和本地化等设置。您还可以通过单击管理…按钮并添加所需的待办事项来管理待办事项列表。

索引部分,您可以选择将新关键字添加到项目索引文件 (HHK) 或另存为单个主题文件 (HTM)。如果您想合并多个 CHM 文件的索引,请选择二进制索引选项。

定义章节布局

您可以在项目管理器面板中以逻辑方式对主题和文件夹进行排序,以定义章节布局。此章节布局构成了 RoboHelp 创建目录的基础。

这里需要注意一些重要事项:

  • 如果重命名文件夹或主题,则主题和文件夹会保留其顺序。

  • 如果删除主题或文件夹,则其余主题会保留其顺序。

  • 如果添加新的主题或文件夹,则它将添加到父文件夹顶部的最上面。

  • 如果您将主题或文件夹拖放到非主题/文件夹项目上(例如 CSS、图像或辅助文件),它将移动到目标父文件夹中的最后一个位置。

要排序主题,只需将主题或文件夹拖动到另一个主题或文件夹的上方或下方即可。绿色箭头将指示主题或文件夹的位置。

Chapter Layout

Adobe RoboHelp - 项目文件管理

RoboHelp 提供多种组织和处理项目文件的方法。我们将了解下面的一些常见操作:

按标题或文件名列出主题

打开一个项目,在“项目”选项卡中,转到“视图”部分→“显示主题”,然后选择按主题标题文件名显示主题。

Project Tab

使用待办事项列表

可以使用可自定义的待办事项列表来跟踪项目任务。从旧版 RoboHelp 版本转换项目时,将保留待办事项列表。要编辑待办事项列表,请转到项目设置,单击常规选项卡,然后单击管理…

要向列表中添加任务,请单击“添加”。键入任务项目的名称。要编辑或删除任务,请选择任务,然后单击“编辑”或“删除”。

Project Settings

编辑最近打开的项目列表

RoboHelp 启动程序面板列出了最近打开的项目。要编辑此列表,请转到“文件”菜单,然后单击“选项”。单击“最近的项目”选项卡。如果要更改列出的文件数量,请在“最大项目”框中指定一个数字。要从列表中删除文件,请选择它,然后单击“删除”。您可以通过选择文件并单击固定来固定常用文件。

Project Edit

将文件和文件夹添加到辅助文件文件夹

有时,您可能需要将文件添加到辅助文件文件夹中,以便外部元素在输出中正确显示。您可以添加单个文件甚至文件夹。要将文件或文件夹添加到辅助文件文件夹,请右键单击“项目文件”,转到“导入辅助文件”,然后选择“文件”或“文件夹”。

Import Baggage

映射文件类型

您可以映射文件类型,以将其与用于编辑和查看的应用程序关联。要将文件扩展名与应用程序关联,请转到“文件”菜单,然后单击“选项”。单击文件关联选项卡。您可以关联程序以及 HTML 编辑器。

要关联程序,请在关联程序部分中单击“添加”,然后输入文件名扩展名。选择一个编辑器来编辑具有指定文件名扩展名的文档,然后选择一个程序来查看文件。

要添加 HTML 编辑器,请在“HTML 编辑器”部分中单击“添加”,然后从推荐程序或注册用于编辑或查看 .html 或 .htm 文件的其他程序中进行选择,然后单击“确定”。

Mapping File

从项目中删除主题

建议在删除项目文件之前备份所有项目文件、查看和打印报告。如果您的项目未处于版本控制之下,这一点尤其重要。为了避免断开的链接,请不要在 Windows 资源管理器或版本控制软件中删除文件。

选择一个或多个文件,然后按键盘上的 Delete 键。作为预防措施,建议不要删除对已删除主题的引用,以便可以在断开的链接文件夹中将其显示出来以供日后查看。要删除多个主题,请使用主题列表面板

Adobe RoboHelp - 项目文件夹管理

与项目文件管理类似,RoboHelp 还提供管理项目文件的方法。我们将了解下面的一些常见文件夹操作:

创建文件夹

您可以使用默认文件夹在项目管理器中创建文件夹和子文件夹。这些文件夹包括:

  • HTML 文件(主题)
  • 图像
  • 多媒体
  • 样式表和
  • 辅助文件

要创建文件夹,请右键单击项目管理器面板中的项目文件文件夹,转到“新建”,然后选择“文件夹”。输入名称并按 Enter 键。

Creating Folders

重命名文件夹

要重命名文件夹,请在项目管理器面板中展开“项目文件”文件夹。右键单击要重命名的文件夹,然后单击“重命名”。键入新名称并按 Enter 键。

Rename Folders

移动文件夹

要移动文件夹,请在项目管理器面板的“项目文件”中选择该文件夹,然后将子文件夹拖动到其新位置。

删除自定义文件夹

要删除文件夹,请右键单击项目管理器面板中的文件夹,然后单击删除

Remove Custom Folders

Adobe RoboHelp - 多语言创作

RoboHelp 允许创作多种语言的内容。语言适用于项目的文本、字典和索引。但是,请记住,对于 HTML 帮助系统,最终用户的操作系统必须与项目语言相同,否则将被操作系统语言覆盖。

您可以比较不同语言的内容,或选择不同的语言进行翻译。

比较不同语言的内容

要比较不同语言的内容,请打开以不同语言创建的主题。将其中一个主题的选项卡稍微向下拖到“设计”按钮(文档窗格的第二行),然后选择是垂直比较还是水平比较。

Compare Content

用于翻译项目文件的语言

在“输出”选项卡中,选择“停用词”,如下面的屏幕截图所示。

Output Tab

您可以在本地化对话框的高级设置中相应的选项卡中更改以下设置。

  • 停用词列表 - 添加文本搜索期间必须忽略的词语。

  • 短语 - 添加智能索引向导在搜索主题内容关键词时要包含的短语。

  • 标签 - 修改列出的每个用户界面元素的文本。

  • “始终忽略”词语 - 添加智能索引向导在生成索引时忽略的词语或短语。

  • 同义词 - 添加词语的同义词。即使搜索同义词,也会始终返回搜索词的结果。

在下一章中,我们将了解如何在 RoboHelp 中导入 PDF 文件。

Adobe RoboHelp - 导入 PDF 文件

RoboHelp 允许您从 PDF 文件导入内容。目录会被导入到帮助文件中。但是,请记住,加密的 PDF 文件或包含 SWF 文件的文件将无法导入。您可以通过导入 PDF 创建项目,也可以将 PDF 导入项目。

从 PDF 文件创建项目

要从 PDF 文件创建项目,我们需要按照以下步骤操作。

步骤 1 - 转到“文件”菜单,单击“新建项目”,然后单击“导入”选项卡。在文件类型列表中选择 PDF 文档,然后单击“确定”。

PDF

步骤 2 - 在“导入 PDF 向导”中,浏览到要导入的 PDF 文件的位置,然后单击“下一步”。输入项目的详细信息,然后单击“下一步”。选择所需的转换选项,然后单击“完成”以将 PDF 导入为 HTML 帮助文件。

步骤 3 - 当您选择根据样式创建新的主题时,RoboHelp 将分析 PDF 的段落样式和标题,并为您拆分主题。

PDF Wizard

将 PDF 文件导入项目

要将 PDF 文件导入项目,我们必须按照以下步骤操作。

步骤 1 - 您可以将 PDF 文件导入现有项目。确保项目管理器面板已打开,然后右键单击“项目文件”文件夹。单击导入主题…,然后浏览到磁盘上 PDF 文件的位置。

注意 - 您还可以通过按住 Ctrl 键并单击每个文件来一次选择多个 PDF 文件。

PDF Files

步骤 2 - 在“导入 PDF 向导”中,浏览到要导入的 PDF 文件的位置,然后单击“下一步”。输入项目的详细信息,然后单击“下一步”。

步骤 3 - 选择所需的转换选项,然后单击“完成”以将 PDF 导入为 HTML 帮助文件。当您选择根据样式创建新的主题时,RoboHelp 将分析 PDF 的段落样式和标题,并为您拆分主题。

导入和链接 MS Word 文档

与 PDF 文件一样,您也可以在 RoboHelp 中导入和链接 Microsoft Word 文档。您可以通过导入 Word 文档创建新的帮助文件,也可以将 Word 文档导入现有的帮助文件。在导入 Word 文档之前,重要的是要对其进行优化以用于在线输出。您可以选择导入或链接 Word 文档。选择最适合您需求的一种非常重要。

导入允许您将 Word 文档集成到帮助文件中,并从项目管理器自定义文件名。链接允许您动态更新源文档,包括目录、索引和词汇表。

您还可以重新生成已删除的主题并保留已生成主题中的更改。但是,您无法从项目管理器更改文件名和主题标题。

优化 Word 文档以用于在线输出

要优化 Word 文档以用于在线输出,我们应考虑以下几点。

  • 标题层次结构 - 转换前应用分层标题以实现自动分页。例如,您可以在 Word 文档中应用“标题 1”样式,将此样式映射到类似的 RoboHelp 样式,并定义分页以针对每个“标题 1”样式创建 HTML 主题。

  • 内联样式和样式覆盖 - 您可以将内联样式转换为 RoboHelp 中的 CSS 样式。

  • 页眉和页脚信息 - RoboHelp 可以转换页眉和页脚。为了确保主题之间的一致性,您可以定义包含所需页眉和页脚信息的母版页。

  • 章节与主题 - 在联机帮助中,组织单元是主题,用户一次查看一个主题。通过对相关主题进行分组,提供全面信息而无需添加冗余内容。

  • 目录 - 您还可以通过定义主题层次结构并在 RoboHelp 目录中进行表示,将 Word 目录导入到 RoboHelp 目录中。

  • 上下文相关性 - 您可以使用自定义脚注条目在 Word 文档中分配上下文相关帮助标记。RoboHelp 读取这些脚注条目并将地图 ID 分配给生成的主题。

将 Word 文档导入 RoboHelp

与不需要安装 Acrobat 或 Acrobat Reader 的 PDF 文件不同,您需要安装 Microsoft Word 才能将 Word 文档导入 RoboHelp。

要导入 Word 文档,在启动面板中,转到“导入”选项卡,选择代表 Word 文档(*.docx、*.doc)的图标,然后选择要导入的 Word 文档。输入项目详细信息,然后单击“完成”。

Import Word Document

将 Word 文档链接到 RoboHelp 项目

要将 Word 文档链接到 RoboHelp 项目,请按照以下步骤操作。

步骤 1 − 在“项目管理器”面板中,右键单击“项目文件”文件夹,然后从链接子菜单中选择“Word 文档”。选择一个或多个 Word 文档,然后单击“打开”。

Linking Word Document

步骤 2 − 右键单击“项目文件”文件夹中链接的 Word 文档,然后单击“属性”。

步骤 3 − 在“Word 文档设置”对话框中,指定目录、索引和词汇表设置。

步骤 4 − 要从 Word 文档生成目录,请单击转换目录复选框,然后选择是追加到现有目录还是创建新的关联目录。

步骤 5 − 要从 Word 文档生成索引,请单击转换索引复选框,然后选择是追加到现有索引还是创建新的关联索引。

步骤 6 − 要从 Word 文档生成词汇表,请单击转换词汇表复选框,然后选择是追加到现有词汇表还是创建新的关联词汇表。

Word Document Settings

Adobe RoboHelp - 转换 Word 样式

Word 样式使用级联样式表 (CSS) 映射到 RoboHelp 样式。RoboHelp 使用的默认 CSS 称为RHStyleMapping.css。您可以将其更改为您选择的其他文件,或在您首选的 CSS 编辑器中编辑此 CSS 文件。

选择样式映射的 CSS

要选择样式映射的 CSS,请按照以下步骤操作。

  • 链接或导入需要将其样式映射到 RoboHelp 的 Word 文档。

  • 从“项目”选项卡打开“项目设置”对话框,然后单击“导入”选项卡。

  • 从“样式映射 CSS”下拉菜单中选择 CSS。您也可以通过选择下拉菜单中的<BrowseCSS>来选择自定义 CSS。

Style Mapping

将 Word 段落和字符样式转换为 RoboHelp 样式

要将 Word 段落和字符样式转换为 RoboHelp 样式,请考虑以下步骤。

步骤 1 − 导入或链接 Word 文档,然后转到“项目设置”。选择“导入”选项卡,然后单击“Word 文档”部分中的编辑…

步骤 2 − 在“转换设置”对话框中,从段落组中选择 Word 样式。您可以选择从 RoboHelp 样式下拉菜单中将RoboHelp 样式映射到 Word 样式。选择[源]以保留在线帮助格式中 Word 文本的外观。要编辑选定的 RoboHelp 样式,请单击编辑样式

Conversion Settings

步骤 3 − 要为词汇表标记样式,请选择词汇表定义复选框以考虑词汇表定义的样式。选择词汇表术语复选框以考虑词汇表术语的样式。

步骤 4 − 要在选定的 Word 段落样式的每次出现时创建一个帮助主题,请选择分页(根据此样式拆分为主题)复选框。

步骤 5 − 您还可以为选定的段落样式选择或输入用户定义的 HTML 标记

步骤 6 − 同样,您还可以将 Word 字符格式映射并编辑到 RoboHelp 中的字符样式。从字符组中选择 Word 字符样式,然后从下拉菜单中选择 RoboHelp 字符样式。

步骤 7 − 要导入 Word 字符样式,请从弹出菜单中选择[源]。您可以通过单击编辑样式来编辑 RoboHelp 中的字符样式。

导入 DITA 映射和 XML 文件

达尔文信息类型体系结构 (DITA) 映射类似于目录,列出并链接特定输出的主题。它们将主题组合成适合特定交付需求的序列和层次结构。DITA 映射文件扩展名为 .ditamap。您可以导入 DITA 映射和 XML 文件来生成XHTML 输出

导入 DITA 映射文件

要导入 DITA 映射文件,请按照以下步骤操作。

步骤 1 − 转到“文件”菜单,单击新建项目,然后单击“导入”选项卡。在文件类型列表中选择 PDF 文档,然后单击“确定”以打开 DITA Open Toolkit 处理选项对话框。

DITA

步骤 2 − 检查对话框中提供的以下设置,然后单击“完成”。

  • 替换用于转换的默认 XSLT 文件 − 选择一个 XSL 文件用于将 DITA 文件转换为 XHTML,而不是 DITA Open Toolkit 使用的默认 XSL 文件。

  • 使用 DITA val 进行条件处理 − XHTML 基于 Val 文件生成。DITA Val 文件包含过滤器、标记和修订信息。指定一个 DITA Val 文件用于 DITA 文件的条件处理。

  • 在主题中显示索引条目 − 选择以在 RoboHelp 主题中显示索引条目。

  • 在批注中显示图像文件名 − 选择以向图像添加批注,显示图像的文件名或要包含在主题中的完整路径。

  • 包含草稿和清理内容 − 选择包含草稿和需要清理的内容(发布前确定为待办事项)。

  • 选择要放置在页眉区域 (hdf) 中的 XHTML 文件 − 选择包含要放置在输出文件页眉区域中的 XHTML 的文件的位置。

  • 选择要放置在正文页眉区域 (hdr) 中的 XHTML 文件 − 选择包含要放置在输出文件正文页眉区域中的 XHTML 的文件的位置。

  • 选择要放置在正文页脚区域 (ftr) 中的 XHTML 文件 − 选择包含要放置在输出文件正文页脚区域中的 XHTML 的文件的位置。

  • DITA Open Tool Kit 主目录 − 选择 DITA Open Toolkit 主文件夹的绝对位置。您只需指定一次此位置。它存储在注册表中。

Toolkit

导入 XML 文件

要将 XML 文件导入 RoboHelp 项目,请按照以下步骤操作。

步骤 1 − 将 XML 文件导入现有项目时,RoboHelp 会为该 XML 文件创建一个主题。要导入 XML 文件,请在“项目管理器”面板中选择要导入的文件。

步骤 2 − 转到“项目”选项卡的“导入”部分,然后在下拉菜单中选择 XML 文件。选择一个或多个 XML 文件,然后单击“打开”。

XML Files

步骤 3 − 在“选择 XML 导入处理程序”对话框中,单击“选项”。您还可以选择“导入 XML (CSS/XSL)”以设置高级选项。

提供以下选项 −

  • 视为文本流 − 导入 XML 文件作为无格式的 HTML 文本。

  • 视为 XML 树视图 − 以 HTML 树视图导入 XML 文件。HTML 导入为代码。

  • 使用自定义 CSS/XSL 文件 − 从弹出菜单中选择一个文件。

步骤 4 − 单击“确定”将 XML 文件导入项目。

Adobe RoboHelp - 导入 WinHelp 文件

RoboHelp 可以将已编译的WinHelp 4.0 (HLP)WinHelp 项目文件 (HPJ) 导入到您的项目中。尽管您无法从 RoboHelp HTML 输出 WinHelp 文件,但您可以导入 HPJ 文件,它是包含整个源文件集的主要组织文件。

Import

在启动面板中,选择WinHelp (*.hlp)WinHelp 项目 (*.hlp),然后继续浏览磁盘上文件的位置。单击“完成”以将文件转换为 RoboHelp 文件并导入。

HLP 文件的 HTML 限制

将 HLP 文件转换为 HTML 时存在一些限制。所有这些限制都简要解释如下 −

  • 项目符号 − WinHelp 主题不应使用位图引用作为项目符号。但是,您可以选择保留项目符号列表。

  • HTML 跳转 − 跳转到未转换的 HTML 页面,但在创建 HTML 主题后,您可以轻松地在设计编辑器中重新创建链接。

  • 跳转到外部 WinHelp 主题 − 跳转到从 HTML 主题中剥离的外部 WinHelp 主题。

  • 宏、按钮和快捷键 − 转换的宏包括 Jump Context、JumpId 和 PopupId。其他宏不会转换。

  • Microsoft Word HTML 样式 − Microsoft Word HTML 样式不用于设置 HTML 主题的格式。

  • Microsoft Word 模板 − 用于设置 WinHelp 中 RTF 文件格式的 Word 模板不会转换为 HTML 样式表。

  • 主题内跳转 − 主题内跳转将转换为书签。

  • 多媒体文件 (AVI 和 WAV) − 这些文件无法与 HLP 文件一起转换。但是,您可以在设计编辑器中向 HTML 主题添加声音和视频。

  • 非滚动区域 − 基于 HTML 的输出不支持非滚动区域。

  • 编号列表 − 编号列表默认使用 12 点衬线字体。要更改样式,您需要创建一个新的编号列表样式并在 RoboHelp 中重新设置其格式。

  • 相关主题按钮 − 相关主题关键字将转换为相关主题术语。

  • 辅助窗口 − WinHelp 辅助窗口不会转换。与 WinHelp 主题不同,HTML 主题不支持显示辅助窗口中信息的链接。

  • 目录 − HTML 目录文件 (HHC) 不支持链接到外部 WinHelp 主题或引用宏或包含链接语句的 WinHelp 页面。

  • 这是什么?帮助 − 上下文相关的帮助不会转换。“这是什么?”帮助样式主题或对话框主题将转换为常规 HTML 帮助主题。

  • Microsoft Word 格式 − HTML 主题中转换以下格式:下划线、段落间距、缩进、对齐方式、表格边框、电子表格、背景颜色和水印。

在下一章中,我们将了解什么是版本控制以及它如何使 RoboHelp 受益。

Adobe RoboHelp - 版本控制

版本控制是一项重要的企业功能,它将文档的每个版本保存在服务器上。因此,多个人可以同时对文档进行更改,而无需担心会干扰原始文档。由于保存了文档的所有版本,用户可以根据需要恢复到任何版本。

RoboHelp 支持与Microsoft SharePoint 2010 及更高版本进行本地集成。Microsoft SharePoint 的支持在程序安装过程中安装。安装程序还会安装.NET Framework 4.0SQL Server Compact 3.5 SP2,这是 SharePoint 集成所必需的。

配置 SharePoint 设置

要配置 SharePoint 设置,请转到“文件”菜单,单击“选项”,然后选择“版本控制”。要启用计算机和服务器之间的文件比较,您需要安装文件比较程序。

您可以从http://winmerge.org/下载名为Winmerge的免费程序,并在 SharePoint 设置区域的“路径”参数中输入程序路径。您还可以输入任何程序特定的参数。

Winmerge

您还可以配置以下选项 −

  • 覆盖可写文件前通知 − 在覆盖任何未签出的可写文件之前通知用户。

  • 即使服务器版本相同也替换本地文件 − 即使本地文件版本和服务器版本相同,也要从服务器获取最新文件。

  • 默认签入选项 − 选择将文件签入为主要版本还是次要版本。默认为签入为主要版本。

在下一章中,我们将学习如何在 RoboHelp 中使用报表。

Adobe RoboHelp - 使用报表

RoboHelp 使得轻松获取有关项目的报表。您可以从报表对话框导出、打印和发送报表。

Reports Dialog Box

导出项目报表

单击“工具”选项卡,然后选择报表类型。根据需要自定义报表。单击“另存为...”并将报表保存为 RTF 或 TXT 文件。

打印项目报表

在“报表”对话框中,根据需要自定义报表。单击**打印…**打印报表。您可以通过转到“文件”菜单并单击“打印”来打印“目录”或“索引”窗格中的目录或索引。

发送项目报表

在“报表”对话框中,自定义报表并单击“邮件发送…”。您需要在系统中配置电子邮件程序才能使用此功能。报表将显示在邮件正文中,您可以在发送前对其进行编辑。

生成和自定义报表

使用 RoboHelp,您可以生成和自定义各种报表。我们将查看一个不可自定义报表和一个可自定义报表的示例。所有报表都可以从**工具**选项卡访问。

断开的链接报表

可以通过单击“工具”选项卡中的*地图 ID*图标并选择*断开的链接*来访问此报表。它查找包含断开的链接的文件。此报表不可自定义。

Brocken Links Report

索引报表

单击“工具”选项卡中的**目录图标**,然后从下拉菜单中选择**索引**。可以在此报表中自定义以下选项。

  • **关键词** - 包括索引中的所有关键词。

  • **关键词和主题** - 包含关键词列表。每个关键词列出使用它的主题。

  • **主题和关键词** - 包含主题列表。每个主题列出与其关联的关键词。

  • **选择索引** - 从列表中选择一个索引以生成所选索引的报表。

Index Report

创建、保存和打开主题

项目管理器窗格使创建、保存或打开主题变得容易。

创建主题

要在 RoboHelp 中创建主题,我们应该按照以下步骤操作。

**步骤 1** - 首先,创建一个项目,右键单击 XHTML 文件(主题)文件夹,转到“新建”菜单,然后选择**主题…**以打开“新建主题”对话框。

XHTML Files

**步骤 2** - 在“新建主题”对话框中,指定主题标题并从“变量”列表中选择一个变量,然后单击“插入”。变量有助于管理更改并确保一致性。

**步骤 3** - 根据 HTML 文件命名协议,使用下划线而不是空格。根据需要选择母版页并为新主题指定语言。如果您不指定语言,RoboHelp 将使用项目的默认语言设置。

**步骤 4** - 您可以添加关键词来标记主题的内容。关键词可以用逗号、空格或分号分隔。如果您不想将此主题包含在搜索结果中,请选中**将此主题从搜索中排除**复选框。

New Topic

保存主题

要保存主题,只需按键盘上的 Ctrl+S 或单击“项目”选项卡中的“全部保存”图标。

Saving Topic

打开主题

要打开主题,双击项目管理器窗格或主题列表窗格中的主题名称,即可在**设计编辑器**中打开主题。要在您选择的编辑器中打开主题,请右键单击主题,转到**“使用…编辑”**菜单并选择编辑器。

Opening Topic

在XHTML中创作主题

RoboHelp 可以创建 XHTML 中的主题文件。XHTML 允许结构化创作,确保编写良好的代码。所有旧的 RoboHelp HTML 主题都升级到 XHTML。XHTML 主题符合万维网联盟 (W3C) 的 XHTML 1.0 Transitional 规范。

主题具有 XHTML Transitional 1.0 文档类型 - <DOCTYPE html PUBLIC “-//W3C3DTD XHTML 1.0 Transitional//EN” “http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd”>

RoboHelp 生成的 XHTML 文件可以使用第三方编辑器(如**记事本**或**Adobe Dreamweaver**)进行编辑。要查看 XHTML 源代码,请打开主题并单击**设计编辑器旁边的 HTML 视图**。

将 XHTML 转换为 HTML

您可以在 SSL 输出中将 XHTML 主题转换为 HTML。为此,请转到“文件”菜单,然后转到“选项”并单击“常规”。在“生成”部分,选中“将 RoboHelp 编辑的主题转换为 HTML”复选框,然后单击“确定”。

Converting XHTML

验证 XHTML

可以验证 RoboHelp 生成的 XHTML 代码是否符合 XHTML Transition 1.0 W3C 规范。要验证主题,请右键单击主题,然后选择“验证 W3C 合规性”以验证主题。这将在文档窗格中生成一个输出视图,显示结果。

主题中的跑马灯、框架集中的边框颜色和主题属性中的背景声音等一些功能在 XHTML 中不受支持。这些将导致代码不符合规范。您需要删除这些功能才能通过验证。

Validating XHTML

创建和使用母版页

母版页是一种模板形式,有助于将布局和样式与内容分开。母版页的布局信息与 CSS 文件相关联。母版页模板定义了**页眉、页脚**和**占位符**(用于**正文、面包屑**和**主题目录**)的位置。

创建母版页

要创建母版页,请转到“输出”选项卡,然后从“母版页”菜单中选择**新建母版页**。

Master Page

在“新建母版页”对话框中,输入母版页的名称。转到“外观”选项卡,选择要应用于新母版页的样式表,然后单击“确定”。这也可以在以后的母版页属性中更改。

New Master Page

编辑母版页

要编辑母版页,只需双击**输出设置**窗格中的母版页,或右键单击母版页并单击**编辑**即可。进行所需的更改。

Edit Master Page

插入占位符

您可以在母版页中为主题目录、面包屑和主题插入占位符。新的母版页默认情况下包含一个正文占位符。

要插入新的占位符,请将光标放在正文占位符下方或之后。转到“插入”选项卡,然后在“页面设计”部分,单击“主题目录”按钮以从下拉菜单中选择所需的占位符。

Insert Placeholder

应用母版页

从项目管理器中的主题列表中,选择要为其分配母版页的一个或多个主题。右键单击主题,然后选择“属性”。

在“常规”选项卡中,选择“母版页”下拉菜单中提供的母版页列表,然后单击“确定”。您还可以通过单击“母版页”菜单旁边的**眼镜图标**或浏览到磁盘上的母版页来预览。

Apply Master Page

Adobe RoboHelp - 管理主题

RoboHelp 使管理主题变得容易。您可以重命名主题、更新主题引用,甚至跟踪主题的状态。

重命名主题

要重命名主题,请右键单击项目管理器中的主题,然后选择“属性”。

在“常规”选项卡中,在“主题标题”框中键入新标题,然后单击“确定”以更新标题。您也可以单击“项目”选项卡的“文件”部分中的“重命名”按钮。

Renaming

更新主题引用

重命名主题标题时,务必更新主题引用。主题引用包括以下方面:

  • **文本链接** - 链接的路径已更新,但用户可见的链接文本未更新。如果任何主题中的链接文本包含主题标题,则必须更新每个主题。

  • **主题标题** - 要更改主题标题以匹配主题标题,请在设计编辑器中更改它。

  • **目录** - 在“目录”窗格中,右键单击书籍或页面,然后选择“重命名”。输入新标题。

  • **索引** - 如果主题标题是索引关键词,请在“索引”窗格中更新关键词。右键单击上窗格中的关键词,然后选择“重命名”。键入新标题。

跟踪主题状态

新主题的默认状态为**进行中**。状态信息显示在项目报表中。要更改主题状态或设置优先级,请从“项目”选项卡的“文件”部分打开主题的“属性”,然后单击“状态”选项卡。您可以从“状态”下拉菜单中更改主题的开发阶段。

输入一个数字,在“优先级”字段中分配优先级。您也可以在“小时”字段中设置估计或实际的开发时间。您可以根据完成情况勾选“待办事项”列表中的项目。任何其他描述都可以输入到“注释”字段中。

Tracking

拼写检查、查找和替换

RoboHelp 可以对项目的**内容、目录、索引**和**词汇表**进行拼写检查。您可以对一个主题或整个项目进行拼写检查。

拼写检查主题

要拼写检查主题,请在设计编辑器中打开主题,然后在“审阅”选项卡的“校对”部分中,单击**拼写检查**或**拼写检查所有主题**。

APIs

RoboHelp 将扫描文档并推荐单词的更正建议。您还可以将单词添加到当前词典。

Corrections

拼写检查项目

您还可以拼写检查整个项目,包括词汇表、索引和目录。为此,请在“审阅”选项卡中,单击“拼写检查项目”。这将打开一个与之前类似的“拼写”对话框。您可以通过单击“跳过”来跳到项目的不同部分。

Spell Check

自定义词典

您可以使用**词典编辑器**将额外的单词添加到词典。词典编辑器中的单词区分大小写。在“审阅”选项卡中,单击**拼写选项**。在“选项”选项卡的“拼写选项”对话框中,单击**修改…**以打开“词典编辑器”。

输入要添加到词典的单词。然后单击“添加”按钮,然后单击“确定”。

Customize Dictionary

使用查找和替换

使用查找和替换功能,您可以搜索和替换当前主题或项目中的文本、HTML、属性等,甚至可以搜索和替换指定路径中文件和文件夹中的文本、HTML、属性等。要打开“查找和替换”窗格,请按键盘上的**Ctrl+Shift+F**或单击“项目”选项卡中的“查找和替换”。

Find and Replace

在“查找”框中键入要搜索的文本、标签或属性。您可以启用“显示高级筛选器”以选择筛选器并指定文本、标签或属性,以便 RoboHelp 构建正则表达式。

可以应用以下高级筛选器:

  • 起始于 − 指定应出现在找到的实例开头的短语、单词或字符。

  • 结束于 − 指定应出现在找到的实例结尾的短语、单词或字符。

  • 包含 − 指定找到的实例应包含的短语、单词或字符。

  • 不包含 − 指定找到的实例不应包含的短语、单词或字符。

在“替换为”框中键入要替换的文本、标签或属性。如果要搜索而不替换,请将“替换为”框留空。

您可以使用查找范围选项在以下位置查找文本:

  • 当前项目 − 在当前项目中搜索。

  • 当前窗口 − 在当前主题中搜索。

  • 已打开的文件 − 搜索当前在 RoboHelp 中打开的所有文件。

  • 路径 − 搜索所选文件夹路径中的所有文件。

在下一章中,我们将学习如何在 RoboHelp 中确保 W3C 合规性。

Adobe RoboHelp - 确保 W3C 合规性

您可以验证主题和项目是否符合 W3C 标准。RoboHelp 会验证所有内容,并显示任何不合规项的警告或错误消息。要验证主题,请在项目管理器面板中右键单击该主题,然后单击“验证 W3C 合规性”。

要验证项目,请右键单击项目管理器面板中的“项目文件”文件夹,然后选择“验证 W3C 合规性”。根据具体情况,在“输出视图”面板和“错误列表”面板中会显示以下消息。

  • 错误 − 错误的或未关闭的标签

  • 警告 − 无效的 XHTML 标签

  • 信息 − 所有主题均已验证

Warnings

“错误列表”面板显示 HTML 中发生错误的行和列。您可以通过双击错误直接导航到该行。

Adobe RoboHelp - 编辑

RoboHelp 默认情况下包含设计编辑器HTML 编辑器。您还可以使用第三方编辑器,例如Microsoft WordAdobe Dreamweaver进行编辑。

RoboHelp 设计编辑器

从项目管理器面板中选择一个主题文件,将其在设计编辑器中打开。您可以使用 RoboHelp 设计编辑器执行文字处理任务,并插入在线元素,例如链接、多媒体和动态 HTML。

您还可以向主题添加索引关键字、应用条件文本、创建浏览序列、映射 ID 和编辑母版页。您可以在设计编辑器中编辑任何标准 XHTML 或 HTML 文件。

Design Editor

RoboHelp HTML 编辑器

您可以在 RoboHelp HTML 编辑器中直接编写 XHTML 代码。要切换到 HTML 编辑器,请单击文档窗格中的 HTML 选项卡。您可以输入 HTML 标签和文本。

您可以使用关键字扩展功能在键入时自动建议关键字或标签。当您开始键入关键字时,您可以从关键字扩展列表中选择它以插入关键字或标签。除了现有的关键字和标签外,您还可以通过在 HTML 编辑器中右键单击并选择编辑扩展…来指定您自己的关键字。

HTML Editor

将 RoboHelp 与第三方 HTML 编辑器一起使用

您可以同时打开第三方 HTML 编辑器和 RoboHelp,但 RoboHelp 的特定功能(例如纯文本弹出窗口或链接控件)将不可用。如果您使用的是第三方编辑器,请将图像和基于 JavaScript 的特殊效果插入到“行李文件”文件夹中。

要添加 HTML 编辑器,请单击“文件”选项卡中的“选项”,然后单击“文件关联”。在“HTML 编辑器”部分中,单击“添加”,然后从推荐程序列表中选择,或浏览到程序在磁盘上的位置。

Third Party Editor

Adobe RoboHelp - 字符格式设置

“编辑”选项卡提供用于处理字符和字体的选项。您可以使用“编辑”选项卡创建内联样式,这将覆盖现有的样式表。

添加或删除字符格式

要添加或删除字体格式,请选择所需的文本,然后在“编辑”选项卡的“字符”部分中,单击“字符格式”,然后选择“字体”。

Character Formatting

创建字体集

字体集是可以应用于样式表的一组字体。例如,您可以创建一个字体集,其中 Calibri 为第一个字体,然后依次为 Cambria 和 Segoe UI 作为替代字体。如果查看器未安装 Calibri,它将使用 Cambria,然后使用 Segoe UI。

要创建字体集,请单击“编辑”选项卡中“字符格式”菜单中的“字体集”。您可以通过选择字体并单击修改…来修改现有字体集,或者通过单击“新建”并键入字体集名称来创建新字体集。

Font Set

在“修改字体集”对话框中,选择第一个字体,然后单击“添加”。按优先顺序选择其余字体,然后添加它们,然后单击“确定”按钮。字体集将保存,然后与项目关联。

Adobe RoboHelp - 段落格式设置

“编辑”选项卡提供用于处理段落的选项。您可以使用“编辑”选项卡创建内联样式,这将覆盖现有的样式表。

对齐和缩进段落

选择要对齐的段落,然后单击“编辑”选项卡“段落”部分中的四个对齐按钮之一。要设置缩进,请单击同一部分中的“增加缩进”或“减少缩进”按钮。

Aligning

调整行距

要调整行距,请单击“编辑”选项卡“段落格式”菜单中的“段落”。

设置“段落”对话框的“间距”选项;指定每个段落上方和下方的空间量以及行之间的间距,然后单击“确定”。

Adjust Spacing

边框、背景和声音

RoboHelp 允许您轻松编辑内容中的边框和背景。应用的格式会创建内联样式,这将覆盖样式表。

添加或编辑边框和背景

选择主题中的一个段落,然后在“编辑”选项卡的“段落格式”菜单中,单击“边框和底纹”。单击“边框”选项卡或“底纹”选项卡,指定所需的选项,然后单击“确定”。

Edit Borders

向图像添加边框

设计编辑器中双击图像。在“图像”对话框中,单击“边框”以打开“边框”对话框并根据需要设置选项。单击“确定”。

Add Borders

向主题添加声音

右键单击项目管理器中的主题,然后单击“属性”。在“外观”选项卡中,在“背景声音”框中输入声音文件。支持的声音格式包括 – .au、.mid、.rmi.wav。在“声音循环计数”框中输入播放次数。

Add Sounds

Adobe RoboHelp - 使用表格

RoboHelp 允许将数据组织到表格中。RoboHelp 中的表格是完全可自定义的,可以选择应用样式,这些样式可以在多个主题中使用。可以导入 Word 或 FrameMaker 文档中的表格样式并将其映射到 RoboHelp 表格样式。

插入表格

转到“插入”选项卡,然后单击“表格”图标以选择要添加的行数和列数。单击以插入表格。

Inserting Tables

您还可以通过单击“插入表格…”来插入自定义表格。这将打开一个对话框,您可以在其中指定行数和列数,并选择预定义的表格样式。

Table Styles

编辑表格

要编辑表格,请单击表格以启用功能区中的“表格”选项卡。在此选项卡中,您可以添加或删除行和列,以及合并或拆分单元格。您还可以更改表格属性,例如对齐方式和列宽。

Editing Tables

Adobe RoboHelp - 使用列表

RoboHelp 提供了多个用于处理列表的选项。您可以缩进列表并应用项目符号样式和编号格式。

缩进列表

选择要缩进的主题中的列表,然后从“编辑”工具栏中根据需要选择“减少缩进”或“增加缩进”。

Indenting Lists

匹配列表和项目符号颜色

您可以通过更改字体颜色来使项目符号的颜色与列表的颜色匹配。选择要更改颜色的列表,然后在“编辑”选项卡中,单击“字符格式”菜单并选择“字体”,或者只需按 Ctrl+D。在出现的对话框中,选择所需的字体颜色。项目符号颜色和列表颜色将作为内联样式组合在一起。

Matching List

将编号应用于列表

选择要编号的列表,右键单击列表,然后单击项目符号和编号…选择所需的编号样式。在“编号”选项卡中,选择所需的编号模式。

Lists Numbering

在列表中添加段落

要在列表中添加段落,请将光标插入段落末尾,然后按Shift+Enter创建换行符。要结束换行符并重新启动项目符号或编号,请按 Enter。

创建和编辑变量

您可以以用户定义变量 (UDV) 的形式存储可在项目中重复使用的静态全局信息。当您修改变量或值时,该变量或值的每个出现都会在整个项目中更新。

“用户定义变量”面板列出了项目中的所有用户定义变量。

创建用户定义变量

要创建 UDV,请右键单击主题中的一个单词,转到“添加到”菜单,然后选择“用户定义变量”。在出现的对话框中,指定“变量名称”,然后单击“确定”。

New Variable

创建变量集

变量集使您可以修改各种用户定义变量的值,并在不同的输出中使用它们。默认变量集是主变量集。当您插入变量时,该变量将取自默认变量集。

要使用除默认变量集以外的变量集,请单击 UDV 面板中的“添加/编辑变量集”图标,然后单击“添加”以指定新变量集的名称,然后单击“确定”。

Variable Set

编辑用户定义变量

要编辑用户定义变量,请右键单击变量名称,然后单击编辑…。在“用户定义变量属性”对话框中,您可以编辑变量的不同属性,例如变量名称、它所属的集合、值和可选说明。

Editing Variable

样式中的媒体规则和属性

媒体规则有助于定义文档在不同屏幕尺寸上的外观。

在样式表中定义特定于媒体的样式

要定义特定于媒体的样式,请右键单击项目管理器面板中的样式表,然后单击“编辑”。在样式对话框中,选择要为特定媒体修改的样式。从“媒体”列表中选择媒体类型。

  • “(无)”样式用于定义通用样式,“打印”样式用于打印机。

  • 根据需要修改样式,然后单击“确定”。

Styles Dialog Box

在主题样式中添加媒体规则

如果要为当前链接到主题的样式表中的样式定义不同的媒体规则,请转到“项目”选项卡,然后在“组件”下拉菜单中单击“样式和格式”组件。在“样式和格式”组件中,选择要为特定媒体修改的样式,右键单击并选择“编辑”。

  • 从“媒体”列表中选择媒体或屏幕配置文件名称。

  • 根据需要修改样式,然后单击“确定”。

Media Rule

Adobe RoboHelp - 样式表管理

样式表可以与任意数量的 HTML 主题或新主题关联。如果在项目中创建样式表并将其应用于新主题,则以后创建的所有主题都将使用新的样式表。如有必要,您可以将主题链接到另一个样式表。

将样式表链接到主题或母版页

要链接样式表,请从主题列表中选择一个或多个主题,右键单击,选择“属性”,然后单击“外观”选项卡。

在列表中选择一个样式表,或导航到计算机上的新样式表。您可以单击“新建”创建样式表,或在“样式”对话框中编辑样式表。

Status

创建样式表

在您创建样式表或将另一个样式表链接到新主题之前,**default.css** 是默认样式表。要创建样式表,请转到“编辑”选项卡,然后在“CSS”部分中单击“新建样式表”。

Style Sheet

在“名称”字段中,键入包含**.css 扩展名**的文件名,然后选择文件夹位置。如果要基于现有样式表创建新样式表,请在“从以下样式复制”下拉菜单中选择现有样式。单击“创建”打开“样式”对话框以创建新样式,然后单击“确定”。

Adobe RoboHelp - 样式表的样式设置

本章将介绍如何设置样式表的样式。

在“样式”对话框中创建样式

要创建样式,请右键单击项目管理器组件中您想要样式的样式表,然后单击“编辑”。单击“新建”并选择样式类型。默认情况下,新样式将使用默认名称创建,例如 Style1。

在“样式”对话框中,更改样式的默认名称,但不要在名称中使用任何特殊字符或空格。在“样式”对话框的“格式”部分中,更改所需的选项。您可以在“段落预览”部分中预览更改。

Dialog Box

有关其他选项,请单击“格式”,然后从以下选项中选择:

  • **字体** - 选择字体系列、大小和属性,例如粗体或斜体。

  • **段落** - 设置缩进、行距和对齐方式。

  • **边框和阴影** - 使用“边框”选项卡设置边框类型、颜色、线粗细和间距。使用“阴影”选项卡设置背景颜色和图像选项。

  • **DHTML 效果** - 选择要包含哪个动态 HTML 效果以及何时包含它。

使用设计编辑器创建样式

您可以使用设计编辑器动态创建样式。为此,请在主题中选择一些文本并应用一些格式。在文本仍然突出显示的情况下,在“编辑”选项卡的“样式”列表中键入样式名称,然后按 Enter 键。在出现的对话框中,单击“创建”。

Design Edit

Adobe RoboHelp - 创建表格样式

**样式编辑器**允许您根据需要创建和自定义表格样式。对表格样式的修改会影响使用该样式的所有表格。

应用表格样式

要在现有表格上应用表格样式,请右键单击主题中的现有表格,然后选择**表格样式…**。在“选择表格样式”对话框中选择**清除表格内联格式**以删除表格中使用的任何内联样式。从“可用表格样式”列表中选择样式,或选择全局表格样式(表格模板),然后单击“确定”。

Apply Table Style

创建表格样式

从“项目”选项卡打开“样式和格式”组件。在“样式和格式”选项卡中,单击**创建新样式**并选择“表格样式”。命名新的表格样式,然后单击“确定”。

Create Table Styles

您可以将格式应用于整个表格、第一列或最后一列或行,或一组行或列。从“应用格式到”列表中,选择要格式化的列或行。

选择字体、大小和颜色。选择边框和边框颜色,然后单击“应用”。新样式将出现在“表格样式”对话框的“CSS 样式”列表中。稍后选择此样式以创建具有相同样式的表格。

Adobe RoboHelp - 创建列表样式

<从这里开始> 使用 RoboHelp,您可以创建 HTML 列表和高级列表。高级列表可以是单级列表或多级列表。

  • **HTML 列表** - 所有有序的**<ol>**和无序的**<ul>**列表都属于 HTML 列表。

  • **高级列表** - 创建分层或大纲列表,例如编号标题样式,编号如 1、1.1、1.1.1 等。

创建 HTML 列表

在“样式和格式”组件中,选择“列表样式”。右键单击该组件,转到“新建”菜单,然后选择“列表样式”。命名新列表,选择新列表样式的字体、字体大小和颜色。

您可以单击“创建编号列表”或“创建项目符号列表”按钮来创建编号列表或项目符号列表。

HTML Lists

创建多级列表

在“样式和格式”组件中,单击“创建新样式”,然后选择“多级列表样式”。键入新多级列表的名称,然后单击“确定”。从“应用格式到”菜单中选择列表级别,然后选择要应用于当前列表级别的段落样式。您可以从“列表样式”下拉菜单中选择预定义的列表样式,也可以单击“新建”创建列表样式。

在“编辑样式”对话框中,输入文本或数字以作为序列或多级列表的前缀。要指定要添加前缀的级别,请从“插入级别”菜单中选择该级别。您可以通过使用分隔符(例如点(.)或大于号(>))分隔级别和前缀,在“编辑样式”框中向级别添加前缀。

将格式应用于列表样式,然后单击“确定”。

Multilevel Lists

Adobe RoboHelp - 创建 HTML 样式

您可以使用样式编辑器或“样式和格式”组件编辑**Div、超链接**和**图像**样式。

  • **Div** 用于文本框和定位文本框。

  • **超链接**用于超链接、下拉热点、展开热点和术语表术语。

  • **图像**用于放置图像。

基于 Div、超链接和图像样式创建样式

要基于 Div、超链接或图像样式创建样式,请双击项目管理器组件中的 CSS 文件以打开样式编辑器。右键单击“样式”列表中的样式类别,然后选择“新建”。命名样式并根据需要设置属性。

Styles Creating

编辑 Div 和图像样式

我们可以从样式编辑器或“样式和格式”组件编辑 Div 和图像样式的属性。您可以编辑文本或图像的区域或部分的尺寸、边距、浮动和边框属性。

使用“浮动”属性将文本定位到区域的左侧或右侧。如果将“浮动”属性设置为“左”,则文本将放置在右侧。“溢出”属性(对于 Div 样式)可用于指定如果文本在区域中溢出时会发生什么情况。如果将“溢出”指定为“滚动”,则会添加滚动条以显示溢出的内容。

Styles Editing

Adobe RoboHelp - 在 CSS 中编辑样式

当您在 CSS 文件中编辑样式时,链接到该文件的所有主题都会更新。

使用“样式”对话框编辑样式

要编辑样式,请右键单击项目管理器组件中的 CSS 文件,然后单击“编辑”。取消选中“隐藏继承样式”复选框,然后从“可用位置”下拉菜单中选择样式表。

在“样式”框中选择样式,单击“格式”,然后选择属性并单击“确定”。

Style Dialog Box

在 HTML 编辑器中编辑样式

右键单击项目管理器组件中的 CSS 文件,然后单击“使用代码编辑器编辑”以在新主题窗口中打开样式表。您现在可以根据需要编辑样式。

Styles HTML Editor

Adobe RoboHelp - 创建和打印 TOC

目录 (TOC) 是项目管理器中文件夹和主题的层次结构。本章将介绍如何在 RoboHelp 中创建和打印 TOC。

创建 TOC

要创建 TOC,请右键单击项目管理器中的“目录”文件夹,然后选择“新建目录”。指定 TOC 的名称。您还可以通过选择“复制现有目录”复选框来浏览现有 TOC 文件 (.hhc),以从可用的 TOC 创建 TOC。

单击“确定”打开“目录”组件。在“目录”组件中,单击“自动创建 TOC”按钮。您可以选择在创建新的 TOC 之前删除当前的 TOC,或者使用主题中的书签创建新的 TOC。

Create TOCs

打印 TOC

要打印 TOC,请单击“目录”组件,转到“文件”选项卡,然后单击“打印 TOC”。在出现的对话框中,选择以下选项之一进行打印:

  • **概述** - 打印所有图书和页面标题。

  • **详细** - 打印所有图书和页面标题、链接到每个标题的主题标题以及主题所在的文件夹。

您可以通过单击“属性”或“页面设置”来修改打印选项。

Print TOCs

Adobe RoboHelp - 编辑 TOC

您可以重命名 TOC 图书和页面,而不会影响链接到它的主题标题。您还可以更改主题标题,而不会影响 TOC。在 RoboHelp 中,您可以重命名、重新排序或更改 TOC 图书或页面的属性。

重命名 TOC 图书和页面

要重命名 TOC 图书或页面,请右键单击“目录”组件中的图书或页面,然后选择“重命名”。键入新名称,然后按 Enter 键。

Rename TOC

重新排序 TOC 图书和页面

选择“目录”组件中的图书或页面,然后将项目拖动到其他位置。

更改 TOC 图书或页面的属性

要重命名图书或页面或编辑窗口框架,请右键单击“目录”组件中的图书或页面。单击“属性”以打开“TOC 图书属性”对话框。在“常规”和“高级”选项卡中进行所需的更改,然后单击“确定”。

Change Properties

Adobe RoboHelp - 管理 TOC

RoboHelp 提供了多个管理 TOC 和解决错误和断链的选项。

使用报告管理 TOC

我们可以获得不同形式的目录 (ToC) 报告,可以打印、复制和发送电子邮件。要访问这些报告,请转到工具选项卡,然后在报告部分选择所需的报告类型。

目录报告以目录的形式显示书籍和页面的层次结构。如果更改主题标题或文件名,可以将它们与书籍和页面中使用的标题进行比较。

您可以从以下报告格式中选择:

  • 详细 - 包括书籍和页面的标题、与其链接的主题名称以及文件所在的文件夹名称。

  • 概述 - 包括书籍和页面的标题以及与其链接的主题名称。

Report Format

识别和修复损坏的目录链接

当损坏的链接在目录窗格中显示为红色的“X”时,您可以识别它们。在“项目”选项卡中,单击“导航”部分中的“损坏的链接”。

Broken TOC

选定主题的引用

显示对缺失主题的所有引用。“打开书籍”图标 Book 表示损坏的目录引用。

所有缺失的主题

显示项目中缺少的主题。要删除目录项目,请在“选定主题的引用”下选择它,然后单击“删除”。

使用多个目录

我们可以为单个项目创建多个目录,这可以用于单一来源出版,例如为包含多种语言或面向不同受众的输出的项目创建单独的目录。

将书籍和页面移动到目录

双击项目管理器窗格中“目录”文件夹中的目录。将书籍和页面从一个目录窗格拖动到另一个目录窗格。

为项目创建多个目录

一个项目可以有多个目录。右键单击项目管理器窗格中的“目录”文件夹,然后选择“新建目录”。在新目录对话框中,键入目录的名称,然后单击“确定”。一个空的目录将创建在“目录”文件夹中。

Multiple TOCs

合并目录

还可以将项目中的多个目录合并到一个目录中。为此,请在目录窗格中选择要合并目录的书籍或页面,然后单击“插入目录占位符”按钮。在“插入目录占位符”对话框中,从“选择目录”菜单中选择要合并的目录,然后单击“确定”。

Merge TOCs

创建索引和关键词

您可以通过添加关键词并将它们与主题关联来创建索引。您可以对索引进行拼写检查,并且可以使用主题待办事项列表来跟踪索引过程中的工作。

使用工具栏添加索引关键词

通过转到“项目”选项卡中的“窗格”菜单打开“索引”窗格。要添加关键词,请单击“索引”窗格工具栏中的“新建索引关键词”按钮。在文本框中键入关键词,然后按 Enter 键。新关键词将以粗体显示,表示它尚未链接到主题。

Add Index

从“项目”选项卡中的“窗格”菜单打开“主题列表”窗格。要将关键词链接到主题,请将主题从“主题列表”窗格拖动到“索引”窗格的下部窗格。链接的关键词将从粗体变为普通文本。

复制索引关键词

索引关键词可以在主题之间复制。复制后,您可以自定义它们以与各个主题一起使用。右键单击“主题列表”窗格中的主题,然后单击“属性”。在“索引”选项卡中,单击“添加现有”。左侧显示项目中所有关键词的列表,右侧显示当前主题的所有关键词的列表。如果主题尚未编入索引,则不会显示任何关键词。

要复制单个关键词,请在左侧选择它,然后单击单箭头按钮,或单击双箭头按钮以复制所有关键词。单击“确定”将关键词链接到主题。

Copy Index

交叉引用索引关键词

可以交叉引用索引关键词,以便当用户在索引中选择交叉引用的关键词时,会出现一个备用关键词,用户可以选择它来显示主题。

在“索引”窗格中添加要交叉引用的关键词。右键单击关键词,然后选择“属性”。在“索引关键词属性”对话框中,选中“交叉引用”复选框,然后从下拉菜单中选择一个备用关键词。交叉引用将出现在索引设计器的下部窗格中。

Cross-reference

Adobe RoboHelp - 编辑索引关键词

RoboHelp 允许您编辑和排序索引关键词。其他布局已对索引进行排序,但仅在 HTML 帮助布局中可更改关键词的排序。移动索引关键词也会移动其子关键词。

移动和排序索引关键词

您可以通过三种方式对索引关键词进行排序:

  • 选择一个关键词,然后单击工具栏中的箭头按钮。

  • 拖动关键词。

  • 右键单击关键词。在“排序”菜单中,选择当前级别当前级别和以下级别

Current Level

仅当允许对索引执行操作时,才可以使用排序功能。

重命名主题的关键词

要重命名特定主题引用的主题关键词,请更改主题属性。如果其他主题使用相同的关键词,则原始关键词将保留在索引中。只有您更改的主题才会更新。

在“主题列表”窗格中,右键单击主题,然后单击“属性”。在“索引”选项卡中选择一个关键词。在文本框中键入新关键词,然后单击“替换”。

Rename Keywords

从主题中删除索引关键词

从主题中删除关键词只会影响当前主题。引用该关键词的其他主题仍然与其链接。在“主题属性”对话框中,在“索引”选项卡中选择一个关键词,然后单击“删除”。

Remove Index

Adobe RoboHelp - 管理索引

您可以使用报告来管理索引。索引有两种类型的报告:索引报告未使用的索引关键词报告

索引报告允许您显示所有关键词、带有相关主题的关键词列表或带有相关关键词的主题列表。“未使用的索引关键词”报告列出主题未引用的关键词。这些关键词位于索引文件中。

使用报告管理索引

在“工具”选项卡中,选择“报告”部分中的“索引”。查看报告,然后单击“关闭”以关闭报告。您也可以打印、复制或发送电子邮件报告。

Manage Indexes

识别和修复关键词主题的损坏引用

在项目管理器窗格中打开“损坏的链接”文件夹。任何缺失的主题都将列出,并带有红色的“X”。右键单击缺失的主题,然后单击“属性”。引用缺失主题的关键词将显示为键图标,可以在“索引”窗格中将其删除或重新链接。

Adobe RoboHelp - 自动索引

RoboHelp 可以根据主题内容自动构建索引。您可以从建议的关键词中选择,也可以使用您自己的关键词。

自动创建索引

智能索引向导可以搜索主题的内容并建议关键词。在“工具”选项卡中,单击“智能索引向导”。在“智能索引向导”对话框中,从以下搜索条件中选择:

  • 查找新的和现有的索引关键词 - 根据主题内容和现有的索引条目添加关键词。

  • 将现有的索引关键词添加到主题 - 搜索主题中已使用的关键词,并将关键词链接到主题。

  • 使用自定义搜索设置 - 选择“设置”,并设置自定义搜索选项。在“智能索引设置”对话框中,您可以定义有效的语言以查找索引关键词。

Create Indexes

在下一个屏幕中,指定以下选项:

  • 文件夹 - 搜索指定文件夹中的主题。

  • 状态 - 按状态搜索主题。

  • 仅检查新的主题(尚未进行智能索引) - 仅搜索未编入索引的主题。

Options

单击“下一步”以查看第一个主题的建议关键词。选择、取消选择、重命名或删除关键词。然后,单击“下一步”,然后在“结果”对话框中单击“关闭”。新的关键词将出现在“索引”窗格中。

查找索引的同义词

打开智能索引向导,然后单击“下一步”两次。选择列表中的关键词,单击“选项”,然后选择“同义词…”。

Synonyms

关键词将出现在“单词”框中。您也可以单击“反义词”以查看关键词的反义词。您可以通过在“单词”框中键入单词并单击“查找”来查找其他单词的同义词和反义词。

Services

在“类别”部分中选择最匹配的单词,然后在“同义词”下选择一个单词作为关键词添加。单击“添加到主题”,然后单击“关闭”以关闭对话框。

Adobe RoboHelp - 创建多个索引

可以在同一个项目中创建多个索引,这些索引将添加到“索引”文件夹中。您可以右键单击任何索引,然后选择设置为默认以将该索引设置为默认索引。

合并索引

要在项目中合并索引,请在项目管理器窗格中打开“索引”文件夹,然后双击索引。在“索引”窗格中,选择要插入合并索引的关键词,然后单击“插入索引占位符”按钮。选择要插入的索引,然后单击“确定”。

合并的索引将显示为“新建索引”图标。双击该图标,然后单击“查看”。

Merge Indexes

自定义、添加目录和索引控件

您可以选择自定义字体来显示书籍和页面的标题,并可以为目录创建 3D 外观。您还可以添加目录和索引控件以更好地导航。

自定义目录

右键单击单一来源布局窗格中 HTML 帮助输出的布局,然后选择“属性”。单击“高级设置”旁边的“编辑”,然后单击“目录样式”选项卡。根据需要设置样式选项,然后单击“确定”。

Customize ToC

添加目录控件(HTML 帮助)

在设计视图中打开主题。单击要在其中添加目录的位置。在“插入”选项卡的“HTML”部分中,从“JavaScript”菜单中选择“目录”。目录控件将出现在设计编辑器中。

要测试控件,请生成项目。目录控件将显示与最终输出中相同的目录。

Add ToC Controls

添加索引控件(HTML 帮助)

如果您的项目不支持三窗格设计,则可以将索引控件添加到主题以使索引文件可用。当使用索引控件打开主题时,索引将显示。在设计编辑器中,打开带有控件的主题,然后单击要在其中添加索引的位置。

在“插入”选项卡的“HTML”部分中,从“JavaScript”菜单中选择“索引”。索引控件将出现在设计编辑器中。要测试索引控件,请编译项目。索引控件将显示与最终输出中相同的索引。

Add index controls

Adobe RoboHelp - 词汇表

要创建词汇表,请双击项目管理器窗格中“词汇表”文件夹中的词汇表。在“词汇表”窗格中,在“术语”框中键入术语。单击添加术语按钮(加号)或按 Enter 键。术语将以粗体显示,表示它没有定义。在“定义”面板中,键入定义。

要使术语和定义显示在主题中,请添加可展开的词汇表热点。

Term

导入和更改词汇表

在导入或更改词汇表之前,打印词汇表的详细报告以确定存在的术语并比较定义总是有帮助的。

导入词汇表术语和定义

在项目管理器窗格中选择“词汇表”文件夹中的词汇表。在“项目”选项卡中,从“导入”部分的下拉菜单中选择“词汇表”。单击“浏览”按钮以导航到 GLO 文件。要使外部词汇表中的定义覆盖匹配的术语,请选择替换现有词汇表定义

选择导入词汇表中的术语列表中的一种或多种术语,单击“添加”或“全部添加”按钮,然后单击“确定”。

Import Glossary

更改词汇表定义

要更改词汇表定义,请在“词汇表”窗格中选择要更改的术语并编辑定义文本。

创建多个词汇表

您可以在同一个项目中创建多个词汇表。新的词汇表将添加到“词汇表”文件夹中。

注意 - 您不能删除默认词汇表。

要创建多个词汇表,我们应该按照以下步骤操作:

  • 在项目管理器面板中,右键单击“术语表”文件夹,然后选择“新建术语表”。

  • 您也可以单击“创建/查看术语表文件”按钮,然后单击“新建”。

  • 在文本框中键入名称。

  • 要复制现有术语表,请选择“复制现有术语表”,然后单击“浏览”按钮以导航到术语表。

New Glossary

术语表热点

术语表热点向导会在主题中查找术语表术语,并在主题中标记它们。生成或预览输出时,您可以标记所有要转换为展开式热点的术语。

注意 − Oracle 帮助中不支持术语表面板。

添加展开式术语表热点

要添加展开式术语表热点,请将术语从术语表面板拖动到主题中。您也可以单击术语表面板中的术语表热点向导按钮。

术语表热点向导会在主题中查找术语表术语,并在主题中标记它们。生成或预览输出时,您可以标记所有要转换为展开式热点的术语。双击设计编辑器中的热点以预览。

Add Expanding Glossary

取消标记展开式术语表热点

如上所述打开术语表热点向导。选中确认标记每个主题的术语复选框。选择要搜索的文件夹和状态。从“选择术语”菜单中选择要移除的术语,然后单击“下一步”。

创建文本链接以进行导航

我们可以使用在项目管理器TOC 编写器中看到的大多数项目创建链接,包括主题、书签、URL、附件文件、新闻组、FTP 站点、与其他程序关联的文件(例如 PDF)和远程主题。

使用设计编辑器创建文本链接

在设计编辑器中选择链接的插入点,然后单击“插入”选项卡的“链接”部分中的“插入超链接”按钮。从“链接到”菜单中选择一个选项,并在框中指定源位置。

从以下选项中选择一个 −

  • 在框架中显示 − 此选项定义用于显示目标内容的框架集。您可以选择框架类型或输入自定义框架信息。

  • 在自动调整大小的弹出窗口中显示 − 在弹出窗口中显示目标主题,而不是在查看器或浏览器中显示。

  • 在自定义大小的弹出窗口中显示 − 在弹出窗口中显示目标主题。要手动调整窗口大小,请在“宽度”和“高度”字段中键入数字。

Navigation

添加鼠标悬停在链接上时出现的工具提示文本。在“选择目标(文件或 URL)”下拉菜单中选择本地主题、书签、框架或 URL,然后单击“确定”。

创建和编辑书签

书签可用于在主题内创建增量链接。书签图标显示在已加书签的对象旁边。要查看项目中的书签。

管理器,请单击主题旁边的加号 Plus

创建书签

在设计编辑器中单击书签所需位置的左侧。然后单击“插入”选项卡“链接”部分中的插入书签图标。输入名称(不含空格),可以使用字母和数字的任意组合。

保存主题后,书签图标将缩进显示在项目管理器面板中列出的主题下,以及主题列表面板中的主题旁边。

Create Bookmarks

重命名书签

打开包含书签的主题。双击主题旁边的书签,编辑名称,然后单击“确定”。

链接图像和多媒体

我们可以在 RoboHelp 中链接图像、声音、视频和其他多媒体文件。

向多媒体剪辑添加链接

将光标放在设计编辑器中要链接的位置,或选择文本或图像以创建链接的热点。单击“插入”选项卡“链接”部分中的插入超链接按钮。

链接到部分,单击三角形按钮并选择“多媒体...” 选择要链接的文件,然后单击“打开”。

Multimedia

从图像和多媒体添加链接

您还可以从图像和多媒体添加链接。在设计编辑器中,单击要链接的多媒体对象或图像,然后按照以下步骤操作。

  • 单击“插入”选项卡“链接”部分中的“插入超链接”按钮。

  • 要从多媒体链接,请在“链接到”部分单击三角形按钮并选择多媒体…

  • 要从图像链接,请选择目标。图像只能包含一个链接。

Adobe RoboHelp - 链接外部资源

本章将学习如何在 RoboHelp 中链接外部资源。

链接到外部主题(Microsoft HTML 帮助项目)

外部主题可以是 Microsoft HTML 帮助项目或其他此类相关项目。单击“插入”选项卡“链接”部分中的“插入超链接”按钮。在“链接到”部分,单击三角形下拉菜单以选择“远程主题”。

链接到外部文件

在设计编辑器中选择链接位置并输入文本。突出显示文本,单击“插入”选项卡“链接”部分中的“插入超链接”按钮。单击“链接到”旁边的三角形按钮,然后选择“文件...”

Open File

浏览到文件,打开它,并将其复制到项目文件夹中。生成文件以测试到外部主题的链接。对于 WebHelp 项目,外部文件必须分发在 WebHelp 文件夹中。对于 Microsoft HTML 帮助项目,外部文件必须与 CHM 文件一起分发。

链接到电子邮件地址、FTP 站点、新闻组和 Web 地址

在设计编辑器中选择链接的位置,或选择文本或图像以定义热点。单击“插入”选项卡“链接”部分中的“插入超链接”按钮。

在“链接到”部分,单击三角形按钮,然后从以下选项中选择 −

  • 要链接到电子邮件,请选择“电子邮件”。

  • 要链接到 FTP 站点或新闻组,请选择“FTP”或“Usenet 新闻”。

  • 要链接到内部网或网站,请选择“Web 地址”。

下一章将讨论如何在 RoboHelp 中维护和修复链接。

维护和修复链接

维护和修复链接是 RoboHelp 的一个非常重要的组成部分。让我们学习如何做到这一点以及它的优点是什么。

更新和移除链接

要更新和移除链接,我们应该按照以下步骤操作。

  • 打开包含所需链接的主题。

  • 要更新链接,请右键单击链接,选择“超链接属性”,然后进行更改。

  • 要移除链接,请右键单击链接并选择“移除超链接”。

  • 要移除链接和文本,请选择文本并按 Delete。

Hyperlink Properties

修复损坏的链接

要修复损坏的链接,我们应该按照以下步骤操作。

  • 单击“项目”选项卡“导航”部分中的主题引用按钮以打开“主题引用”对话框。要修复链接,首先在“对所选主题的引用”中选择一个链接,然后单击“编辑”或“删除”以编辑或移除超链接。

  • 要修复 TOC 项目、索引关键字或图像映射,请首先选择项目,然后单击“编辑”并选择有效的目标来修复损坏的链接。

  • 要移除 TOC 条目,请选择 TOC 项目,然后单击“删除”。

Fix Broken Links

Adobe RoboHelp - 链接控件

链接控件是 TOC 和索引的导航替代方案。链接控件的工作方式类似于链接,可以显示为文本、按钮或图像。链接控件可以引导用户访问相关的主题和信息。它们节省了用户搜索主题的时间。它们还有助于为不同类型的用户组织信息。

链接控件通过将多个主题所需的信息保存在单个主题中,并通过链接控件从多个位置访问它来管理主题内容。您可以通过将链接控件作为对象而不是作为长行链接来插入来管理主题布局。

添加相关主题控件

在设计编辑器中单击控件的位置。在“插入”选项卡的“链接”部分,单击“相关主题”。在“相关主题向导 - 链接选项”对话框中,选择一个选项以将相关主题显示为按钮(可以是标签或图像),或将相关主题显示为文本,然后单击“下一步”。

Topic Controls

在“项目中的主题”部分,选择一个主题并单击“添加”。继续添加所有要作为相关主题显示的主题。如有需要,单击“更改”以更新“相关主题”中的主题名称,然后单击“下一步”。

Project Section

选择是否应在找到的主题对话框或弹出菜单中显示选项。选择一个选项以在框架或新窗口中显示所选主题,然后单击“下一步”。

Topics Found

选择显示和字体选项。

Display

单击“完成”,然后单击“查看”按钮进行测试。

创建和分配“另请参见”关键字

要创建和分配“另请参见”关键字,请双击项目管理器面板中的另请参见文件夹以打开“另请参见”面板。您也可以在文本框中键入“另请参见”关键字,然后单击加号。关键字以粗体显示,表示没有主题与之关联。

See Also Folder

现在让我们考虑以下添加主题、关键字等的步骤。

  • 要将主题分配给另请参见关键字,请单击“主题列表”面板。

  • 要将关键字添加到多个主题,请选择一个主题,将其拖动到下方的面板中,然后对要分配的所有主题重复此操作。

  • 要将关键字添加到各个主题,请单击主题列表面板,选择一个主题,单击“属性”按钮,然后选择另请参见。键入要分配给主题的关键字,然后单击“添加”。

  • 向新的关键字添加“另请参见”控件。

更改、重用或移除链接控件

要更改、重用或移除链接控件,我们应该按照以下步骤操作。

  • 在设计编辑器中打开包含链接控件的主题。

  • 要更改控件,请双击控件并更改其属性。

  • 要重用控件,请右键单击控件并选择“复制”。在目标主题中右键单击并选择“粘贴”。

  • 要移除控件,请选择控件并单击“删除”。

下一章将学习如何使用纯文本弹出窗口。

使用纯文本弹出窗口

我们可以创建称为纯文本弹出消息的简短文本段落,这些段落会在用户单击链接的术语时出现。

创建纯文本弹出窗口

在设计编辑器中选择文本,然后从“插入”选项卡中单击“文本弹出”图标。直接在窗口中键入弹出文本。

Text Popup

编辑纯文本弹出窗口

要编辑纯文本弹出窗口,请右键单击已分配纯文本弹出的文本。然后,我们应该选择“文本弹出属性...”

Edit Text Popup

下一步是在“弹出文本”框中键入或编辑文本。您还可以更改大小、背景颜色、字体和边距。未来的纯文本弹出窗口将继续使用这些选项。

Edit Text

创建和编辑浏览序列

浏览序列帮助读者浏览一系列主题。单个主题可以属于多个浏览序列,但 HTML 文件或来自其他帮助系统的外部主题不能包含在浏览序列中。

自动创建浏览序列

要自动创建浏览序列,请创建目录。从“项目”选项卡的“导航”部分,单击“浏览序列”。在浏览序列编辑器对话框中,单击“使用 TOC 自动创建...” 以打开“使用 TOC 自动创建浏览序列”对话框。

输入要包含在浏览序列中的 TOC 层次结构的级别数,然后单击“确定”。再次单击“确定”。如果您看到启用浏览序列对话框,请单击

Browse Sequence Editor

手动创建浏览序列

要手动创建浏览序列,请从“项目”选项卡的“导航”部分单击“浏览序列”以打开“浏览序列编辑器”对话框。单击“新建”,然后命名浏览序列。从“可用主题”列表中,选择包含要添加的主题的文件夹,并将主题添加到浏览序列窗格,然后单击“确定”。如果您看到“启用浏览序列”对话框,请单击“是”。

Browse Sequences Manually

Adobe RoboHelp - 输出搜索

RoboHelp 支持多种搜索功能。例如,它支持多语言搜索,用户可以使用此功能搜索其他语言的术语(如果这些术语已嵌入主题中)。我们还可以使用 **WebHelp、FlashHelp** 和 **AIRHelp** 输出搜索中文/日文/韩文 (CJK) 搜索词。您还可以使用布尔运算符,如 **AND、OR** 和 **NOT** 来执行搜索。

添加搜索元数据

您可以通过转到“项目”选项卡的“文件”部分中的“项目设置”来添加或编辑搜索元数据。单击“语言”下拉菜单旁边的“高级”按钮,以打开 **本地化对话框** 的高级设置。

Metadata

根据需要设置以下元数据组件。

同义词

用于定义搜索词的同义词。例如,如果同义词是“处理器”和“CPU”,则 RoboHelp 将返回包含“Intel”的主题,并突出显示该术语。请记住,我们只能在“同义词”选项卡中指定单词,而不能指定短语。

Synonym

主题关键字

用于将特定单词或短语与当前主题关联。您可以选择相关的但通常在内容中找不到的单词或短语。例如,如果将“Adobe Systems”与某个主题关联,则当用户搜索“Adobe Systems”时,即使主题实际上不包含此关键字,该主题也会显示。

Topic Keywords

使用 **短语** 选项卡添加关键字。

停用词

用于忽略单词以显示相关的搜索结果。可以忽略诸如“a”、“an”、“the”等常用词,以确保 RoboHelp 只显示所需关键字的结果。

Stop Words

优化和配置搜索

在本节中,我们将了解如何在 RoboHelp 中优化和配置搜索。

优化搜索内容

RoboHelp 支持多种优化搜索内容的方法:

  • **使 Office 和 PDF 文件可搜索 (WebHelp/Pro、FlashHelp/Pro)** - 当通过超链接在主题中引用附件文件时,用户可以在已发布的输出中搜索它们。

  • **从搜索中排除指定的附件文件类型 (多屏 HTML5、WebHelp、FlashHelp 和 AIR Help)** - “从搜索中排除附件文件类型”选项允许您从搜索中排除指定类型的附件文件。例如,您可以从项目中的搜索中排除所有 PDF 文件。

Optimize

配置搜索体验

您可以通过以下方式配置最终用户的搜索体验:

  • **显示搜索结果总数 (WebHelp 和 AIRHelp)** - 此选项启用在输出中显示用户输入的搜索字符串的总结果数。

  • **隐藏搜索结果中的排名列 (WebHelp 和 WebHelp Pro)** - 可以隐藏搜索结果中的排名列,以便为显示搜索结果提供更多空间。

Configure

Adobe RoboHelp - 外部内容搜索

您可以使用外部内容搜索根据用户搜索词显示指定 URL 的内容。当用户使用任何这些搜索词执行搜索时,RoboHelp 会在搜索结果中返回相应 URL 的标题和描述。

设置和管理外部内容搜索

在“项目”选项卡的“打开”部分,单击 **Pod 图标** 并选择 **外部内容搜索** 以打开外部内容搜索 Pod。此 Pod 提供以下选项:

  • **添加** - 单击“添加”并指定搜索词(用逗号、空格或分号分隔)以及外部内容的 URL。

  • **编辑** - 选择要编辑的条目,然后单击“编辑”。修改详细信息,然后单击“确定”。

  • **导入** - 允许您从项目中选择 **SearchOptions.xml 文件**,将该项目的外部内容搜索设置导入到当前项目。

  • **导出** - 选择一个文件夹以导出 SearchOptions.xml 文件。

  • **搜索** - 允许您指定一个字符串来搜索特定条目。

External Content Search

Adobe RoboHelp - 使用图像

RoboHelp 支持标准图像格式,例如 GIF、JPEG、BMP、MRB、WMF、PNG 等。

查找图像

您可以使用 **图形定位器** 扫描硬盘驱动器和文件夹中的图像文件、查看缩略图和复制文件。双击 **工具箱 Pod** 中的图形定位器,然后选择要搜索的图形文件格式。输入搜索路径或浏览到新位置,然后单击“搜索”。

Locate Images

向主题添加图像

要在 RoboHelp 中向主题添加图像,应按照以下步骤操作。

  • 在设计编辑器中选择图像的位置。在“插入”选项卡的“媒体”部分,单击“图像”。

  • 您可以浏览到文件或从项目中插入图像。您还可以将图像从项目管理器的“图像”文件夹拖动到主题中。

  • 单击“确定”关闭“图像”对话框。

Add Images

在 RoboHelp 中编辑图像

在设计编辑器中选择要编辑的图像,右键单击图像并选择“图像属性”以设置以下选项:

  • **文字环绕** - 将图像与周围文字对齐。

  • **屏幕提示** - 当用户将光标悬停在图像上时显示的文本。

  • **ALT 文字** - 当无法显示图像时显示的文本。

  • **大小** - 以像素为单位设置图像的尺寸。选择 **保持纵横比** 以保持高宽比例。

  • **边距** - 指定图像和文本之间的间距。

  • **边框** - 为图像添加边框并指定样式。

Edit Images

导入Adobe Captivate演示

可以从 RoboHelp 启动 Adobe Captivate 并创建演示主题。您还可以将 Adobe Captivate 演示的 **SWF** 和 **HTML5** 输出插入到现有主题中。可以从 RoboHelp 打开并编辑演示源。

单击“项目”选项卡“导入”部分中的 **文档图标**,然后选择“Adobe Captivate 演示”以打开 **选择 Adobe Captivate 演示对话框**。为要为演示创建的新主题指定标题、HTML 输出路径和 SWF 输出路径。

Demo

如果您跳过了指定相应的 SWF 输出路径,RoboHelp 将添加一个不可编辑的占位符 SWF 以在 **设计编辑器** 中使用。

添加和删除多媒体

RoboHelp 允许您向帮助项目添加各种多媒体内容。您可以添加在线和离线内容。根据输出和目标浏览器,RoboHelp 允许您结合 **MPEG4、QuickTime** 和 **Ogg 文件** 以及其他一系列兼容格式,例如 **Real Media** 和 **Windows Media 文件**。

添加多媒体

要添加多媒体对象,请在主题中选择要插入多媒体的位置,然后从 **“插入”选项卡的“媒体”部分** 选择“多媒体”。

选择“本地文件”以从磁盘插入多媒体,或选择“Web URL”以链接到在线多媒体文件。单击“源”字段旁边的 **浏览图标** 以浏览磁盘上的位置。如果您之前已添加文件,则可以在 **“项目文件夹”部分** 的“多媒体”部分中看到它们。

Add Multimedia

对于在线资源,输入源 URL 而不是 HTTP URL。源 URL 可以在在线多媒体内容的嵌入代码中找到,代码以“src=”开头。但是,如果您要插入 **YouTube、Vimeo** 或 **DailyMotion** 链接,则可以使用 HTTP URL。

从主题中删除多媒体

要删除多媒体对象,只需单击该对象并按键盘上的 Delete 键。

Adobe RoboHelp - 添加 DHTML 效果

**动态 HTML** 或 DHTML 用于使用 **HTML、JavaScript、CSS** 和 **DOM** 的组合创建交互式网页。使用 DHTML,可以向 HTML 页面添加通常难以实现的效果。RoboHelp 允许您向帮助项目添加 DHTML。

向主题添加 DHTML 效果

在设计编辑器中选择一个元素,然后从“插入”选项卡的“DHTML”部分单击 **效果下拉菜单** 并选择“效果”。

DHTML Effects

从“何时”列表中选择启动效果的事件,从“什么”列表中选择要应用的效果。在“设置”部分调整相关属性。DHTML 效果用浅灰色井号标记指示。

Select Event

删除 DHTML 效果

在设计编辑器中打开主题后,转到“插入”选项卡的“DHTML”部分,单击“效果”下拉菜单,然后选择 **“删除效果”**。

Remove DHTML Effects

浅灰色井号标记不再与文本或段落关联。

Adobe RoboHelp - DHTML 触发器和目标

您可以使用触发器打开 DHTML 效果。当您单击与触发器关联的文本或图像时,目标将出现。触发器和目标必须位于同一主题中。

为文本或图像分配触发器

在 **设计编辑器** 中选择文本或图像,然后从“插入”选项卡的 **DHTML 部分** 单击 **触发器下拉菜单** 并选择“触发器”。

Trigger

在应用触发器的内容上可以看到一个电缆卷轴图标。井号标记表示应用了 DHTML 效果。下一步是将触发器连接到图像或文本。

将触发器连接到文本或图像

要将触发器连接到文本或图像,请选择用作目标的文本或图像,然后从“插入”选项卡的“DHTML”部分单击“效果”下拉菜单并选择“效果”。在“何时”部分,选择 **第一次触发器激活**,在“什么”下选择用户单击触发器时发生的效果。在“设置”下设置所需的属性。对 **第二次触发器激活** 重复此操作。

将出现一个插头图标,表示它是一个目标。对于图像,您可以将电缆图标拖动到任何图像上,然后选择所需 DHTML 效果作为目标。

Connect Triggers

删除触发器

要删除 DHTML 触发器,请选择与触发器关联的项目,然后从“插入”选项卡的“DHTML”部分单击“触发器”下拉菜单并选择“删除触发器”。

Removing Triggers

Adobe RoboHelp - 跑马灯

跑马灯是移动的文本消息。

添加跑马灯

要插入跑马灯,请在主题中选择文本,然后从“插入”选项卡的 **HTML 部分** 单击 **文本框下拉菜单** 并选择 **跑马灯**。要更改跑马灯的属性,请右键单击跑马灯,然后单击 **跑马灯属性** 以更改跑马灯设置。

Marquees

单击“确定”将设置应用于跑马灯并关闭“跑马灯”对话框。

删除跑马灯

要删除跑马灯,请单击跑马灯的边界并按键盘上的 Delete 键。

Adobe RoboHelp - HTML 注释

RoboHelp 使在主题中插入 HTML 注释变得容易。

插入 HTML 注释

要插入 HTML 注释,请在 **设计编辑器** 中打开主题,并将光标放置在要插入注释的位置。从“插入”选项卡的 **HTML 部分**,单击 **文本框下拉菜单** 并选择 **注释**。

Inserting Comment

注释编辑器中以以下格式输入您的注释 - <!-- 注释 -->,然后单击确定。

Comment Editor

Adobe RoboHelp - 使用 iFrames

您可以插入内嵌框架 (iframe) 以在 HTML 页面中显示PDFURL。要插入 iframe,请在设计编辑器中打开一个主题,并将光标放置在您希望插入 iframe 的位置。在“插入”选项卡的HTML 部分中,单击文本框下拉菜单,然后选择 iframe。

Html Section

名称字段中输入名称,然后单击浏览按钮选择要链接的 URL、HTML 文件或 PDF 文件,然后单击确定。

Browse Button

您可以在边框选项卡中选择设置边框选项。

Adobe RoboHelp - 条件文本

条件文本允许您在内容中创建内容子集以适应目标受众。例如,您可以选择标记内容的某些部分,并选择通过条件构建标签在最终输出中排除它们。

创建条件构建标签

在“项目”选项卡的新建部分中,单击标签。在“新建条件构建标签”对话框中输入标签的名称。您还可以通过单击“构建标签颜色”按钮来选择标签的颜色。

Build Tag

默认情况下,RoboHelp 在所有新项目中提供两个标签 –在线打印

将条件构建标签应用于内容

打开主题列表窗格并选择一个或多个主题。在“编辑”选项卡的“标签”部分中,单击应用下拉菜单,然后单击新建/多个…

选择要应用的条件标签。应用条件标签后,内容将覆盖定义的标签颜色。

Apply Build Tag

要将标签应用于文件夹、索引和 ToC,请单击项目管理器窗格中的相应文件夹,然后在“编辑”选项卡的“标签”部分中,单击“应用”下拉菜单,然后单击“新建/多个…”。选择要应用的条件标签。

Adobe RoboHelp - 上下文相关帮助

有时,您可能需要根据用户执行的操作创建帮助文件。此类帮助称为上下文相关帮助 (CSH)。例如,当用户将鼠标悬停在对话框或其他对象上时,您可以提供帮助信息。创建 CSH 的过程涉及指定地图 ID地图文件。每当用户访问 CSH 时,帮助引擎都会接收地图编号和帮助文件名。然后,帮助引擎将地图编号与主题 ID 和 HTM 文件匹配,并显示正确的帮助主题。

RoboHelp 支持三种类型的 CSH:

  • 窗口级 - 此级别的 CSH 为窗口、对话框和其他字段提供主题。用户可以通过在应用程序中调用帮助功能或按F1来访问窗口级 CSH。

  • 字段级(这是什么?) - 当用户单击问号图标,然后单击字段或函数时,此 CSH 会描述信息。“这是什么?”主题仅受WinHelpMS HTML Help项目支持。

  • 离线帮助 - 这通常指在无法访问互联网时调用的离线帮助。使用离线帮助需要将离线帮助系统与RH_AssociateOfflineHelp程序函数关联。

Adobe RoboHelp - 管理地图 ID

在了解创建和管理地图 ID 之前,务必熟悉地图编号、地图文件和地图 ID。

  • 地图编号 - 地图编号是与主题 ID 关联的编号。地图编号和主题 ID 存储在地图文件中,在调用 CSH 时会调用这些文件。

  • 地图文件 - 地图文件包含地图编号和主题 ID。一个项目可以包含多个地图文件。地图文件的扩展名为 .h、.hh 或 .hm。

  • 地图 ID - 地图 ID 将地图编号与主题 ID 配对。

创建地图文件

地图文件可以由作者开发人员创建。打开输出设置窗格并展开上下文相关帮助文件夹。

右键单击地图文件文件夹,然后单击新建地图文件…输入新地图文件的名称,然后单击确定。

Create Map File

创建地图 ID

要创建地图 ID,我们应该按照以下步骤操作。

  • 在输出设置窗格中展开“上下文相关帮助”文件夹中的地图文件文件夹,然后双击所有地图 ID

  • 地图文件下拉菜单中,选择要存储地图文件的文件夹。

  • 然后,单击创建地图 ID编辑地图 ID按钮。

  • 主题 ID中键入一个词或短语以标识主题,并在地图编号中键入一个数字。

Create Map ID

Adobe RoboHelp - CST 的动态编辑

我们可以动态编辑与应用程序对话框关联的上下文相关帮助主题 (CST)。技术作者可以打开应用程序并动态关联帮助主题。

将应用程序对话框与主题映射

RoboHelp 使得将帮助项目与应用程序映射变得容易。打开属于需要创建 CSH 的应用程序的帮助项目。在“工具”选项卡的 CSH 部分中,单击打开 CSH 帮助,浏览到需要映射 CSH 的可执行文件的路径。然后单击“打开”按钮。

Mapping Application

启动应用程序后,选择需要CSH 映射的应用程序中的对话框,然后按 F1 或单击帮助。从 CSH 选项对话框中的项目地图文件弹出菜单中选择地图文件。

在这里,我们可以将应用程序映射到现有主题(映射到选定主题)或将其映射到新主题(映射到新主题),然后单击确定。我们还可以编辑主题内容(编辑已映射主题)或完全删除映射(删除映射)。

Adobe RoboHelp - 开发人员信息

开发人员可以使用RoboHelp API根据他们的需求创建自定义对话框。RH_ShowHelp是调用项目中帮助文件的程序函数。支持的语言包括Visual Basic、C/C++、JavaScriptJava

各个语言的文件位于安装目录\Adobe\Adobe RoboHelp (版本)\CSH API中。RoboHelp 文档列出了 RH_ShowHelp 中包含的参数。下表描述了所有这些参数:

序号 参数和说明
1

hParent

关闭调用窗口时,此参数会关闭帮助对话框。

2

a_pszHelpFile

此参数根据输出类型指定帮助源。

对于 Webhelp/FlashHelp:“项目起始页的路径”

对于 Webhelp Pro:“http://<ServerName>/roboapi.asp”

对于 HTML Help:“.CHM 文件的路径”。

3

uCommand

此参数包含以下常量:

HH_DISPLAY_INDEX - 显示索引窗格和默认主题。

HH_DISPLAY_SEARCH - 显示搜索窗格和默认主题。

HH_DISPLAY_TOC - 显示内容窗格和默认主题。

HH_HELP_CONTEXT - 打开与 dwData 参数中地图 ID 关联的主题。

4

dwData

此参数用于获取地图 ID 并导出编程语言的地图文件。在 uCommand 参数中使用 HH_HELP_CONTEXT。

有关更多信息或要进一步将 CSH 主题连接到上面列出的语言,请参阅以下链接中提供的 Adobe RoboHelp 文档 – https://helpx.adobe.com/support/robohelp.html

Adobe RoboHelp - “这是什么?”帮助

“这是什么?”帮助可用于向对话框中的控件和字段添加 CSH。对于 MS HTML Help 文件,编写器支持.exe、.dll.ocx文件。帮助文件是在Context.txt文件中创建的,然后附加到项目中。

创建“这是什么?”帮助

要创建“这是什么?”帮助文件,请展开输出设置窗格中的上下文相关帮助文件夹。右键单击“这是什么?”帮助文件文件夹,然后单击创建/导入“这是什么?”帮助文件…

在“创建/导入“这是什么?”帮助文件”对话框中,选择包含“这是什么?”帮助内容的文本文件。或者,您可以键入“这是什么?”帮助文件的名称,RoboHelp 将为您创建一个 .txt 文件。

What's This

创建新的“这是什么?”帮助文件时,您可以选择将主题 ID 与相应的地图编号链接。现在,我们应该按照以下步骤完成该过程:

  • 输入主题 ID 和相应的地图编号。
  • 在“主题文本”字段中,输入主题的内容。
  • 单击“添加/更新”以链接主题和地图编号。
  • 完成后单击“关闭”。
Help File

Adobe RoboHelp - 单一来源布局

单一来源布局 (SSL) 是项目不同输出类型的模板。例如,您可以创建一个 SSL,该 SSL 对不同类型的输出(如电子书、WebHelp、响应式 HTML5等)具有不同的设置。SSL 允许我们定义输出设置并启用批量发布。

指定主布局

主布局允许我们为我们的工作设置默认布局。然后可以为主布局指定其他选项。要指定主布局,请右键单击“输出 (SSL)”窗格中的布局,然后单击“设置为主要输出”。创建的其他窗口基于此主布局。

Primary Layout

创建 SSL

要创建 SSL,请单击“输出 (SSL)”窗格中的创建输出。您还可以通过单击“复制输出”图标来复制现有布局。

然后,在“输出名称”框中键入名称,在“输出类型”下拉菜单中选择输出类型,然后单击确定。

SSLs

Adobe RoboHelp - 生成 DUCC

动态用户中心内容 (DUCC) 帮助用户在迎合不同产品的不同类型的布局之间切换。每个布局将包含其自己的ToC、索引词汇表

DUCC 最适合与Adobe AIRWebHelp输出配合使用。例如,您可以在 Adobe AIR 布局中创建内容类别,然后可以在输出中选择这些类别。

在 Adobe AIR 布局中创建内容类别

输出 (SSL)窗格中,单击工具栏中的创建输出按钮,并将输出类型选择为 Adobe AIR。

Create Output

然后,右键单击“输出 (SSL)”窗格中的 Adobe AIR 输出,然后单击“属性”。在“内容类别”选项卡中,选择您希望用户动态更改的类别。您还可以创建、编辑、更改顺序删除现有类别

Categories

每个内容类别都有其自己的ToC、索引、浏览序列等。

为MS SharePoint生成输出

可以将原生 ASPX 或 HTML 输出直接从 RoboHelp 发布到 Microsoft SharePoint 服务器。SharePoint 充当多个 Web 应用程序和内容管理的单一资源。因此,它使用户更容易访问中小企业的集中信息。

将 ASPX 多屏幕输出发布到 MS SharePoint

多屏幕 HTML5 SSL允许将原生 (ASPX) 输出直接发布到 SharePoint 2010 库或 SharePoint 2007 文件夹。在浏览器中查看时,主题显示为单个 HTML 页面。

在“输出 (SSL)”窗格中,右键单击多屏幕 HTML5 输出,然后单击“属性”。在“多屏幕 HTML5 设置”对话框中,单击“SharePoint (原生)”并指定服务器上的 SharePoint 版本。

Multiscreen HTML5

您还可以通过单击设备配置文件名称并选择主页面类型来为每个设备配置文件创建自定义主页面。

Create Custom

将 HTML 输出发布到 MS SharePoint

类似于 ASPX 多屏幕输出,您也可以将WebHelp、FlashHelp以及Adobe AIR输出直接发布到 SharePoint。要发布 WebHelp 输出,请双击“输出(SSL)”面板中的 WebHelp 输出以打开 WebHelp 设置对话框。

然后,单击“发布”并选择要将输出发布到的 SharePoint 服务器。我们也可以通过单击新建…按钮添加新的 SharePoint 服务器。

MS SharePoint

Adobe RoboHelp - 多屏幕布局

大多数现代浏览器都可在多个平台上使用,并且经过优化,可以根据屏幕尺寸动态缩放内容。但是,这可能并不总是足够的,有时您可能需要将内容定位到特定的屏幕尺寸或外形尺寸。使用多屏幕 HTML5 SSL使我们能够针对特定屏幕尺寸优化内容,以便用户自动获得最优化的内容。

  • 您还可以将内容发布到HTTPS网站。

  • 使用多屏幕 HTML5 输出时,请确保指定默认屏幕配置文件、屏幕分辨率和浏览器代理,以确保内容在所选设备上按预期呈现。

Adobe RoboHelp 文档列出了 HTML5 输出支持的以下浏览器:

平台 支持的浏览器
Android 基于 Webkit 的浏览器 (Chrome)
iOS Apple Safari
Windows 桌面 Firefox 4+、Chrome 9+、IE9
Mac OS Apple Safari

MS HTML、JavaHelp 和 Oracle Help 布局

RoboHelp 还可以发布MS HTML、JavaHelpOracle Help布局的输出。每种布局都设计用于与其各自编程语言编写的应用程序配合使用。

Microsoft HTML Help 布局

MS HTML 项目包含主题的HTM 文件以及索引、目录、相关主题等。MS HTML 文件可以在项目的任何时间点生成。

我们还可以使用 RoboHelp 从CHM 文件中提取主题。为此,请打开“工具箱”面板并双击HTML Help Studio图标。转到“文件”菜单,然后单击“打开”以选择 CHM 文件。选择所有文件或单个文件,然后单击“提取”以提取到指定的目的地。

Help Layout

JavaHelp 布局

JavaHelp 项目包含与在各种平台上运行的 Java 应用程序配合使用的压缩输出文件。JavaHelp 也可以从现有的WinHelpHTML项目创建。RoboHelp 可以直接输出到 JavaHelp 格式,并包含超链接等 HTML 功能。

我们需要Sun Java 2 SDK(或更高版本)和JavaHelp 1.1.3(或更高版本)来创作 JavaHelp 内容。用户需要拥有Java Runtime Environment (JRE) 1.2.1(或更高版本)和 JavaHelp 1.1.3(或更高版本)才能查看JavaHelp JAR 文件。JavaHelp 不支持文本动画或特殊效果。

Oracle Help 布局

与 JavaHelp 类似,Oracle Help 项目也适用于使用 Java 或其他编程语言编写的应用程序。Oracle Help 文件存储为压缩的 JAR 文件。要创作或查看Oracle Help 文件,需要 Oracle Help 组件 3.2.2 或 4.1.2(或更高版本)、Sun Java 2 SDK(或更高版本)和 Java Runtime Environment (JRE) 1.2.1(或更高版本)。

Oracle Help 使用默认窗口显示主题。如果我们希望在自己的窗口中显示主题,请在HTML 编辑器中打开主题并编辑以下 Meta 标记:

meta name = “window-type” content = [“window name”] 

HTML Edit

EPUB 和 Kindle 电子书输出

帮助内容可以以EPUBKindle 电子书格式分发,以便可以在电子书阅读器、平板电脑和其他移动设备上阅读。

要生成电子书输出,请双击“输出(SSL)”面板中的电子书以打开电子书设置页面。在电子书格式下的“常规”页面中,选择 EPUB 3 或 Kindle 电子书或两者。

对于 EPUB 3,RoboHelp 生成.epub 文件。对于 Kindle 电子书,RoboHelp 使用 KindleGen 转换器生成Kindle 格式 8Mobi 文件。KindleGen 转换器的下载链接可在 Kindle 电子书生成对话框中找到。

EPUB 3

可以通过单击“选项”下的验证 EPUB 3 输出来验证 EPUB 输出。这需要下载 Java EpubCheck 文件,该文件可在对话框中显示的链接中找到。

EPUB Output

要向电子书添加封面图片,请单击左侧窗格中的元信息,然后在封面图片下选择要作为封面图片的图片的路径。

Meta Information

我们还可以将项目中使用的字体与 EPUB 一起嵌入,以便用户无需在其阅读器上本地安装字体。为此,请单击左侧窗格中的内容,然后勾选嵌入字体复选框。单击管理…以选择要嵌入电子书的字体。

Embed Fonts

Adobe RoboHelp - 审核与协作

RoboHelp 使项目中涉及的所有利益相关者之间的有效协作变得容易。我们将在下面查看一些审核和协作功能:

在设计编辑器中审核

我们可以在设计编辑器中直接插入评论。审核选项卡包含添加/编辑审核和跟踪更改所需的所有工具。要在设计编辑器中跟踪更改,请单击“审核”工具栏“跟踪”部分中的跟踪更改

Review Design Editor

注意 - RoboHelp 无法跟踪格式和结构更改。

创建 PDF 用于审核

您还可以创建可以发送给审核人员的 PDF。PDF 使用与 RoboHelp 项目相同的标记结构,以便我们可以直接将这些审核导入 RoboHelp。

要创建用于审核的 PDF,请在“审核”选项卡的“PDF”部分中,单击“创建 PDF”以打开“创建用于审核的 PDF”对话框。在这里,您可以选择要包含在审核中的主题,并定义条件构建标记表达式。

Create PDF

我们可以通过单击“审核”选项卡的“PDF”部分中的“导入评论”来导入已审核的 PDF。但是,要成功导入,PDF 应该是在 RoboHelp 中创建的。

PDF Section

管理评论和更改

您可以或利益相关者做出的评论可以在设计编辑器中接受或拒绝。项目中的所有评论都可以在审核面板中以列表形式查看。“审核面板”允许您筛选评论并接受/拒绝它们。每个评论也可以具有状态。

Changes

管理共享资源

通常,团队在大型项目上工作,分布在各个地方并同时工作。而内容托管在不同的服务器上,例如:

  • Dropbox
  • OneDrive
  • Google Drive
  • SharePoint 等。

RoboHelp 可以帮助您将来自云和基于文件系统的各个位置的资源添加到项目中。要添加共享位置,请在“审核”选项卡的“打开”部分中,单击“面板”,然后单击资源管理器。在“资源管理器”面板中,单击添加共享位置并指定要添加的共享位置的类型。

Resource Manager

“资源管理器”面板还允许您按类别排序资源。要添加类别,请单击添加/编辑类别图标并将相应的文 件类型添加到类别中,例如视频的.avi.flv 文件

Categories

Adobe RoboHelp - ActiveX 控件

ActiveX 控件是在 Windows 应用程序(如 Internet Explorer 和 HTML Help 查看器)中运行的小程序,用于为 HTML 页面启用附加功能。RoboHelp 附带一些可用于 HTML Help 的 ActiveX 控件。默认情况下,包括HHCTRL.OCX等 ActiveX 控件以提供目录、索引和全文搜索。

最常见的 HTML ActiveX 控件类型包括:

  • 日历控件
  • 自定义按钮
  • 横幅
  • 图表
  • 计算等。

添加 ActiveX 控件

您可能需要将位于 Adobe RoboHelp 安装的Redist 目录中的 ActiveX 控件分发给需要它们的使用者。

要插入 ActiveX 控件,请将光标放在需要控件的主题中,然后从“插入”选项卡的“HTML”部分中,单击JavaScript 下拉菜单,然后单击 ActiveX 控件。

ActiveX Control

从列表中选择所需的 ActiveX 控件,然后单击“确定”将控件添加到主题。您可以双击添加的 ActiveX 控件以查看其属性。

Properties View

注意 -并非所有 ActiveX 控件都有属性对话框。

Adobe RoboHelp - 表单和框架

RoboHelp 允许您向主题添加表单,使用者可以在其中填写信息,并创建框架和框架集以帮助导航。

向主题添加表单

要插入表单,请将光标放在需要表单的主题中,然后从“插入”选项卡的“HTML”部分中,单击 HTML 表单下拉菜单,然后单击表单。

Adding Form

占位符将插入到文本中。双击占位符以编辑表单的属性。

创建框架和框架集

框架将帮助查看器划分为每个主题的不同区域。框架集允许主题更改,同时保持某些主题静止。虽然您可以在框架集中创建多个框架,但创建过多的框架可能会使界面混乱,甚至导致加载时间增加。

在“项目管理器”选项卡中(如果需要,请单击“切换项目管理器视图”),右键单击“项目文件”文件夹,然后在“新建”菜单中单击“框架集”。

Creating Frame

从给定的选项中选择框架集模板。输入标题,然后单击“下一步”。

Frameset Template

New Frameset

框架集可以在项目管理器中的HTML 文件文件夹中看到,并且可以进行编辑。

Adobe RoboHelp - HTML Help 控件

HTML Help 控件有助于导航内容。它们是可移植的,可以复制到多个主题中。

重用 HTML Help 控件

要重用 HTML Help 控件,请在设计编辑器中打开包含该控件的主题,右键单击该控件,然后单击“复制”。将其粘贴到需要该控件的主题中。

添加 WinHelp 主题控件

要添加 WinHelp 主题控件,请选择 WinHelp 主题控件的所需位置,然后从“插入”选项卡的“HTML”部分中,单击JavaScript 下拉菜单,然后单击 WinHelp 主题。

Add Winhelp

按照向导中的提示插入 WinHelp 主题控件。

添加索引和目录控件(对于 MS HTML Help)

当项目不支持包含索引选项卡的三窗格设计时,索引控件可能很有用。要插入索引控件,请将光标放在需要索引控件的主题中,然后从“插入”选项卡的“HTML”部分中,单击JavaScript 下拉菜单,然后单击索引。

要添加目录控件,请将光标放在需要目录控件的主题中。然后从“插入”选项卡的“HTML”部分中,单击JavaScript 下拉菜单,然后单击目录。

Add Index and ToC

编译项目以测试索引和目录控件。

添加启动画面(对于 MS HTML Help)

当主题在查看器中打开时,可以显示启动画面。位图GIF图像可用于启动画面。要添加启动画面,请打开需要启动画面的主题,然后从“插入”选项卡的“HTML”部分中,单击JavaScript 下拉菜单,然后单击启动画面

Add Splash Screens

选择要用于启动画面的图像文件。您还可以通过在启动画面显示持续时间(秒)字段中设置时间量来设置启动画面的显示持续时间。

Splash Display

单击“完成”。预览主题以测试启动画面。

广告
© . All rights reserved.