hyperlink - sesion - ¿Cómo puedo vincular a un: descargar archivo en una unidad de red en Sphinx?

no se puede conectar a unidad de red windows 10

Question

Estoy haciendo algunos documentos de proyecto para uno de nuestros productos de hardware. La documentación es para uso interno y está ubicada en una unidad de red:

//ourserver/projects/project1-doc

La forma en que actualmente hacemos control de versiones, tenemos algunas carpetas como estas:

//ourserver/projects/project1-A
//ourserver/projects/project1-B
//ourserver/projects/project1-C

Deseo poder hacer un :download: enlace de la documentación a un archivo PDF en una de esas carpetas. ¿Hay alguna manera de que pueda hacer una ruta absoluta al archivo? He intentado muchas cosas, por ejemplo:

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

pero no pude lograr que funcionara con Sphinx. ¿Cómo puedo enlazar a este archivo?

Answer 1

El documento está alojado en la red, pero ¿lo construyes a través de sphinx en la red? Al usar la descarga: directive, la esfinge copia los archivos en el directorio _build / html bajo _descargas y enlaces a ellos allí. Entonces, si construyes localmente el documento esfinge y no puede encontrar el archivo correcto para copiar y vincular durante la compilación, entonces no creará enlaces, lo mismo si la ruta es incorrecta.

De todos modos, dado que está enlazando archivos bajo control de versión, probablemente quiera crear una ruta absoluta con la directiva .. raw ::, de modo que siempre esté vinculado a la última versión.

.. 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>

Y si desea vincular al pdf y ejecutarlo con un pdf creado a través de sphinx. Podría usar una directiva .. raw :: latex.

.. raw:: latex

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

Las directivas personalizadas también podrían construirse para hacer esto más fluido.