移动式在线帮助

哪些现代阅读格式和移动终端设备可为在线帮助提供支持?帮助信息如何满足互联网时代的要求?怎么做才能让帮助内容贴近社交媒体上的用户?

本文将以不断提高的用户和技术要求为背景,阐述帮助文档创作系统的最新发展;并以创作系统 Adobe RoboHelp 11(Adobe 技术通信套件 5 的一个组件)为例阐述帮助文档创作要求和解决方案。RoboHelp 在本文代表现代化创作系统,比如:Flare、Author-it 或 Help & Manual。文末提供以电子矩阵为基础对不同系统单个功能特色进行比较的链接——参见信息框“示例应用信息”。

发布移动内容

智能手机和平板电脑对用户行为产生了颠覆性影响。在全球范围内,移动终端设备上的网页访问量和应用程序使用量急剧攀升,移动式互联网访问已对台式电脑互联网访问造成了巨大冲击。

各种移动终端设备的强势增长也对单源发布 (Single-Source-Publishing) 系统提出了越来越高的要求。现在,在线帮助文档编制人员需有能力编订出适合各种媒介的在线帮助内容,同时保证时间需求不会成倍增长。

目前,除打印版本和 CHM、WebHelp 或 Adobe AIR Help 等标准格式外,移动版本也不可或缺,其中包括 HTML5、native App 或 Kindle-Format 8。尤其在移动式发布中,相应帮助文档创作系统必须满足一定的前提条件,确保用户可以在几乎所有配备触摸屏的最新移动终端设备上快速、准确地导航,并迅速找到所需信息。

尺寸调整

在我们的示例应用中,HTML5 格式是发布不同格式信息的数据基础。在响应式 HTML5 发布 (Responsive HTML5-Publishing) 过程中,可按照单源和多源发布原理输出在线帮助内容的各种移动式版本。届时将生成不同的响应式 HTML5 布局,可分别通过布局编辑器对其进行调整。

边框调整

屏幕的多样性(也包含平板电脑和智能手机的显示屏)也对在线帮助提出了要求。为了在可能的显示设备上始终以方便读者的最佳方式显示内容,我们的示例软件 RoboHelp 将以不同指标为基础进行展示。应用于移动领域的内容发布,应仅规定屏幕尺寸和布局,让发布工作流程具有更多的回旋空间。之前用于台式机和网页的导航、内容和符号工具栏帮助窗口以边框为基础,由三部分组成,目前已不适用于移动领域。因为移动领域更需要的是无框显示,使文本内容可以自由滑动。

具体而言,在示例应用中,可通过响应式设计激活以下选项:

  • 将带自动尺寸调整功能的弹出窗口或纯文本转换为超链接
  • 将图像和表格的绝对尺寸转换为相对尺寸
  • 激活搭载有 iOS 的苹果设备的屏幕缩放功能
  • 在 iOS 设备上用 Adobe Captivate HTML5 文件替代不兼容的 SWF 内容 (Flash)。

在 RoboHelp 中,编制人员可在适用于台式机、iPhone、iPad、Android 平板电脑或 Kindle Fire 的各种直接可用的布局中进行选择。编制人员也可以挑选个性化布局,并指定特定的屏幕配置文件,还可在各个布局中编辑主题风格、内容和搜索功能。插图 1 给出了各种布局的概览,布局中的各个组成部分都可以进行进一步的全面调整。

插图 1:响应式布局
来源:www.grainge.orga

确保正确视图 为确保布局能够满足各种终端设备的要求,调整完成后,应进行预览,并检查效果。在编制阶段就应该将布局设置指定给一个屏幕配置文件,使内容根据设备情况显示在输出预览中,比如通过 RoboHelp 中的多屏进行预览。

将内容以 ePUB 3、Kindle-Format 8 (KF8) 和 MOBI 格式显示在电子书阅读设备上,意味着一个特殊要求——所有创作系统必须至少提供这些格式。如果使用 RoboHelp,其程序不仅可满足这一要求,还能提供其它格式:Barnes、索尼阅读器和适用于移动终端设备通用阅读器应用程序的各种格式(Adobe Digital Editions、Calibre、Aldiko 和 iBooks)。

用户参与

现在,用户行为已发生巨大变化。不仅需要编辑团队内部合作,用户方与编辑团队质检也需进行合作。目前,用户在社交媒体上积极密切互动,并且已经习惯通过论坛和反馈功能发布评论。因此,用户要求内容不再只是编制人员的单向展示,而是提供者与用户之间的双向交流。

使用社交媒体与用户建立反馈联系,并在用户之间建立反馈联系,对于创建以客户为导向的电子文档具有极大帮助。出于这个目的,RoboHelp 允许集成适用于社交媒体和 Web 2.0 互动的微件。具体而言,即可在帮助项目内的主页上嵌入 Google Analytics、Facebook、Twitter、LinkedIn 和其它社交微件。

查找信息

用户导向性的另一角度是打造用户搜索的对应内容。通过基于浏览器的帮助格式,用户有机会使用各种各样的搜索引擎。因此,他们可以使用自己所熟悉的各种搜索引擎选项。

我们的示例应用通过可灵活搜索的、基于 HTML5 的内容为用户搜索行为提供支持。帮助系统的每个页面都将被分配给一个自己的 URL,以便在互联网上进行索引。还可以为每个元数据指定主题关键词、同义词和字表,使搜索结果与上下文更好地匹配。此外,条件标签(即所谓的 Conditional Build Tags)也可应用于外部搜索内容上。例如,“AIR 帮助”是一款促进用户交流的应用,用于帮助项目时也是如此。另外还有 0 至 5 星主题评价、评论、表决和独立生成相关内容等扩展功能。

追踪使用

基于服务器提供在线帮助有助于系统化追踪和评估用户行为。软件 RoboHelp 服务器 9 搭配 RoboHelp 使用,构成一种基于服务器的帮助解决方案。应用程序通过帮助主题搜索和记录与用户搜索查询和导航相关的数据。此外,RoboHelp 服务器 9 可提供以下可个性化定制的反馈报告:

  • 最常见搜索词报告——此报告显示搜索趋势以及用户在哪些产品领域遇到问题
  • 无果搜索词报告——可依据此报告确定日后输入帮助系统的同义词或停止词
  • 最常用主题报告——可甄别出有明显问题的产品主题,或者新功能介绍主题
  • 特定时段统计报告——帮助内容的常规使用、页面常规访问以及浏览器和操作系统的使用
  • 以语境敏感主题为焦点的报告——此报告揭示用户界面上存在问题的区域

规范合作

使用在线帮助文档创作系统,不仅可以编制软件和应用程序的互动式帮助系统,也可以编制其它文档类型。在线指令、联网知识数据库、公司内部信息以及培训材料只是可按单源原理同源生成的文档类型的几个例子。

在典型情况下,需由若干编制人员和信息架构人员共同创作这些不同的文档类型。原型最终用户(即:Beta 测试人员)应及早参与开发,并向其征集反馈意见。通过敏捷产品开发,部分帮助文档编制人员从一开始就已参与到开发过程中。他们必须在更短的周期内撰写、检查和发布技术文档或技术文档组成部分。组织结构的扩展要求创作系统为多名团队成员之间的合作提供支持,并根据其在公司内部或开发团队中所扮演的不同角色对工具进行调整。

此外,为了编制人员和专家之间的使用和协调,还可跨项目共享主题。随后的同步功能可确保随时更新主题,也可跨人员将共享主题汇总在不同项目之中。共同主题的关联性需接受 RoboHelp 的自动检查,比如消除共享主题中的交叉引用。

合作系统

大部分创作系统都允许分布在不同地方的编制人员和审查人员以不同方式进行合作。可选技术如 Microsoft SharePoint、云存储或网络共享在其中扮演着重要角色。比如可以通过软件 Microsoft SharePoint 控制跨用户和跨项目的资源管理。在 RoboHelp 中,比如可以通过 SharePoint 文档库访问公司帮助项目的源文件,可以通过组合 SharePoint 用户界面功能和 RoboHelp 主题直接将单个连续的 HTML 页面发布在 SharePoint 中。

此外,RoboHelp 可通过 Dropbox, Google Drive 和 SkyDrive 云共享为资源和主题共享提供支持。比如,可在资源管理器中创建一个 Dropbox 文件夹(参见插图 02),点击源文件和帮助主题,并将其拉入该文件夹,即可将源文件和帮助主题存入其中,以便其它团队成员查看。

插图 2:带 Dropbox 和 Google Drive 的资源管理器
来源:www.grainge.org

保障质量

无论在何种形式的合作中,检查帮助主题具有重大意义。我们的示例软件除具有上述功能之外,还能以 PDF 为基础进行检查。按内容目录进行主题筛选后,将内容以 PDF 文件格式输出,由审查人员进行评论,并跟踪变更内容。在内容方面,除可扩展文本之外,还需添加动态 HTML 内容。

坚持所选道路

无论当前帮助文档创作系统相对于之前版本是否存在显著变化,必须继续推进所选道路。这些全新模式的典型特征包括,具备高新科技优势、提供新型格式、推动互联网和社交媒体使用继续增长并扩大移动终端设备的使用范围。帮助系统必须更多地考虑开发团队合作及用户互动。

相关帮助文档编制人员应有能力发现编制人员与用户双向交流中的潜力,并使其在可控的工作流程中变为现实。编制人员需为用户提供易于阅读、可灵活搜索并能与他人互动的出色的帮助信息。有关 RoboHelp 11 的产品信息: