python - 在(Python)Sphinx Docs中包含文本文件*

（使用python sphinx文档工具）
我有一个.txt日志文件，我想将其内置到_build/html中而不进行更改。我需要在conf.py、index.rst等中更改什么。
布局如下：

src/
    index.rst
    some_doc.rst
    somefile.txt

如何将somefile.txt引入HTML构建中？我试着加一条这样的线
至index.rst：

Contents:

.. toctree::
   :maxdepth: 2

   some_doc
   "somefile.txt"

希望它能通过魔法来运作，但这里没有魔法！
假设这是可能的，我会在some_doc.rst中放些什么来引用/链接
到那个文件？
注：是的，我知道我可以把它放进/静态的，然后就这样做了，
但这似乎是一个完全的黑客，丑陋。

最佳答案

我认为您可以包括一个外部文档片段，如下所述：
http://docutils.sourceforge.net/docs/ref/rst/directives.html#including-an-external-document-fragment
从文本来看，类似这样的事情应该可以做到：

.. include:: inclusion.txt
   :literal:

关于python - 在(Python)Sphinx Docs中包含文本文件*，我们在Stack Overflow上找到一个类似的问题：https://stackoverflow.com/questions/2921724/