冒号包含类在python注释中意味着什么?

内容来源于 Stack Overflow,并遵循CC BY-SA 3.0许可协议进行翻译与使用

  • 回答 (1)
  • 关注 (0)
  • 查看 (236)

冒号包含class(:class:)在python注释中意味着什么?

例如,

class Optimizer(object):
    r"""Base class for all optimizers.
    Arguments:
        params (iterable): an iterable of :class:`torch.Tensor` s or
            :class:`dict` s. Specifies what Tensors should be optimized.
        defaults: (dict): a dict containing default values of optimization
            options (used when a parameter group doesn't specify them).
    """

    def __init__(self, params, defaults):
        self.defaults = defaults

它是特定于pytorch的语法,还是什么?

资料来源:https//github.com/pytorch/pytorch/blob/master/torch/optim/optimizer.py

提问于
用户回答回答于

这不是Python或Torch特有的。它是文档工具的语法; 很可能是狮身人面像

语法表示对另一个类的文档的交叉引用。当文档工具生成HTML等超链接输出时,此类引用会自动成为指定类的文档页面的链接。

对于Sphinx,请参阅交叉引用语法文档 ; 在那里你会看到py:class:一个类引用,但我们可以假设默认域设置为Python,所以:class:也是有效的。

PyTorch项目确实使用Sphinx生成文档。您可以将找到的来源与生成的文档进行比较 ; 请注意两者是如何dicttorch.Tensor超链接到更多文档。

扫码关注云+社区

领取腾讯云代金券