Cách tốt nhất để đưa tệp PDF vào tài liệu Sphinx của tôi là gì?

Question

Tôi có một tệp PDF có giải thích sâu về một ví dụ trong tài liệu Sphinx cho gói tôi có. Có cách nào để dễ dàng đưa PDF vào dự án của tôi (và sao chép nó khi tôi tạo tài liệu)? Tôi đã thử liên kết với nó với: doc: nhưng điều này đã không sao chép nó hơn.

Answer 1

Sử dụng vai trò văn bản :download: để mang lại tệp bổ sung tùy ý. Vì vậy, trong trường hợp của bạn, bạn có thể làm một cái gì đó như thế này:

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