4

对于我们目前正在开发的 Web 应用程序，我们必须提前考虑如何将其推广到多个不同的用户组。从功能方面来看，重要的是要有一个文档系统，该系统可用于从相同的源文件生成用户指南和上下文相关的帮助。

我们计划使用 DITA 作为文档系统，现在正在考虑一种简单且可扩展的方法，让开发人员指定提供上下文相关帮助的元素，并且可以由技术作家和培训师填充。

基于 DITA，我们希望生成 PDF 格式的用户指南，并将上下文相关的帮助集成到基于 JSP 的 Web 应用程序中。你有什么建议？

我们已经在评估具有以下功能的商业应用程序

  • 用于识别网页上将填充帮助信息的元素的创作工具
  • 与学习管理系统集成
  • 支持非基于 Web 的应用程序

你有什么框架建议吗？除了上述之外，以下将是很棒的

  • 与 DITA 集成（以任何可能的方式）
  • 用户组特定内容（从 Web 应用程序检索的用户）
  • 可以在简单的 Web 应用程序中使用以显示 (html) 工具提示
  • 帮助上下文与以下层次结构的关联：应用程序 > 页面 > 元素（HTML id？）
4

1 回答 1

1

DITA 是一种文档架构，而不是一种工具。因此，它不会限制您对创作工具的选择，或者从您的 DITA 源生成 PDF 和在线帮助的选择。目前尚不清楚您想到的是哪种在线帮助，但听起来您更希望 HTML 页面可以由应用程序本身显示，而不是像 CHM 这样的三元组。

有几种工具可以从 DITA 生成输出。DITA-OT (Open Toolkit) 是 Sourceforge 上的 FOSS 工具，可以制作 XSL-FO，您可以从中生成 PDF，以及 HTML、CHM 等。然后是免费的 DITA2Go http://dita2go.com，它为 PDF 制作制作 Word RTF，以及 HTML 和多种形式的在线帮助；它使用主题 ID 属性作为 HTML 文件名的一部分（或全部，如果需要）。此外，还有一些商业程序，尽管与 DITA2Go 相比没有太多好处。

最好不要将 PDF 视为在线帮助交付格式，而应将其视为客户可以打印出来并用作硬拷贝的版本。工具提示实际上取决于您的 Web 应用程序，而不仅仅是生成帮助的工具。

于 2013-02-16T23:27:12.363 回答