Hyperlink 如何链接到Sphinx中网络驱动器上的：下载：文件？

我正在为我们的一个硬件产品制作一些项目文档。本文档仅供内部使用，位于网络驱动器上：

\\ourserver\projects\project1 doc

按照我们目前执行版本控制的方式，我们有如下一些文件夹：

\\ourserver\projects\project1-A
\\ourserver\projects\project1-B
\\ourserver\projects\project1-C

我希望能够在其中一个文件夹中创建一个从文档到pdf的

：下载：

链接。有没有什么方法可以确定文件的绝对路径？我尝试过很多东西，例如：

:download:`schematic <file://///ourserver/projects/project1-C/schematic.pdf>`
:download:`schematic //ourserver/projects/project1-C/schematic.pdf>`

：下载：`原理图`
：下载：`schematic//ourserver/projects/project1-C/schematic.pdf>`

---

但我不能让它和斯芬克斯一起工作。如何链接到此文件？

该文档位于网络上，但您是否通过网络上的sphinx构建它？使用：download:directive sphinx时，会将文件复制到_downloads下的_build/html目录，并链接到那里。因此，如果您要在本地构建sphinx文档，而它在构建过程中找不到要复制和链接的正确文件，那么它将不会创建链接，如果路径错误也是如此

无论如何，由于您正在链接到受版本控制的文件，所以您可能希望使用创建一个绝对路径。。raw:：指令，以便始终链接到最新版本

.. raw:: html

   <p><a class="reference download internal" href="/ourserver/projects/project1-C/schematic.pdf">
   <tt class="xref download docutils literal">
   Project 1-C Schematic
   </tt></a><p>

还可以构建自定义指令，使其更加流畅

.. raw:: latex

   \href{run:/ourserver/projects/project1-C/schematic.pdf}{Project 1-C Schematic}