Какой лучший способ включить PDF в мою документацию по Sphinx?
У меня есть PDF, в котором есть подробное объяснение для примера в документации Sphinx для пакета, который у меня есть. Есть ли способ легко включить PDF в мой проект (и скопировать его при создании документов)? Я попытался связать его с: doc: но это не копировало его.
Ответы
Ответ 1
Используйте : загрузить: текстовую роль, чтобы добавить произвольный дополнительный файл. Поэтому в вашем случае вы можете сделать что-то вроде этого:
For an in-depth explanation, please see :download:`A Detailed Example <some_extra_file.pdf>`.