Qual è il modo migliore per includere un PDF nella mia documentazione Sphinx?

Question

Ho un PDF che ha una spiegazione approfondita per un esempio nella documentazione di Sphinx per un pacchetto che ho. C'è un modo per includere facilmente il PDF nel mio progetto (e copiarlo quando creo i documenti)? Ho provato a collegarlo ad: doc: ma questo non è stato copiato.

Answer 1

Utilizzare il ruolo di testo :download: per inserire un file aggiuntivo arbitrario. Quindi nel tuo caso potresti fare qualcosa del genere:

For an in-depth explanation, please see :download:`A Detailed Example <some_extra_file.pdf>`.