为Sphinx生成的PDF文件添加注释的背景颜色？

Question

我可以使用Sphinx指令生成注释.. notes::.但是,html文件中的注释具有背景颜色,而生成的PDF中的注释则没有.

如何为Sphinx生成的PDF文件添加颜色？

Answer 1

您可以在conf.py文件中添加这样的内容(请参阅文档以获取LaTeX输出的选项):

latex_custom = r'''
\definecolor{Admonition}{RGB}{221,233,239}

\makeatletter
  \newenvironment{admonitionbox}{
    \begin{lrbox}{\@tempboxa}\begin{minipage}{\columnwidth}
  }{
    \end{minipage}\end{lrbox}
    \colorbox{Admonition}{\usebox{\@tempboxa}}
  }

  \renewenvironment{notice}[2]{
    \begin{admonitionbox}
  }{
    \end{admonitionbox}
  }
\makeatother
'''

latex_elements = {'preamble': latex_custom}

这是一个基本的例子,它将改变所有告诫框的背景颜色(注意,警告,提示等).