使用sphinx创建上下文相关的html帮助

Question

我目前使用ascidoc（http://www.methods.co.nz/asciidoc/）来记录我的软件项目，因为它支持pdf和html帮助生成。我目前正在通过cygwin运行它，以便a2x工具链正常工作。这对我来说很好，但是在其他windows计算机上安装很麻烦。我一直在寻找替代方法，最近又重游了斯芬克斯。注意到它现在生成了html帮助文件，我尝试了一下，在我执行的小测试中它似乎工作得很好。在

我的问题是，有没有一种方法可以在文本中为上下文相关的帮助指定映射id，这样我的windows程序就可以调用适当的帮助api，文件就会启动并打开到所需的位置？在

在ascidoc中，我使用的是“pass:：[]”。通过使用这些构造，context.h和alias.h与其他html帮助文件（context sensitive help information）一起生成。在

Answer 1

我对AcsiiDoc了解不多，但在Sphinx中，您可以通过在需要的地方放置锚来引用任意位置。http://sphinx.pocoo.org/markup/inline.html#ref-role