Tikz + Verbatim + Sphinx，输出两次绘制，略有偏移。效果很好 Tikz + Verbatim

Question 1

正如注释中所述，代码在行尾缺少几个“%，这将被解释为单词空格，从而导致水平偏移

所以

\def\notebookcellframe#1{

应该

\def\notebookcellframe#1{%

垂直跳跃周围的代码也非常脆弱。

\needspace{4\baselineskip}%    
\begin{notebookcell}[((( cell.prompt_number )))]
\begin{addmargin}[\cellleftmargin]{0em} % left, right
\smaller%
\vspace{-1\baselineskip}%
\vspace{-1\borderthickness}%
((( cell.input | highlight2latex )))%
\vspace{-1\baselineskip}%
\end{addmargin}

我没有看到定义，addmargin但我认为内容以垂直模式开始。

该\needsspace测试使用 baselineskip 的外部（较大）值。

\smaller是字体更改，因此会（立即）更改字体大小，并且 baselineskip 也会立即更改，尽管用于文本的有效值取决于段落是否在当前范围内结束（即的定义\endaddmargin）

\smmaller是

\def\smaller{\fontsize{9.5pt}{9.5pt}\selectfont}

将 9.5pt 字体设置为 9.5pt 目标基线，因此通常这是不可能的，因此\baselineskip实际上将不会被使用，而是\lineskip会被使用，通常基线空间比字体大小大约大约 10-12％。

假设addmargin以垂直模式启动，那么

\vspace{-1\baselineskip}%
\vspace{-1\borderthickness}%

现在将添加负空间（使用 9.5pt \baselineskip）/如果addmargin以水平模式启动，则这些空间将保持在\vadjust节点中并添加下列的下一行文本。您可以将\par它们放在前面，以确保您处于 vmode 中。

然后将文本设置为小字体

\vspace{-1\baselineskip}%

以水平模式解释，因此在 vadjust 节点中保存直到段落结束，大概在某个地方的定义中\enddaddmargin。同样，您可能希望将\par其放在之前\vskip。

如果你得到这些空间周围的不同布局，原因可能是addmargin或notebookcell

在开头添加一个框或写入节点或某种特殊内容

或者

重新定义事物以便addmargin从水平模式开始

或者

重新定义事物，因此有一个额外的组层，并且该组在小文本段落之前结束，因此它与原始较大的基线一起设置。

Answer

正如注释中所述，代码在行尾缺少几个“%，这将被解释为单词空格，从而导致水平偏移

所以

\def\notebookcellframe#1{

应该

\def\notebookcellframe#1{%

垂直跳跃周围的代码也非常脆弱。

\needspace{4\baselineskip}%    
\begin{notebookcell}[((( cell.prompt_number )))]
\begin{addmargin}[\cellleftmargin]{0em} % left, right
\smaller%
\vspace{-1\baselineskip}%
\vspace{-1\borderthickness}%
((( cell.input | highlight2latex )))%
\vspace{-1\baselineskip}%
\end{addmargin}

我没有看到定义，addmargin但我认为内容以垂直模式开始。

该\needsspace测试使用 baselineskip 的外部（较大）值。

\smaller是字体更改，因此会（立即）更改字体大小，并且 baselineskip 也会立即更改，尽管用于文本的有效值取决于段落是否在当前范围内结束（即的定义\endaddmargin）

\smmaller是

\def\smaller{\fontsize{9.5pt}{9.5pt}\selectfont}

将 9.5pt 字体设置为 9.5pt 目标基线，因此通常这是不可能的，因此\baselineskip实际上将不会被使用，而是\lineskip会被使用，通常基线空间比字体大小大约大约 10-12％。

假设addmargin以垂直模式启动，那么

\vspace{-1\baselineskip}%
\vspace{-1\borderthickness}%

现在将添加负空间（使用 9.5pt \baselineskip）/如果addmargin以水平模式启动，则这些空间将保持在\vadjust节点中并添加下列的下一行文本。您可以将\par它们放在前面，以确保您处于 vmode 中。

然后将文本设置为小字体

\vspace{-1\baselineskip}%

以水平模式解释，因此在 vadjust 节点中保存直到段落结束，大概在某个地方的定义中\enddaddmargin。同样，您可能希望将\par其放在之前\vskip。

如果你得到这些空间周围的不同布局，原因可能是addmargin或notebookcell

在开头添加一个框或写入节点或某种特殊内容

或者

重新定义事物以便addmargin从水平模式开始

或者

重新定义事物，因此有一个额外的组层，并且该组在小文本段落之前结束，因此它与原始较大的基线一起设置。

Question 2

导致您出现问题的主要原因是 Sphinx Verbatim 使用自身framed.sty并framed.sty引入了垂直空间，而您的代码根本没有尝试控制这些空间。此外，如果框架以水平模式启动，情况会非常复杂。我使用当前的 Sphinx 尝试解决了您的问题。

删除每次使用环境时积累的所有垂直空间notebookcell，再加上In[1]:不进入段落模式（也不使用令人困惑的 TikZ）绘制，只剩下\smallskipSphinx 始终将其插入框架顶部的。然后我们使用条件来告诉 verbatim 它已经在框架环境中（然后必须在 minipage 内完成）；此条件仅在较新的 Sphinx 版本中存在（在较早的版本中没有理由这样做，因为没有 Verbatim 会在另一个 Verbatim 内结束……但较新的 Sphinx 用于framed其他用途）。

结果：

该规则是为了显示一致性。

代碼notebookcell：

\newenvironment{notebookcell}[1][0]{\sphinxverbatimwithminipagetrue
\def\FrameCommand{\notebookcellframe}%
\def\FirstFrameCommand{\notebookcellframetop}%
\def\LastFrameCommand{\notebookcellframebottom}%
\def\MidFrameCommand{\notebookcellframemiddle}%
\par\MakeFramed {\FrameRestore}%
\vspace{\baselineskip}%
\hbox{{\smash{\makebox[\cellleftmargin][r]{%
\smaller
       \tt\color{nbframe-in-prompt}In [#1]:%
\hspace{\inputpadding}\hspace{5pt}}%
}}\hss}%
\vspace{-\baselineskip}%
\vspace{-\smallskipamount}%
}%
{\endMakeFramed}


\def\x{\llap{\rule{2cm}{0.1pt}}\rlap{\rule{3cm}{0.1pt}}}

使用代码notebookcell（各种垂直跳跃均已被移除）：

\begin{notebookcell}[1]%
\begin{addmargin}[\cellleftmargin]{0em}%
\begin{sphinxVerbatim}[commandchars=\\\{\}]
\x\PYG{k}{print}\PYG{p}{(}\PYG{l+s}{"}\PYG{l+s}{Which has a simple task}\PYG{l+s+se}{\PYGZbs{}n}\PYG{l+s}{Seriously...}\PYG{l+s}{"}\PYG{p}{)}
\PYG{k}{print}\PYG{p}{(}\PYG{l+s}{"}\PYG{l+s}{Cool!}\PYG{l+s}{"}\PYG{p}{)}
\end{sphinxVerbatim}
\end{addmargin}
\end{notebookcell}

另一个也类似。除此之外，您还需要获得最近的一份，sphinx.sty并且其中一份获得上述内容。

Answer

导致您出现问题的主要原因是 Sphinx Verbatim 使用自身framed.sty并framed.sty引入了垂直空间，而您的代码根本没有尝试控制这些空间。此外，如果框架以水平模式启动，情况会非常复杂。我使用当前的 Sphinx 尝试解决了您的问题。

删除每次使用环境时积累的所有垂直空间notebookcell，再加上In[1]:不进入段落模式（也不使用令人困惑的 TikZ）绘制，只剩下\smallskipSphinx 始终将其插入框架顶部的。然后我们使用条件来告诉 verbatim 它已经在框架环境中（然后必须在 minipage 内完成）；此条件仅在较新的 Sphinx 版本中存在（在较早的版本中没有理由这样做，因为没有 Verbatim 会在另一个 Verbatim 内结束……但较新的 Sphinx 用于framed其他用途）。

结果：

该规则是为了显示一致性。

代碼notebookcell：

\newenvironment{notebookcell}[1][0]{\sphinxverbatimwithminipagetrue
\def\FrameCommand{\notebookcellframe}%
\def\FirstFrameCommand{\notebookcellframetop}%
\def\LastFrameCommand{\notebookcellframebottom}%
\def\MidFrameCommand{\notebookcellframemiddle}%
\par\MakeFramed {\FrameRestore}%
\vspace{\baselineskip}%
\hbox{{\smash{\makebox[\cellleftmargin][r]{%
\smaller
       \tt\color{nbframe-in-prompt}In [#1]:%
\hspace{\inputpadding}\hspace{5pt}}%
}}\hss}%
\vspace{-\baselineskip}%
\vspace{-\smallskipamount}%
}%
{\endMakeFramed}


\def\x{\llap{\rule{2cm}{0.1pt}}\rlap{\rule{3cm}{0.1pt}}}

使用代码notebookcell（各种垂直跳跃均已被移除）：

\begin{notebookcell}[1]%
\begin{addmargin}[\cellleftmargin]{0em}%
\begin{sphinxVerbatim}[commandchars=\\\{\}]
\x\PYG{k}{print}\PYG{p}{(}\PYG{l+s}{"}\PYG{l+s}{Which has a simple task}\PYG{l+s+se}{\PYGZbs{}n}\PYG{l+s}{Seriously...}\PYG{l+s}{"}\PYG{p}{)}
\PYG{k}{print}\PYG{p}{(}\PYG{l+s}{"}\PYG{l+s}{Cool!}\PYG{l+s}{"}\PYG{p}{)}
\end{sphinxVerbatim}
\end{addmargin}
\end{notebookcell}

另一个也类似。除此之外，您还需要获得最近的一份，sphinx.sty并且其中一份获得上述内容。

Tikz + Verbatim + Sphinx，输出两次绘制，略有偏移。效果很好 Tikz + Verbatim

答案1

答案2

相关内容