Vraag Hoe maak je een link naar een bestand in eerste instantie met sfinx?


Ik ben een documentatie aan het schrijven en wil graag links opnemen naar pdf-bestanden of zip-archieven. Hoe kan ik dat bereiken met de eerste taal en sfinx?

Als ik dat doe

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

Het werkt niet omdat, tijdens de compilatie, sfinx niet de inhoud van de doc-map kopieert (ik gebruik de makefile gegenereerd door sphinx-quickstart).

Integendeel, het gebruik van de image richtlijn:

.. image:: img/plop.png

sphinx kopieert de plop.png-afbeelding in de bouwdirectory. Hoe kan ik hetzelfde gedrag verkrijgen voor pdf- of zip-archieven?


22
2018-01-15 20:05


oorsprong


antwoorden:


Ik vond de oplossing op de sphinx documentatie.

Hier is een kort voorbeeld ervan uitgaande dat je een bestand hebt mypdf.pdf in een map doc. De map doc en je eerste bestand moet zich in dezelfde map bevinden:

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

Merk op dat je geen lege ruimte tussen mag plaatsen :download: en het pad naar het bestand.


36
2018-01-15 20:32