单包项目的Sphinx文档中的较短参考

Shorter references in a Sphinx documentation for a single-package project(单包项目的Sphinx文档中的较短参考)
本文介绍了单包项目的Sphinx文档中的较短参考的处理方法,对大家解决问题具有一定的参考价值,需要的朋友们下面随着小编来一起学习吧!

问题描述

我正在为一个具有单个顶层包my_package的Python项目编写Sphinx文档。要引用此包中的模块/类,我目前使用

:mod:`my_package.my_module`
:class:`my_package.MyClass`
:class:`my_package.my_module.MyOtherClass`

然后将这些引用生成为

my_package.my_module
my_package.MyClass
my_package.my_module.MyOtherClass

我的问题是:有没有办法配置Sphinx,以便我可以使用更短的引用,如

:mod:`my_module`
:class:`MyClass`
:class:`my_module.MyOtherClass`

将引用生成为

my_module
MyClass
my_module.MyOtherClass

换句话说,我是否可以将顶级my_package设置为隐式?

推荐答案

包含

.. currentmodule:: my_package

在rst文件的顶部,则可以在引用中省略这一点。

这篇关于单包项目的Sphinx文档中的较短参考的文章就介绍到这了,希望我们推荐的答案对大家有所帮助,也希望大家多多支持编程学习网!

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

相关文档推荐

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中安全地调用随机文件上的类型?)