在ReStructuredText中加粗斜体

Question

我正在使用ReStructuredText(ReST)格式编写一些文档,以便稍后使用Sphinx生成Web页面,我找不到编写一些"粗体斜体"文本的方法.

所谓的"强调"(斜体)和"强调"(粗体)文本都有标记.他们*italic text*和**bold text**分别.我还阅读了一些关于这种格式的文档,这些格式标记不能简单地"嵌套".即***text***(或** *text* **)不产生粗体斜体文本.

仍然可能有某种方式来生成一个用粗体和斜体标记强调的文本,因为通过这种方式标记文本片段是一种普遍的做法.

Answer 1

尽管Markdown支持嵌套粗体和斜体,但reStructuredText却不支持(这是Markdown功能更强大的罕见情况之一,因为无法在reStructuredText中表示粗体斜体).

罕见的情况之一,但重要的一个! (8认同)
不,这是不正确的("没有办法在reStructuredText中表示粗体斜体").实际上有几种不同的方法(正如其他受访者所指出的那样).我同意 - 尽管如此 - 不幸的是,这不是"开箱即用"支持字母两边的三重"*"... (6认同)

Answer 2

HTML输出的配方.

my.rst:

.. role:: red
  :class: red

.. role:: bolditalic
  :class: bolditalic

:red:`WARNING` :bolditalic:`Don't be stupid!`

my.css:

.red { color: red; }
.bolditalic {
  font-weight: bold;
  font-style: italic;
}

建立者:

rst2html --strip-comments --halt warning --stylesheet=my.css my.rst my.html

Answer 3

在sphinx中,这可以通过客户角色来实现:您在css中创建一个样式,并使角色指向该样式.这是带下划线的文本的完整工作示例:sphinx-dev thread.

编辑:

这是一个很好的例子:ReST strikethrough