sphinx.ext.viewcode能否直接嵌入源码？附pyobject解决方案

• sphinx.ext.viewcode插件的核心作用是为文档里的Python对象（比如函数、类）生成跳转至源码页面的链接，不支持直接在文档页面嵌入源码片段，也无法通过引用它生成的链接路径来嵌入代码，该插件没有对应的嵌入指令。

• 无需指定行号嵌入Python代码片段的可行方案：使用带:pyobject:参数的literalinclude指令，直接指定目标函数/类名即可精准嵌入对应源码，示例如下：

.. literalinclude :: ../../my_proj/some_path/my_module.py
   :pyobject: a_function_inside_my_module
   :linenos:
   :language: python

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