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

Question

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

背景:我在中托管了一个狮身人面像项目的输出，由于几页的mp4视频，我需要一个包含以下条目的"web.config“文件：

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

我需要狮身人面像将web.config包含在构建文件夹的根目录中。

Answer 1

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

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