非 Java DocBook WebHelp 输出答案

【问题标题】：Non-Java DocBook WebHelp output非 Java DocBook WebHelp 输出
【发布时间】：2009-02-13 11:14:50
【问题描述】：

有没有人设法将 DocBook 内容输出到不使用 java 小程序的 webhelp 中？我们目前正在设计一个使用 Ext JS 的 Web 应用程序，并希望将 DocBook XML 内容输出为可以与我们的应用程序并行使用的格式（即没有 Java 小程序）。

我们的管理层希望我们坚持使用 DocBook，但我们需要一个独立于平台的集成帮助输出（不是 .chm），它可以与我们的 web 应用程序集成。

任何建议、建议和意见将不胜感激。

劳里。

【问题讨论】：

标签： extjs docbook

【解决方案1】：

我在一年多后才回答这个问题，但有些人可能会觉得这很有用。

在 Google Summer of Code 计划下，我们为 DocBook 创建了 WebHelp 输出格式。它不依赖于 java-applet 也不依赖于基于框架集的方法。它是纯 css，基于 JavaScript，因此很可能满足您的要求。这对搜索引擎更友好，因为它不依赖于框架集。从 1.76.0 版开始，DocBook XSL 提供此功能。

以下链接会给你一个想法。

演示可在此处获得：http://snapshots.docbook.org/xsl/webhelp/docs/content/ch01.html WebHelp 的文档包含在演示中。

1.76.1 的发行说明位于：DocBook WebHelp Project

SVN 位置：http://docbook.svn.sourceforge.net/viewvc/docbook/trunk/xsl/webhelp/

提案地址：Proposal for WebHelp output for DocBook。

抱歉，没有。的链接。如果您需要进一步的帮助，请通过 DocBook 邮件列表联系我们。这正在积极维护中。

【讨论】：

WebHelp 有点令人沮丧。 o链接和目录已损坏，因此需要您自己修复它们。自定义 XSL 经常会中断搜索，使其无法正常工作。事实上，它是一个非常早期的测试版......

【解决方案2】：

Adobe RoboHelp 使用框架集来呈现网络帮助。自定义 CSS 本身是一个巨大的痛苦。再加上无响应的 Adobe 支持。此外，您的 Web 帮助网站的整体外观和感觉都非常 1990 年代。

【讨论】：

【解决方案3】：

你看过Adobe RoboHelp吗？相当肯定它独立于平台。

【讨论】：

【解决方案4】：

很高兴我们改用 Docbook。我们现在使用的是 David Crammer 和 KasunBG 开发的 DocBook WebHelp 项目。

这解决了我们所有的 techpubs 问题。

我们的文档现在与 git 中的源代码相关联
开发团队可以向文档提出补丁
我们现在可以使用持续集成自动生成文档
更不用说网站的外观了。
我们的多格式和多设备发布问题得到解决！

【讨论】：