Was ist der beste Weg, um ein PDF in meine Sphinx-Dokumentation aufzunehmen?

Question

Ich habe ein PDF, das eine ausführliche Erklärung für ein Beispiel in der Sphinx-Dokumentation für ein Paket, das ich habe, hat. Gibt es eine Möglichkeit, das PDF einfach in mein Projekt aufzunehmen (und es beim Erstellen der Dokumente kopieren zu lassen)? Ich habe versucht, mit ihm zu verbinden: doc: aber das hat es nicht kopiert.

Answer 1

Verwenden Sie die Textrolle :download:, um eine beliebige zusätzliche Datei einzufügen. In Ihrem Fall könnten Sie also so etwas tun:

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