如何在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']