Wie man ein Verzeichnis von Dateien mit RST und Sphinx einbezieht

Question

Ich versuche, Dokumentation zu schreiben und wollen und haben multiplizieren Dateien von mehreren Toc Bäumen verwendet. Zuvor habe ich eine leere Datei mit .. include:: <isonum.txt> verwendet, dies funktioniert jedoch nicht für mehrfache Dateien in einem Verzeichnis mit Unterverzeichnissen. Eine andere Lösung, die ich verwendet habe, war, einen relativen Dateipfad zu der Indexdatei zu verwenden, mit der ich verlinke. Dies vermasselt jedoch den Sphinx-Nav-Baum. Also meine Frage ist, wie man ein Verzeichnis von Dateien mit RST und Sphinx einfügt?

Answer 1

Es kann leider nicht gemacht werden.

Die toctree Richtlinie hat eine glob Option, die Sie wie so verwenden würde:

.. toctree:: 
    :glob: 

    generated/* 

Aber diese Option ist nicht verfügbar in der include Richtlinie.

Vielleicht ein Problem dafür starten?