应用CSS和角色文本块，而不是内嵌在跨度狮身人面像(Applying CSS and roles f

2019-08-01 12:03发布

有先前的问题，解释如何将色彩范围增加了一些新结构化。

回顾一下这个过程：

首先，你有作用。

.. role:: red

An example of using :red:`interpreted text`

它转换成如下。

<p>An example of using <span class="red">interpreted text</span></p>

现在，你有红色的类，你可以使用CSS改变颜色。

.red {
    color:red;
}

如何，如果你想跨多行文本，你这样做吗？例如：

.. role:: red

:red:`paragraph 1

      paragraph 2

      paragraph 3`

凡第1，2，和3都将是“红色”。如果我尝试这样做，我得到的警告信息：

警告：内联解释文字或词组的参考起始字符串没有结束串。

它不创造跨度和插入“：红：”到文本。它只是不将此解释为一个字符串（如警告提示）。

基本上，可这新结构化来完成的，如果可以，怎么样？

我使用的是狮身人面像1.1.3。

Answer 1:

有许多方法可以做到这一点，但他们中的一个是使用class指令：

.. class:: red

    This is a paragraph.

    This is another paragraph.

大多数docutils的HTML作家将它放入HTML输出作为一个阶级的HTML属性，你可以接着用CSS样式。

在狮身人面像，特别是，但是，您可能需要使用rst-class ，而不是class至少在某些情况下。请参阅： http://sphinx.pocoo.org/rest.html#id3

此外，在新结构化多块级元素采取:class:参数，它确实几乎同样的事情。

文章来源: Applying CSS and roles for text blocks instead of inline spans in Sphinx

Answer 1: