я используюсфинкс а такжеRST генерировать некоторую техническую документацию в виде HTML и иметь проблемы с получением локальной ссылки PDF для работы в качестве гиперссылки. Я видел, как люди используют:download: для ссылки на локальные PDF-файлы, но я встраиваю PDF-файлы в/docs каталог для справки. Мне не нравится:download: потому что он не отображает PDF встроенный в браузере, который требует дополнительного шага от имени пользователя для потребления.

sphinx-build -b html не копирует файлы, если они не указаны вconfig.py крюкhtml_static_path или жеhtml_extra_path - и даже тогда они опускаются доroot каталог или_static папки.

Есть ли предложенный подход для встраивания связанных двоичных файлов в sphinx или это плохая практика? Часто ссылки ведут на слайд-колоду или проектные схемы, которые больше нигде не размещаются.

Образец RST для связанного PDF

.. important:: View the agile course on scrum basics

    - View `these slides to dive deeper into Agile Basics <docs/agile-101.pdf>`_.