Question

（使用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中引用/链接到那个文件？

注意是的，我知道我可以将它放在 / static 中，只需完成它，但这似乎完全是黑客，而且丑陋。

Answer 1

我认为你可以包含一个外部文档片段，如下所述：

从那篇文章中可以看出这样的事情：

.. include:: inclusion.txt
   :literal:

Answer 2

正确答案是:download: role。