我目前正在使用 Sphinx 构建文档。我创建了一个自定义主题,它使用 Bootstrap 来帮助网站的响应式设计。我想将文档中的一些元素包装在一个 div 中,我可以使用 Container 指令来完成。我遇到的问题是该指令不断向生成的 div 添加一个“容器”类,这在 Bootstrap 中具有特定含义。有什么方法可以禁止将这个额外的类添加到标记中吗?我可以使用 Raw 指令解决这个问题,但正如文档所述,这基本上只适用于极端情况。
最佳答案
我最终创建了一个新的“div”指令,它不添加任何未指定的类。虽然在某些情况下将类添加到呈现的页面元素很有用,但我认为这应该由作者控制,而不是 Sphinx 或 docutils 做出的任意决定。我的div directive在 GitHub 上可用。
关于twitter-bootstrap - 使用容器指令时如何防止 Sphinx 添加 "container"类?,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/34534327/