在rst2html生成的HTML输出中，各级节都是类“section”，我可以配置它吗？

Question

在 rst2html 生成的 HTML 输出中，各级节都具有类“section”。我可以配置它吗？

因此，如果我想将自己的 CSS 应用到 HTML 输出，我不能对顶级部分和子部分使用不同的样式，因为它们具有相同的类名？

如果我想对不同级别的部分应用不同的样式，如何解决这个问题？

Answer 1

我通过编写自己的第一个编写器类 Inheriting docutils.writers.html4css1.Writer 解决了这个问题，并在其构造函数中，将它的 HTMLTranslator Inheriting docutils.writers.html4css1.HTMLTranslator 类的实例分配给它的translator_class 属性。

具体来说，在我的 HTMLTranslator 类中，方法 visit_section 被重写::

def visit_section(self, node):
    self.section_level += 1
    self.body.append(
        self.starttag(node, 'div', CLASS='section section%d' % self.section_level))

因此，第 2 级的部分将获得一个类 sectionsection2。

Answer 2

您可以尝试使用 class 指令。这是一个特定于 HTML 的指令，它允许为其后面的元素设置任意类。完整的描述在这里： http://docutils.sourceforge.net/docs /ref/rst/directives.html#class

这是一个示例：

Regular header
==============

.. class:: myclass

Section with a class myclass
****************************

Regular paragraph