sphinx，restructuredtext：为单个单词设置颜色-sphinx,restructuredtext:setcolorforasingleword

10  

If you want to do this without being tied to html, try applying a different style than normal body text to your word.

如果你想这样做而不依赖于html，尝试将不同于普通正文文本的样式应用到你的单词中。

In this example adapted from the rst2pdf manual, I apply the existing rubric style which is red in the backend that I am using:

在这个改编自rst2pdf手册的例子中，我应用了我正在使用的后端红色的现有量规样式：

Before red.

.. role:: rubric

I like color :rubric:`rubric`.

After red.

The actual look of the word will depend on how the style you choose is defined in the stylesheet that you use when generating your document. If you want blue text, make a blue text style and derive it from the normal text style. The stylsheet is backend-specific and you may be using the default. To print the default for rst2pdf.py, do this (from the rst2pdf manual):

该单词的实际外观取决于您在生成文档时使用的样式表中如何定义所选样式。如果您想要蓝色文本，请创建蓝色文本样式并从普通文本样式派生。样式表是特定于后端的，您可能正在使用默认值。要打印rst2pdf.py的默认值，请执行此操作（从rst2pdf手册）：

rst2pdf --print-stylesheet

Continuing the example for a rst2pdf stylesheet, add this to your stylesheet to have a blue text style:

继续使用rst2pdf样式表的示例，将其添加到样式表以使其具有蓝色文本样式：

bluetext:
  parent: bodytext
  textColor: blue

In the document you can reference this style to get a blue word. Note this bit is generic, and should make blue text if you define a blue style in your html or whatever backend's stylesheet.

在文档中，您可以引用此样式以获得蓝色单词。请注意，这个位是通用的，如果在html或后端的样式表中定义蓝色样式，则应该生成蓝色文本。

Before blue.

.. role:: bluetext

I like color :bluetext:`blue`.

After blue.

The generated pdf has the coloured words:

生成的pdf具有彩色字：

8  

On my Sphinx-powered website, I use a combination of:

在我的Sphinx驱动的网站上，我使用了以下组合：

• A restructuredText file containing roles definitions, one for each color - see .special.rst (BitBucket link)
• 包含角色定义的restructuredText文件，每种颜色一个 - 请参阅.special.rst（BitBucket链接）
• A CSS file containing color rules for each role - see the first lines of hacks.css (BitBucket link)
• 包含每个角色的颜色规则的CSS文件 - 请参阅hacks.css的第一行（BitBucket链接）

Then, in every rST file where I need colors, I first import .special.rst at the top, either manually:

然后，在我需要颜色的每个rST文件中，我首先在顶部导入.special.rst，手动：

.. include:: .special.rst

Or with the rst_epilog configuration variable in Sphinx's conf.py file:

或者使用Sphinx的conf.py文件中的rst_epilog配置变量：

rst_epilog = "\n.. include:: .special.rst\n"

And then each role can be used easily in pure rST syntax:

然后，每个角色都可以在纯rST语法中轻松使用：

This is :red:`red !` And :blue:`this part is blue`.

More details are given on this page (in French, sorry).

此页面上提供了更多详细信息（法语，抱歉）。

It works perfectly well for html output (and html-like), but not for PDF. Refer to the first answer above for producing a PDF with colors.

它非常适合html输出（和类似html），但不适用于PDF。有关生成带颜色的PDF，请参阅上面的第一个答案。

6  

This works, but leaves the HTML in a separate paragraph.

这有效，但将HTML留在单独的段落中。

.. raw:: html

    Blue word,

And a word without color

If anyone has a better answer, I will accept it.

如果有人有更好的答案，我会接受。