编辑:一些澄清:
- 我们已经使用“帮助”和“手册”作为帮助文件
- 真正的问题是,用什么才能让我们能够从帮助文件到演示文稿建立超链接,并返回,并且仍然使演示文稿“易于呈现”。
我将首先研究有关将 PowerPoint 文件转换为 HTML 的答案,看看这是否适合我们。很有可能。
我很抱歉问题太长,并且我将其标记为主观,因为可能没有单一的答案。
我们正在重新评估我们用来为最终用户提供各种信息源的工具。
以下是我们目前得到的信息:
- 包含有关我们产品帮助的 CHM 文件(或用于网络共享的一堆 .html 文件)
- 带有演示文稿的 PowerPoint 文件,用于使用我们产品的研讨会和课堂上
- Html 文件和类似电子学习工具
- 一个 Word 文件,其中包含我们从一个主要版本到下一个主要版本所做的所有技术变更、产品变更、错误修复等
我们发现,将所有内容整合到一个产品中将会带来巨大的益处。
我的问题是:有人遇到过这种情况吗?你是怎么做的?你看过哪些工具?你找到好用的工具了吗?你现在在做什么?我们将所有内容集成到一个系统中时遇到的主要问题是 PowerPoint 部分(即在投影仪上放一张包含关键字的幻灯片,然后从一张幻灯片移动到另一张幻灯片)会出现问题,除非集成系统具有某种易于导航的“投影仪模式”,而纯 html 页面则没有这种功能,除非在编码时考虑到了这一点。
不管怎样,好处是...
首先,我们可以提供从一个“系统”到另一个“系统”的稳定超链接,这样演示文稿就可以包含指向帮助文件相关部分的链接。用户在离开我们的课堂时会获得自己的演示文稿文件副本,这样他们就可以在回到自己的工作场所时打开并使用它们,因此,让他们能够轻松找到相关材料,而无需依赖他们或他们的 IT 人员在将文件放到他们的机器上时 100% 正确地完成所有工作,这将是一件好事。
在我们当前的设置下,PowerPoint 文件中的超链接具有指向帮助文件相应部分的相对地址,并且如果用户没有在本地以相同的方式组织 PowerPoint 和 .HTML 文件(例如,目录被重命名、所有内容都在一个文件夹中等),那么即使文件在那里,链接也不起作用。
对于我们使用的帮助文件帮助和手册,我们正在考虑将该产品的大多数功能标准化。电子学习部分由另一家公司维护,因此我们不确定现在是否要将其纳入其中。
我们认为,通过将变更日志+技术信息、帮助文件和类文档集成到一个系统中,我们可以获得以下好处:
- 稳定的超链接,有效。所有系统之间不再需要“确保 PowerPoint 文件和 html 帮助文件以这种精确方式位于本地磁盘上”。
- 一个目录和一个索引,将所有系统整合在一起(对于用户来说,帮助文件似乎包含更多信息)
- 各种输出:我们可以从同一源项目生成单个 .CHM 文件、一组 html 文件、一个 word 文件、一个 pdf 文件,所有这些文件都带有可点击、有效的超链接以及用于查找相关材料的各种其他附加功能。无需从一个系统剪切粘贴到另一个系统。
- 我们可以将所有内容集成到我们产品的帮助系统中。当用户点击我们产品中表单上的帮助按钮时,他们不仅可以看到直接的帮助文件,还可以找到用于教授这些内容的课堂演示文稿,以及 IT 人员可以用来排除故障或配置的技术信息链接。
- 在我们这里,多个人可以同时处理同一份材料。如果同时使用 PowerPoint 和 Word 文件,它们在繁忙时期很快就会成为瓶颈,而帮助和手册可让多个人同时处理同一个项目。
- 重复使用为一个“系统”生成的资产、图像和截图可以在另一个系统上重复使用,而无需重复,更新一个(当新的主要版本更改布局、颜色等时),我们会更新所有
我们失去了什么:
- PowerPoint 演示模式。我们想知道的一件事是实际课程的举办,因为演示者现在有一个 html 文件,并且必须确保将鼠标指向“下一页”按钮(帮助和手册添加的按钮),而不是能够使用其中一个点击器设备快速转到下一张和上一张幻灯片。此外,幻灯片上没有“一次一个关键字”的效果。
那么,有什么想法吗?
答案1
您是否考虑过将 Powerpoint 演示文稿转换为 HTML 并将其与 HTML 帮助捆绑在其自己的部分中?(例如“演示文稿”)。有各种工具可以批量执行此操作,甚至免费。
我们将所有内容集成到一个系统中时遇到的主要问题是 PowerPoint 部分(即在投影仪上放一张包含关键词的幻灯片,然后在幻灯片之间移动)会出现问题,除非集成系统具有某种“投影仪模式”具有轻松导航的功能,这是纯 html 页面所不具备的,除非在编码时考虑到了这一点。
使用 CHM,您可以轻松地在每个页面上放置相同的导航,如下图所示的导航按钮:
在课堂上做演示时,使用 PPT 文件进行全屏显示。当学生需要引用时,所有内容都在一个简单的 CHM 文件中。无需额外下载或安装,CHM 查看器应该可以在他们的 Windows 环境中使用。如果您想引用演示文稿中的某个部分,可以轻松超链接到 CHM 中的其他页面。学生可以使用 CHM 查看器中的后退按钮返回到单击超链接之前的位置。
答案2
听起来像是这样的工作SharePoint。我自己对此只有有限的经验,但它似乎可以做你需要它做的所有事情。
但请注意,只有 Microsoft Office SharePoint Server (MOSS) 才具备完整功能,而基本的 Windows SharePoint Services (WSS) 设置可能会让您意犹未尽。关键是?WSS 是免费的,而 MOSS 却不是!
有开源替代方案,但我会让其他人提出具体的软件包,因为我对它们不太熟悉。
答案3
抱歉,如果我没有明白你到底想要什么,但我想我可能已经明白了——
就我个人而言,我销售的两款产品需要大量的文档。我的做法与微软分发帮助文件的做法类似。
一张 CD 囊括所有内容 -
一个自动运行文件,启动 CD 上的网页,它具有良好的布局和目录结构。
你可以有 /lectures、/documents、/help 等或 /topic1/lectures/ 等
您可以在 /resources/pictures 中共享资源(例如图像)
... 然后,您可以在培训结束时轻松地向每个人分发一张磁盘,并将其包含在您的产品中。提供新版本很容易……并且在任何时候,您都可以将磁盘的根目录复制到网站,然后整个磁盘都可以在线使用!(只需使用相对路径而不是直接路径)。
这些年来我用过很多内容管理系统,但我真的认为自己做并使用上述方法是最好的。
我通过使用诸如快闪纸并提供该文档的链接。
无论如何,希望您喜欢并随时提问。
答案4
我用氧合剂完成您所描述的所有任务,除了 Powerpoint 演示文稿。Doxygen 听起来,在高层次上类似于“帮助和手册”,是跨平台的,并且可配置性很高。如果您熟悉 javadoc 或类似的“基于标签”的文档系统,那么您已经成功了一半。它创建高度超链接的图形文档。它是为 API 参考手册设计的,但我已经“滥用”它来生成您能想到的几乎所有文档类型。
不确定您记录的是什么语言,但 doxygen 支持许多语言,您可以过滤不支持的语言以生成所需的输出。例如,尽管没有得到官方支持,但我经常使用 doxygen 来记录我的 VB 代码。我经常直接从我的源代码生成包含代码类和协作图以及用户定义图的 chm 文件。我通常制作 HTML,但也制作 PDF 和 RTF。它们具有您在 HTML 文档中找到的所有超链接。
Doxygen 会自动从软件结构中获取大量链接。我发现的主要缺点是,如果您不喜欢 doxygen 默认提供的外观,则必须编写自己的级联样式表。我从来没有这样做过,所以坦率地说,我不知道 doxygen 生成的 HTML 中可能有多少样式是硬编码的。
看起来帮助和手册使用 XML 作为其文件格式。doxygen 可以生成 XML。xml 样式表允许您将一种格式转换为另一种格式。您必须自己编写它,但您将拥有所有文档之间的所有链接。
对我来说,使用 doxygen 的主要优势之一与其生成文档的能力无关。它允许我处理全部我的文档一模一样作为我的源代码。它在同一个存储库中,我可以查看和管理差异,并且可以将文档与代码一起标记/分支。对我来说,这很重要。