我可以在 rst 中创建一个自定义的文字类吗？

Question

我正在用 rST/Sphinx 编写一些编码教程，我想区分输入（即：代码块）和输出（到终端）。因为输出也需要是文字的，所以我不能简单地使用自定义类或容器，因为它们仍然会被解释并且不能正确显示（见下文）。如何创建可以应用于文字块子集的类或容器或其他东西？

请注意，这不需要什么花哨的东西 - 与我的“代码块”块相比，也许只是改变我的“输出”块的背景颜色。

我试过了：

创建一个名为“终端”的自定义类，但这仍会被解释并返回有关其内容的错误：

.. container:: terminal

    -----------------------------------------------
                  MY **EXAMPLE** GOES HERE   
    -----------------------------------------------

... 产生一个解释输出，该类被正确应用，但缺少水平线，“EXAMPLE”为粗体等。

在终端容器内嵌套文字块：

::

    .. container:: terminal

        -----------------------------------------------
                    MY **EXAMPLE** GOES HERE   
        -----------------------------------------------

... 生成格式化为输入代码的文字输出：

.. container:: terminal

    -----------------------------------------------
                MY **EXAMPLE** GOES HERE
    -----------------------------------------------

反过来嵌套：

.. container:: terminal

    ::

    -----------------------------------------------
            MY **EXAMPLE** GOES HERE
    -----------------------------------------------

... 生成一个带有 terminal 格式的 div 围绕一个带有文字块的嵌套 div，它保留了标准文字格式（我想覆盖它）。

我认为一定有一些非常简单的东西我错过了，但我真的看不到它！

Answer 1

试试.. code-block:: bash，其中“bash”是您希望应用语法突出显示的语言的名称。 Available syntaxes 由 Pygments 作为“词法分析器”提供。

.. code-block:: bash

    -----------------------------------------------
                  MY **EXAMPLE** GOES HERE   
    -----------------------------------------------

如果您对 Sphinx 主题提供的语法突出显示不满意，可以使用 custom style 覆盖它。

作为可能的示例，我更改了特定选择器的样式。在主题的 CSS 中添加类似的内容。

div.highlight-text > table > tbody > tr > td.code > div > pre {
    background-color: #32cd32;
}