我使用 Sphinx 和自动文档功能来确保我们的项目中有好的文档。
所以我很熟悉info field lists我熟悉使用 cross-referencing在我们的文档中。
但是,在为方法或函数编写文档字符串时,我发现在文本中引用它们的参数很有用。但似乎没有一种结构化的方式来做到这一点。
我们可以说例如
Use ``name`` to set the username
但这没有结构,需要你记住你使用的是什么风格,如果你改变风格,你必须寻找并杀死所有不正确的风格。
:param: 在信息字段列表之外不起作用,所以你不能写
Use :param:`name` to set the username
我见过一些项目使用 :parm: 但没有记录,而且似乎不起作用。所以他们必须有一些定制
- 我可以使用 generic_roles,但这似乎是在解决我确信其他人遇到过的问题。
希望我只是错过了一些非常明显的东西。
最佳答案
您可以使用 autodoc-process-docstring 编写自己的扩展程序- 这真的很简单。
让扩展程序搜索 :param:
并将其替换为您选择的样式。
关于python - 在 Python 文档字符串中引用参数,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/13879717/