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

【问题标题】：How to output a custom static file in Sphinx?如何在 Sphinx 中输出自定义静态文件？
【发布时间】：2018-11-13 13:47:31
【问题描述】：

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

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

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

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

【问题讨论】：

【解决方案1】：

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

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

【讨论】：