Django中的Sphinx文档

Question

我目前正在我的Django应用程序中集成sphinx生成的文档。我希望文档扩展我的应用模板。 Sphinx生成的HTML应该如下所示

{% extends "base.html" %}
{% block content %}
...

我的狮身人面像主题模板看起来是：

{{ '{% extends "base.html" %}' }}
{{ '{% block content %}' }}
...

有更好的方法来实现这一目标吗？

Answer 1

我们使用JSONHTMLBuilder

http://sphinx.pocoo.org/builders.html#sphinx.builders.html.JSONHTMLBuilder

可以更轻松地将JSON文件的内容插入到页面中。

http://sphinx.pocoo.org/builders.html#serialization-builder-details

您阅读了JSON文档，然后将其呈现到模板中。

def someView( request, topic ):
    # use settings.SOME_DIRECTORY + path info to find the JSON file
    with something as source:
        doc= json.loads( source )
    render_to_response( 'page.template', doc )

类似的东西可以起作用。