Jak zrobić łącze do pliku w pierwszej kolejności z Sfinksem?

Question

Piszę dokumentację i chciałbym dołączyć linki do plików pdf lub archiwów zip. Jak mogę to osiągnąć używając pierwszego języka i sfinksa?

Gdybym zrobić

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

To nie działa, ponieważ podczas kompilacji sfinks nie kopiować materiały zawarte w katalogu doc ​​(używam makefile generowane przez Sfinks-QuickStart).

Wręcz przeciwnie, za pomocą dyrektywy image:

.. image:: img/plop.png 

sfinks nie kopiować obraz plop.png w katalogu build. Jak uzyskać to samo zachowanie dla archiwum pdf lub zip?

Answer 1

znalazłem rozwiązanie w dokumentacji Sfinks:

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

Oto krótki przykład zakładając, że masz plik mypdf.pdf w katalogu doc. Katalog doc i plik najpierw musi być w tym samym katalogu:

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

pamiętać, że nie musi umieścić spację między :download: i ścieżkę do pliku.