Come fare un collegamento a un file prima con la sfinge?

Question

Sto scrivendo una documentazione e vorrei includere collegamenti a file pdf o archivi zip. Come posso ottenerlo usando il primo linguaggio e la sfinge?

Se lo faccio

here is a pdf file : `pdf <doc/mypdf.pdf>`_ 

Non funziona perché, durante la sfinge di compilazione non copiare la contiene delle directory doc (io uso il makefile generato da sfinge-quickstart).

Al contrario, usando la direttiva image:

.. image:: img/plop.png 

sfinge non copiare l'immagine plop.png nella directory di compilazione. Come posso ottenere lo stesso comportamento per l'archivio pdf o zip?

Answer 1

Ho trovato la soluzione nella documentazione sfinge:

http://sphinx-doc.org/markup/inline.html#referencing-downloadable-files

Ecco un breve esempio supponendo che si dispone di un file in una directory mypdf.pdfdoc. La directory doc e il file prima devono essere nella stessa directory:

here is a pdf file :download:`pdf <doc/mypdf.pdf>` 

Notare che non è necessario inserire uno spazio vuoto tra :download: e il percorso del file.