本文介绍了如何在Sphinx中正确使用Numref表?的处理方法,对大家解决问题具有一定的参考价值,需要的朋友们下面随着小编来一起学习吧!

问题描述

我正在尝试通过Sphinx文档中的编号引用一个表。我为该表指定了一个名称,然后尝试使用numref,但它错误地显示了该表的标签("MODULES_CLASSES")而不是其编号。

.. _modules_classes:

.. table:: Modules and their corresponding abstract classes

[table content]

Modules and their corresponding abstract classes are presented on table :numref:`modules_classes`.

我也试过这样做,就像我在网上找到的一个例子,但结果是一样的:

.. table:: Modules and their corresponding abstract classes
    :name: modules_classes

在我看来,我不需要导入numfig包,因为它默认包含在Sphinx中。使用命令:ref:显示表格的标题,因此我理解引用是正确的。有人能指出我做错了什么吗?

推荐答案

补救方法是在conf.py中设置numfig = True。如果没有此设置,在运行sphinx-Build时,您应该会看到一条消息,提示"警告:数字文件已禁用。:数字参考文件:已忽略"

这适用于HTML和LaTeX输出。请参见https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-numfig

这篇关于如何在Sphinx中正确使用Numref表?的文章就介绍到这了,希望我们推荐的答案对大家有所帮助,也希望大家多多支持!

11-02 18:57