¿Cuál es la mejor manera de incluir un PDF en mi documentación de Sphinx?

Question

Tengo un PDF que contiene algunas explicaciones detalladas de un ejemplo en la documentación de Sphinx para un paquete que tengo. ¿Hay alguna manera de incluir fácilmente el PDF en mi proyecto (y hacer que se copie cuando construya los documentos)? Intenté vincularlo con: doc: pero esto no lo copió.

Answer 1

Utilice la función de texto :download: para traer un archivo adicional arbitrario. Entonces, en su caso, podría hacer algo como esto:

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