第一个大胆的代码

Question

如何获得第一个粗体的代码（等宽字体）文本（我使用Sphinx）？ ::中的任何内容似乎都是字面上呈现的，就像``，所以``** bold **``不起作用。

Answer 1

通常，嵌套内联标记为not possible in reStructuredText。有或多或少的丑陋变通方法，例如使用raw HTML。像这样：

.. raw:: html

   <div>Some stuff <pre>some <b>bold</b> text</pre>...</div>

Answer 2

实际上使用raw代码是一件非常糟糕的事情，因为它忽略了美丽的Pygments突出显示并使事情变得极端。首先要做的是使用不同的Pygments突出显示样式。您可以找到功能演示here。然后，您可以在conf.py中设置适当的突出显示。如果所有样式都没有使代码的所需部分变为粗体，您可以考虑创建自己的Pygments主题，这对我来说是一个不熟悉的领域，但不应该那么难。

尝试第三件事，你可以查找需要突出显示的单词的类，并为CSS添加规则。对于每种类型的突出显示的单词，Pygments会产生像nv，ls等看似乱码的类。但请记住，此类型的每个实例都将突出显示。如果您选择的单词是类定义 - 将突​​出显示所有类定义。

只有当这些选项都不适用时，你才会考虑使用像raw那样残酷的东西，因为每次有人使用raw时，Sphinx就会死一点。你真的想要狮身人面像死吗？

Answer 3

很可能重组文本不支持您要求的格式化选项。

但是，您可以自由添加自己的::告诫指令，这些指令在其上具有自定义CSS样式。

自定义块和CSS样式的示例。 RST：

 .. admonition:: foobar

         My custom text here

CSS：

.admonition-foobar {
   font-weight: bold;
}