我如何在python-sphinx中突出显示文本？

Question

我正在寻找一种在python sphinx中突出显示文本的方法。我看过有关如何更改单个单词的字体颜色的文档，但是我想更改单个单词的背景颜色。

Answer 1

Sphinx 已支持突出显示的文本，其中s5defs.txt s5defs.txt用于standard definition file（但缺少CSS文件）：

1. 创建/将此文本附加到inclusion的值sphinx配置，在您的rst_epilog文件中：

   rst_epilog

2. 跟随docs/conf.py使用您喜欢的outline添加CSS：

   • 将css文件放入例如

     rst_epilog = """
     .. include:: <s5defs.txt>
     """

     ;

   • 将其路径附加到Sphinx's instructions sphinx配置中：

     _static/css/s4defs-roles.css