Sphinx：可以结合使用rst-class和.. ifconfig？

Question

我正在撰写软件文档。我使用.. rst-cass::指令将特定的css类添加到控制不同样式和功能的不同部分，这非常有效。现在，我尝试创建文档的不同版本，因此尝试将.. rst-cass::与.. ifconfig::结合使用。我的第一个文件看起来像这样：

.. ifconfig::  var==True

   .. rst-class:: html-toggle  

.. ifconfig::  var==False

   .. rst-class:: grey     

Sectiontitle
============  

当我尝试将其构建为HTML文件时，构建过程没有完成并向我展示：

  

'丢失“％s”属性：％s'％（att，self [att]）

     

AssertionError：丢失“classes”属性：['html-toggle']

有什么方法可以使用或以任何其他方式将css类分配给部分，具体取决于conf.py中的变量

提前致谢：）

Answer 1

使用自定义CSS，而不是向HTML添加类，并使用Python表达式选择要在conf.py中使用的样式表。

ifconfig is intended to＆＃34;仅当作为参数给出的Python表达式为True＆＃34;时才包含该指令的内容，而不是自定义样式。