¿Cómo se sirve el activo estático sin image de un sitio de readthedocs?

Tengo una carpeta de assets en mi carpeta de docs que contiene imágenes y ejemplos de files de input asociados con la documentation de mi proyecto.

Las imágenes se incrustan correctamente en mi documentation, pero todos los enlaces a los files de input de muestra (files estáticos que son inputs a los files binarys de mi proyecto) están 404ed.

Por ejemplo, aquí podría estar el text con formatting reSt en mi documentation:

 Open this `example`_ input file to see the following result: .. image:: ../../assets/foo.png .. _example: ../../assets/bar.tgz 

La image foo.png se representa correctamente. El enlace al tarball vinculado desde _example conduce a una página 404.

Ambos files foo.png y bar.tgz están en la distribución maestra de github y están en la ruta especificada.

He intentado make html , impulsar cambios a través de git y rebuild documentos.

¿Cómo podría solucionar esto, para que la documentation funcione con los activos que forman parte de la distribución de Github? (Supongo que debería evitar enlazar con una dirección raw github, debido a las versiones).

Leer los documentos no sirve files arbitrarios de su repository; solo sirve para los resultados del process de compilation de Sphinx. Entonces, en lugar de vincular a los files como en su ejemplo, use la function :download: role. El rol le dice a Sphinx que incluya los files adicionales en un directory en la salida de compilation.

Por lo tanto, su ejemplo modificado para usar :download: podría verse más o less así:

 Open this :download:`example <../path/to/bar.tgz>` input file to see the following result: 

Tenga en count que la ruta del file es relativa al file reStructunetworkingText donde aparece el rol, no el resultado HTML.