基于 FrameMaker 12 和 Word 创建 HTML5 和移动应用程序

过去,只需创建一个可打印的 PDF 文档作为技术文档,并在特定应用(比如:软件文档)中创建一个在线帮助即可。由于智能手机和平板电脑市场的爆炸性发展,如今面临的一个不可回避的问题是,必须编制出适合于这类输出设备的技术文档内容。智能手机和平板电脑当然可以阅读和保存 PDF 文档,但是 PDF 格式不能根据屏幕尺寸实现自动调整,也不能自动改变布局实现更舒适的导航和阅读。同时,当前的在线帮助也有同样的要求。目前已经有一些应对这类挑战的方法,但技术文档领域的理想格式是“响应式 HTML5”。

由于技术文档的所有用户不会始终在线,所以也必须在此处进行技术干预——将 HTML5 内容下载到智能手机/平板电脑上,并将其离线保存在一个专门的 HTML5 容器内,或者建立一个可离线使用的应用程序。

点击使用 HTML5? 根据是否使用 CMS 系统,可以有很多种创建 HTML5 的方式。本研讨会主要探讨在不使用 CMS 系统的情况下基于 FrameMaker 或 Word 创建 HTML5 内容。

如果是 FrameMaker 12 以上的版本,技术文档工程师不需再购买 RoboHelp 11 等额外的在线帮助应用程序,就可从非结构化或结构化的 FrameMaker 内容中创建在线帮助。只需点击一下按钮,FrameMaker 12 即可提供一个响应式 HTML5,因此文档编制人员无需再在内容转化上花费心思。

如果采用 Word,则可以通过 RoboHelp 11 将内容转化为响应式 HTML5。这里已有几个额外选项可用,除所有在线帮助格式之外,文档编制人员还能完成对 Android 或 IOS 应用程序的编纂。

FrameMaker 生成的 HTML5——其作用原理如何? 目前有多种基于 FrameMaker 文档或书籍创建在线帮助的方式。不管是导出*.FM、XML 格式的 FrameMaker 文档、书籍或者 Dita-Map,还是在将这些格式的内容导入 RoboHelp 等在线帮助系统,或者直接用 FrameMaker 12 以上版本在没有附加程序的情况下创建在线帮助。

现在,无需任何额外加工,即可按全新格式发布文档:响应式 HTML5、EPUB、Amazon Kindle、WebHelp 和 Microsoft HTML 帮助 (chm)。可对这些输出内容的配置进行精确控制,相应对话框会提供支持。

插图 1:FrameMaker 12 中的发布选项

熟悉第 2 版以上 Cascading Style Sheets 的人员可以直接对输出内容的显示形式进行干预。如果在设计安全提示时将图形置于参考页上并且将其作为特殊段落样式上的方框显示,往往需要这一步。因为这些图形不是直接包含在文本流中,所以不能输出,但是可以将其作为表格单元中的背景图形分配在 HTML 中。如果在导出时将分别创建的段落样式名作为类标识符输出,并且可直接通过 CSS 寻址,则不会出错。

同时,输出内容还会提供一个光学编辑器,它可以简单定义 HTML5 的标志、颜色或字体等设计元素。

插图 2:输出内容的大量配置隐藏在右上边缘处一个小符号后面的“发布”对话框中。

Word 生成的 HTML5——需要哪些步骤? 如果要以 Word 文档为基础生成 HTML5 文档,则需要使用 RoboHelp 11。在将 Word 文档导入一个 RoboHelp 项目之后,将出现大量可用配置,比如:接受现有目录(比如内容、关键词、词汇表)。可以给现有段落和字符样式分配特殊功能,并将接受其中的参引和链接。 在将 Word 文档转化为 XHTML 之后,除了会得到响应式 HTML5 外,还有所有其它 RoboHelp 的输出格式(比如:Mutliscreen HTML5、Air Help 或 Eclipse 帮助)可用。

如何制作一个移动应用程序? 制作移动应用程序当然可以采用传统编程方法,但其制作成本非常高昂。另外也可以通过 RoboHelp 在集成式 Phonegap 支持功能的帮助下制作适用于 Android 和 IOS 的原生应用程序。

插图 3:RoboHelp 11 中一款 Andriod 原生应用程序的配置对话框

使用 Android SDK 或 Apache Ant 等标准和开源技术,即可顺利制作出移动应用程序。