python - Sphinx 文档，带编号的图形引用

Question

我正在尝试使用 latexpdf 输出获取编号的数字以处理我的 Sphinx 文档项目。我安装了在这里找到的 Sphinx numfig.py 扩展 https://bitbucket.org/arjones6/sphinx-numfig

但是，每当我使用 :num: 标签来提供与图形编号的交叉引用时，我都会得到以下内容

第一

.. _fig_logo:


.. figure:: logo.*

        Example of a figure

Reference to logo :num:`figure #fig_logo`

生成输出:

引用标志图 ??

我做错了什么吗？

Answer 1

似乎如果您的标签名称中有下划线(如 fig_logo)，sphinx 会将其替换为减号 (-，这是有道理的，因为 latex 有时会表现得很奇怪在带下划线的情况下)，而引用仍然使用下划线。因此 latex 无法找到引用的标签。

这是由 sphinx 生成的结果 tex 代码:

\includegraphics{logo.png}
\caption{Example of a figure}\label{index:fig-logo}\end{figure}

Reference to logo \hyperref[index:fig_logo]{figure  \ref*{index:fig_logo}}

(注意 fig-logo 作为标签和 fig_logo 作为引用的区别。)

例如，如果您将下划线替换为减号

.. _fig-logo:


.. figure:: logo.png

        Example of a figure

Reference to logo :num:`figure #fig-logo`

tex 代码如下所示:

\includegraphics{pandas_bar.png}
\caption{Example of a figure}\label{index:fig-logo}\end{figure}

Reference to logo \hyperref[index:fig-logo]{figure  \ref*{index:fig-logo}}

在生成的 pdf 中，这被解析为

引用标志图1

更新

如果您不想更改所有标签，您可以更新 numfig:添加行就足够了

target = target.replace('_', '-')

就在 27 行之前在您的扩展副本中。

我打开了一个 issue在位桶上。