获取Sphinx扩展中的源.rst文件路径

Question

我正在编写Sphinx扩展，我需要知道当前页面的.rst源文件位置，以提取它的某些版本控制系统信息。如何在我的事件处理程序/我应该使用哪个事件处理程序中获取此信息？

示例：

def on_html_page_context(app, pagename, templatename, context, doctree):
    if doctree:
        print doctree.source

def setup(app):
    app.require_sphinx('1.0')
    app.connect('html-page-context', on_html_page_context) 

Answer 1

可以通过对示例中的事件处理程序进行一些小改动来完成：

def on_html_page_context(app, pagename, templatename, context, doctree):
    if doctree:
        print doctree.attributes['source'] # Path to .rst file

def setup(app):
    app.connect('html-page-context', on_html_page_context)