我为使用 Sphinx 编写的应用程序的用户提供了文档。到目前为止,文档都是用户可以访问的静态 HTML 页面。
我想在应用程序和文档之间创建链接。当然,我可以使用脆弱的
<a href="..">
链接来做到这一点,但我想使用 reverse()
从 Sphinx 链接到视图,并使用 sphinx 引用从应用程序链接到文档。
如果有更好的方法我可以替换sphinx。但我想将文档保留在文件系统(而不是数据库)的修订控制中。
有什么提示吗?
查看 readthedocs.org。您可以让他们托管您的文档,也可以从 GitHub 下载他们的应用程序并将其集成到您的应用程序中。 (https://github.com/rtfd/readthedocs.org)