sphinx，restructuredtext：爲單個單詞設置顏色

Question

有沒有辦法設置sphinx中的單個單詞（或字符）的顏色？我很確定應該有一些標記標記，比如HTML的font標記。

Answer 1

如果你想這樣做，而不是綁定到HTML，嘗試應用不同於正常正文文本的風格。

在這個例子改編自rst2pdf手冊，我套用現有欄目的風格是在後端紅，我現在用：

Before red. 

.. role:: rubric 

I like color :rubric:`rubric`. 

After red. 

這個詞的實際看，將取決於如何風格你選擇是在生成文檔時使用的樣式表中定義的。 如果您想要藍色文本，請製作藍色文本樣式並從普通文本樣式中派生。 樣式表是後端特定的，您可能正在使用默認值。 要打印的rst2pdf.py默認，做到這一點（從rst2pdf手動）：

rst2pdf --print-stylesheet 

持續了rst2pdf樣式表的例子，它添加到您的樣式表有一個藍色的文本樣式：

bluetext: 
    parent: bodytext 
    textColor: blue 

在文檔中，您可以引用此樣式來獲取藍色單詞。 注意這個位是通用的，如果你在html或任何後端的樣式表中定義了一個藍色樣式，它應該會變成藍色文本。

Before blue. 

.. role:: bluetext 

I like color :bluetext:`blue`. 

After blue. 

生成的PDF有彩色的話：

Answer 2

這可以工作，但將HTML留在單獨的段落中。

.. raw:: html 

    <font color="blue">Blue word,</font> 

And a word without color 

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

Answer 3

在我的獅身人面像供電website，我用的組合：一個

• 包含一個新結構化文件的角色定義，每個顏色 - 請參見.special.rst（BitBucket鏈接）
• 包含每個角色顏色規則的CSS文件 - 請參閱hacks.css的第一行（到位桶鏈接）

然後，在每一個的rST文件，我需要的顏色，我第一次在頂級進口.special.rst，手動：

.. include:: .special.rst 

或者在獅身人面像的conf.py文件rst_epilog配置變量：

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

然後每個角色都可以很容易地在純的rST語法中使用：

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

更多詳情請見this page（法語，不好意思）。

它對html輸出（和html-like）非常適用，但不適用於PDF。請參閱first answer above以生成帶有顏色的PDF。