如何在Sphinx中正确使用Numref表?

How to properly numref table in Sphinx?(如何在Sphinx中正确使用Numref表?)
本文介绍了如何在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表?的文章就介绍到这了,希望我们推荐的答案对大家有所帮助,也希望大家多多支持编程学习网!

本站部分内容来源互联网,如果有图片或者内容侵犯您的权益请联系我们删除!

相关文档推荐

Leetcode 234: Palindrome LinkedList(Leetcode 234:回文链接列表)
How do I read an Excel file directly from Dropbox#39;s API using pandas.read_excel()?(如何使用PANDAS.READ_EXCEL()直接从Dropbox的API读取Excel文件?)
subprocess.Popen tries to write to nonexistent pipe(子进程。打开尝试写入不存在的管道)
I want to realize Popen-code from Windows to Linux:(我想实现从Windows到Linux的POpen-code:)
Reading stdout from a subprocess in real time(实时读取子进程中的标准输出)
How to call type safely on a random file in Python?(如何在Python中安全地调用随机文件上的类型?)