4

我目前使用AsciiDoc来记录我的软件项目，因为它支持 PDF 和 HTML 帮助生成。我目前正在通过 Cygwin 运行它，以便a2x 工具链正常运行。这对我来说效果很好，但在其他 Windows 计算机上设置很痛苦。我一直在寻找替代方法，最近重新访问了 Sphinx。注意到它现在会生成 HTML 帮助文件，我试了一下，它似乎在我执行的小测试中运行良好。

我的问题是，有没有办法在文本中为上下文相关帮助指定地图 ID，以便我的 Windows 程序可以调用正确的帮助 API 并启动文件并将其打开到所需位置？

在我使用的 AsciiDoc 中pass::[<?dbhh topicname="_about" topicid="801"?>]。通过使用这些结构 acontext.h和alias.h与其他 HTML 帮助文件（上下文相关帮助信息）一起生成。

4

1 回答 1

2

I do not know about AcsiiDoc much, but in Sphinx you can reference arbitrary locations by placing anchors where you need them. See :ref: role.

于 2010-04-23T17:44:07.343 回答