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

Question

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

背景：我在 Azure 应用服务中托管 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']