python - 在 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)