使用 reStructuredText 添加一些带有自定义“id”和“class”属性的 HTML

Question

Answer 1

自版本 0.8 (2011-07-07) 起，您可以使用带有名称选项的容器指令：

 .. container:: test
    :name: my-id

    a paragraph

结果

  <div class="test container" id="my-id">
  a paragraph
  </div>

Answer 2

我一直在研究类似的东西，我找到了解决方案here。您需要做的就是使用自定义指令并将其添加到现有的编写器中。您只需将链接中的指令（稍加修改）添加到 rst2html.py 脚本即可。另请参阅创建指令的文档。

Answer 3

如果您发现添加的“容器”类与同名的引导类冲突（叹气），请改用这个：

.. class:: class_name

    paragraph content

Answer 4

对于那些寻找内联解决方案而不是上面基于块的解决方案的人，您可以定义一个新角色，如下所示：

.. role:: my_role
   :class: my_css_class

可以内联使用：

Some text :my_role:`some more text with my_css_class applied`.