55

我正在使用 ReStructuredText (ReST) 格式编写一些文档，以便稍后使用 Sphinx 生成网页，但我找不到编写一些“粗斜体”文本的方法。

所谓的“强调”（斜体）和“强调”（粗体）文本都有标记。它们分别是*italic text*和**bold text**。我还在一些关于这种格式的文档中读到，这些格式标记不能简单地“嵌套”。即***text***(or ** *text* **) 不会产生粗斜体文本。

仍然可能应该有某种方法来生成用粗体和斜体标记强调的文本，因为以这种方式标记文本片段是一种普遍的做法。

4

3 回答 3

35

尽管 Markdown 支持嵌套粗体和斜体，但 reStructuredText 不支持（这是 Markdown 更强大的罕见情况之一，因为无法在 reStructuredText 中表示粗斜体）。

https://gist.github.com/1855764

于 2012-08-16T10:02:04.023 回答
19

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
于 2014-04-05T19:42:59.027 回答
14

在 sphinx 中，这可以通过自定义角色实现：您在 css 中创建一个样式，并创建一个指向该样式的角色。这是下划线文本的完整工作示例：sphinx-dev thread。

编辑：

这是一个很好的例子：ReST 删除线

编辑 2：

该 sphinx-dev 链接不再可用，所以这是要点，它与上面的删除线链接非常相​​似：

CSS：

span.underlined {
  text-decoration: underline;
}

在 RST 中注册角色：

.. role:: underlined
   :class: underlined

以后用它作为

:underlined:`test`

所有这些都可以在一个 RST 文档中：

.. raw:: html

   <style type="text/css">
     span.underlined {
       text-decoration: underline;
     }
   </style>

.. role:: underlined
   :class: underlined

:underlined:`test`

用:: 测试它

rst2html5.py test01.rst test01.html
于 2012-10-10T08:44:05.980 回答