如何强制将文件(MP4)从GitHub传输到ReadtheDocs

问题描述

我在GitHub上有一个存储库：

https://github.com/springer-math/Mathematics-of-Epidemics-on-Networks

其中有一个文件

docs/SIR_2dgrid.mp4

其中包含我希望在Readthedocs的文档中显示的动画(特别是在本页：http://epidemicsonnetworks.readthedocs.io/en/latest/Simulation_Investigation.html)此外，还有一个文件

docs/Simulation_Investigation.rst

它对该页面进行编码并尝试引用该MP4。我尝试了许多变体(尝试在https://groups.google.com/d/msg/sphinx-users/_z00m3zoRAY/Ryx4D5sxgtcJ上复制说明)，但没有成功。我让MP4出现在所需的ReadtheDocs页面上的唯一方法是在GitHub上链接到MP4(但它有一点延迟加载，而且不是很完美)。

我似乎无法让ReadtheDocs将MP4复制到我可以建立其相对链接的目录中。

有没有办法让ReadtheDocs将该文件复制到我可以链接到的位置？

或者，除了将MP4放到另一个网站上之外，还有其他方法可以在ReadtheDocs中嵌入视频吗？

推荐答案

将静态文件(.mp4)放在名为_static的子目录中。

然后在conf.py中，将html_static_path的值设置为该子目录。

html_static_path = '_static'

生成文档时将复制静态资产。

这篇关于如何强制将文件(MP4)从GitHub传输到ReadtheDocs的文章就介绍到这了，希望我们推荐的答案对大家有所帮助，也希望大家多多支持！