包括文本文件*如（Python）的獅身人面像文檔

我有一個.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中指定/鏈接那個文件？

注意是的，我知道我可以把它放在/靜態，只是用它，做，但似乎像一個總的黑客，和醜陋。

2010-05-27 Gregg Lind

正確答案是:download: role。

2010-05-28 20:12:54

如何添加下載鏈接的答案是「如何在未改變的文件中構建？」 – mabraham 2015-01-13 17:38:38

答案中的郵件列表鏈接已經失效。這是你提到的信息嗎？ https://groups.google.com/d/msg/sphinx-users/LZzb8wlAoSs/FHU1eN6RMBAJ – mzjn 2015-07-23 10:51:36

我想你可以包括外部文檔片段，如下所述：

從文本，這樣的事情應該這樣做：

.. include:: inclusion.txt 
    :literal:

2010-05-27 14:27:48 djc

並不完全符合我想要的，但我正在尋找在：原料：和其他角色。我並不是想包括一個「片段」，而是將一段時間的文件*視爲*，所以我可以鏈接到它，如果你看一下'log '_ .... – 2010-05-27 15:17:29

this確實回答了問題的標題，這暗示了完全不同的問題;-) – odony 2016-03-04 18:52:27

回答