如何在 sphinx 中添加 html 标签？

Question

在 Doxygen 中，您可以在文档字符串中添加一个 html 标签，如下所示

"""!    
x<sub>1</sub>,
"""

会生成以下

它的样式表

sub {
  vertical-align: sub;
  font-size: smaller;
}

在 Sphinx 中可以做到这一点吗？如果是这样，怎么做？ 它不需要在文档字符串中，它可以在 rst 文件中的任何位置。

到目前为止我在我的第一个文件中尝试了什么

x<sub>1</sub>,
.. x<sub>1</sub>,

没有成功

我试图逃避标签

x/<sub>1/</sub>,

再次失败

我确定我在这里遗漏了一些东西。

Answer 1

使用:subscript: role：

H\ :sub:`2`\ O

或

The chemical formula for pure water is |H2O|.

.. |H2O| replace:: H\ :sub:`2`\ O

您也可以使用:raw:，但请注意它的警告。