Документация Сфинкса в Джанго

Question

В настоящее время я интегрирую сгенерированную sphinx документацию в мое приложение Django. Я хочу, чтобы документация расширяла мои шаблоны приложений. HTML-код, сгенерированный Sphinx, должен выглядеть следующим образом

{% 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 )

Нечто подобное может работать.