Inclure un fichier texte * est * comme dans (Python) Sphinx Docs

Question

(en utilisant l'outil de documentation Python-Sphinx)

J'ai un fichier journal .txt Je voudrais construire en _build/htmlnon modifiée. Que dois-je modifier dans conf.py, index.rst, etc.

Voici la mise en page:

src/ 
    index.rst 
    some_doc.rst 
    somefile.txt 

Comment puis-je obtenir somefile.txt dans la construction html? J'ai essayé d'ajouter une ligne comme celle à index.rst:

Contents: 

.. toctree:: 
    :maxdepth: 2 

    some_doc 
    "somefile.txt" 

espérant qu'il travaillerait par magie, mais pas de magie ici!

En supposant que cela soit encore possible, que dois-je mettre some_doc.rst pour faire référence/lier à ce fichier?

Remarque Oui, je sais que je pourrais le mettre dans /statique et juste être fait avec elle, mais qui semble comme un hack total et laid.

Answer 1

La bonne réponse est la :download: role.

Cf: Georg's answer on the Sphinx Mailing List

Answer 2

Je pense que vous pouvez inclure un fragment de document externe, tel que décrit ici:

http://docutils.sourceforge.net/docs/ref/rst/directives.html#including-an-external-document-fragment

A partir de ce texte, quelque chose comme ça devrait le faire:

.. include:: inclusion.txt 
    :literal: