如何在Sphinx中输出自定义静态文件？

Question

使用Sphinx，可以在构建输出的_static文件夹中包含静态文件。如何将静态文件复制到构建文件夹的根目录？

背景：我在Azure App Services中托管Sphinx项目的输出，并且由于几页中的mp4视频，我需要带有以下条目的“ web.config”文件：

<staticContent>
    <mimeMap fileExtension=".mp4" mimeType="video/mp4" />
</staticContent>

我需要Sphinx将web.config包含在构建文件夹的根目录中。

Answer 1

使用html_extra_path。这是一个配置选项，它将复制提供给html构建目录的文件列表：

html_extra_path = ['path/to/web.config']