如何在Sphinx文档字符串中引用泛型类型Collection[Championship]

• 正确的写法需将泛型类和类型参数分别用:class:指令包裹，确保Sphinx能识别并生成跳转链接：

  :rtype: :class:`.Collection`[:class:`.Championship`]
  

  这种写法会让.Collection和.Championship都被解析为可点击的类引用。

• 你之前尝试的Collection[.Championship]写法中，.Championship未被:class:指令包裹，Sphinx无法将其识别为类文档链接，只能显示纯文本。

• 额外注意：需确保Sphinx配置中启用了sphinx.ext.autodoc扩展，且Collection与Championship类已被正确文档化，Sphinx能定位到它们的文档位置。

内容的提问来源于stack exchange，提问作者Stuart Yellow