如何防止 Sphinx 在使用容器指令时添加 "container" class?
How do I prevent Sphinx from adding the "container" class when using the container directive?
我目前正在使用 Sphinx 构建文档。我创建了一个自定义主题,使用 Bootstrap 来帮助网站的响应式设计。我想将文档中的一些元素包装在 div 中,我可以使用 Container 指令来完成。我遇到的问题是该指令不断向结果 div 添加 "container" class,这在 Bootstrap 中具有特定含义。有什么方法可以禁止将这个额外的 class 添加到标记中吗?我可以使用 Raw 指令解决这个问题,但正如文档所述,这基本上只适用于极端情况。
我最终创建了一个新的 "div" 指令,它没有添加任何未指定的 类。虽然将 类 添加到呈现的页面元素在某些情况下很有用,但我认为这应该由作者控制,而不是 Sphinx 或 docutils 做出的任意决定。我的 div directive 在 GitHub 可用。
我目前正在使用 Sphinx 构建文档。我创建了一个自定义主题,使用 Bootstrap 来帮助网站的响应式设计。我想将文档中的一些元素包装在 div 中,我可以使用 Container 指令来完成。我遇到的问题是该指令不断向结果 div 添加 "container" class,这在 Bootstrap 中具有特定含义。有什么方法可以禁止将这个额外的 class 添加到标记中吗?我可以使用 Raw 指令解决这个问题,但正如文档所述,这基本上只适用于极端情况。
我最终创建了一个新的 "div" 指令,它没有添加任何未指定的 类。虽然将 类 添加到呈现的页面元素在某些情况下很有用,但我认为这应该由作者控制,而不是 Sphinx 或 docutils 做出的任意决定。我的 div directive 在 GitHub 可用。