如何自定义现有的LaTeX环境而不干扰其他环境？

Question

我正在使用 Sphinx 来记录项目。 它从 reStructuredText 生成 LaTeX 文件。

我想为 tips 和 notes 设置灰色背景颜色，因此我在创建灰盒环境后自定义了 notice 环境：

\definecolor{MyGray}{rgb}{0.80,0.80,0.80}

\makeatletter\newenvironment{graybox}{%
   \begin{lrbox}{\@tempboxa}\begin{minipage}{\columnwidth}}{\end{minipage}\end{lrbox}%
   \colorbox{MyGray}{\usebox{\@tempboxa}}
}\makeatother

\makeatletter
\renewenvironment{notice}[2]{
  \begin{graybox}
  \bf\it
  \def\py@noticetype{#1}
  \par\strong{#2}
  \csname py@noticestart@#1\endcsname
}
{
  \csname py@noticeend@\py@noticetype\endcsname
  \end{graybox}
}
\makeatother

一切正常很好，除非我放置一个图 通知环境内的环境。 在这种情况下，我收到此错误：

LaTeX 错误：不在外部模式

有没有办法为该通知环境设置灰色背景？

Answer 1

这是常见问题解答。 将图形（或任何其他可以在输出中移动到其他位置的“浮动”）放入灰框中是没有意义的； 如果您希望图形包含灰盒，请将灰盒环境放入图形环境中。

Answer 2

感谢godbyk和Jouni回答我的问题。

问题是我不直接用 LaTeX 编码。 我用重组文本编写文档，Sphinx 输出 LaTeX 文件。

但我找到了一个解决方案：我重新定义了 figure 环境以使用 flowfram 包中的 staticfigure：

\usepackage{flowfram}

\definecolor{MyGray}{rgb}{0.80,0.80,0.80}

\makeatletter\newenvironment{graybox}{%
   \begin{lrbox}{\@tempboxa}\begin{minipage}{\columnwidth}}{\end{minipage}\end{lrbox}%
   \colorbox{MyGray}{\usebox{\@tempboxa}}
}\makeatother

\makeatletter
\renewenvironment{notice}[2]{
  \begin{graybox}
  \bf\it
  \def\py@noticetype{#1}
  \par\strong{#2}
  \csname py@noticestart@#1\endcsname
}
{
  \csname py@noticeend@\py@noticetype\endcsname
  \end{graybox}
}
\makeatother

\renewenvironment{figure}[6]{
  \begin{staticfigure}
}{
  \end{staticfigure}
}

PS：我必须将 6 放入重新定义“figure”时的参数数量：如果我不这样做，它会在 pdf 文件中输出一些“htbp”（我不是 LaTeX 专家。这只是我为此找到的解决方案问题）

Answer 3

正如 Jouni 正确指出的那样，数字和表格（即浮动）可以移动，而你的灰盒子不能包含它们。 要达到所需的效果，您有两个选择：

1. 将整个通知放入 figure 环境中（以便整个通知可以在页面上浮动，或者如果 LaTeX 选择的话，可以浮动到新页面）。

2. 不要使用浮动（figure 环境）——只需使用 \includegraphics 将图像直接弹出到 notice 环境中。 但是，您将无法在该非图形中使用标题，因为标题只能在图形或表格环境中使用。 如果您想要与此图像关联的标题，可以使用 标题包：

   <前><代码>\documentclass{文章}
   \usepackage{caption}% 让我们在浮动之外使用标题
   \usepackage{lipsum}% 提供填充文本
   \开始{文档}
   \lipsum[1]
   \开始{中心}
   \includegraphics{mypic}
   \captionof{figure}{这是我的图片。}% 为非浮动元素添加标题
   \标签{图：mypic}
   \结束{中心}
   \lipsum[2]
   \结束{文档}

我没有使用过 Sphinx，所以恐怕我无法帮助您将其集成到他们的输出中。