使用容器指令时，如何防止 Sphinx 添加“容器”类？

Question

我目前正在使用 Sphinx 构建文档。我创建了一个自定义主题，它使用 Bootstrap 来帮助网站的响应式设计。我想将文档中的一些元素包装在一个 div 中，我可以使用 Container 指令来完成这些元素。我遇到的问题是该指令不断向生成的 div 添加一个“容器”类，该类在 Bootstrap 中具有特定含义。有什么方法可以抑制将这个额外的类添加到标记中？我可以使用 Raw 指令来解决这个问题，但正如文档所说，这基本上只适用于极端情况。

Answer 1

我最终创建了一个新的“div”指令，它不添加任何未指定的类。虽然在某些情况下将类添加到呈现的页面元素很有用，但我认为这应该由作者控制，而不是由 Sphinx 或 docutils 做出的任意决定。我的 div directive 可以在 GitHub 上找到。