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

Question

使用 rsStructuredText 生成 HTML，我试图包装一个

带有额外 div 元素的段落。必须包含带有我分配的值的“id”属性。此外，该

必须具有“可编辑”值的“类”属性。

这是我到目前为止所拥有的：

.. raw:: html 

   <div id="an_identifier">

.. class:: editable                                                                 

   paragraph content

.. raw:: html

   </div>

这是输出：

<div id="an_identifier">
    <p class="editable">paragraph content</p>
</div>

我已经得到了我想要的结果，虽然我不喜欢嵌入原始 HTML。我的问题是reStructuredText 中是否有任何指令或其他方法可以不显眼地实现相同的结果？

Answer 1

Since release 0.8 (2011-07-07), you can use the container directive with a name option:

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

    a paragraph

results in

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

Answer 2

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

Answer 3

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

.. class:: class_name

    paragraph content