Документация Sphinx на Raspberry Pi не может получить доступ к HTML - PullRequest
Новая
       22

Документация Sphinx на Raspberry Pi не может получить доступ к HTML

0 голосов
/ 04 октября 2018

Я пытаюсь создать документацию Sphinx для raspberry pi, следуя этому уроку https://projects.raspberrypi.org/en/projects/documenting-your-code/7

Sphinx генерирует некоторые html-страницы, к которым я хочу иметь доступ по маршруту с домашней страницы моего приложения, как и яиспользуя Flask.

Например, это будет маршрут в app.py

@APP.route("/docs")
def docspage():
    return render_template('docs/index.html', title='Docs')

и в моем layout.html 

<a class="nav-link" href="{{ url_for('docspage') }}">Docs</a>

Проблема, с которой я сталкиваюсь,доступ к html-файлам во Flask возможен только в том случае, если они находятся в папке templates.Генерация документации с помощью sphinx создает папку с именем _build, которая не находится внутри шаблонов.

Я попытался переместить папку _build_ в templates, но это создало ряд проблем, а также не похоже наэто правильный способ сделать это, так как _build также содержит много не HTML-файлов.

Как правильно настроить маршрут для страницы документации при использовании Flask?

...