Python-Sphinx文档：链接源代码

Question

我有一个表示模式的字典（JSON-Schema更精确）。

有时架构变得复杂，在文档中我需要链接到它以便提供更好的图片。

我启用了viewcode扩展，我尝试了以下没有运气：

.. data:: netjsonconfig.backends.openvpn.schema.schema

.. automodule:: netjsonconfig.backends.openvpn.schema

字典python路径是netjsonconfig.backends.openvpn.schema.schema 。

是否有可能实现这一目标？ 如果有，怎么样？

Answer 1

尝试这个：

.. literalinclude:: your_json_filename.json
    :language: json

您甚至可以选择要显示的此文件的一部分

.. literalinclude:: your_json_filename.json
    :language: json
    :lines: 18-43

这将显示your_json_filename.json的第18行到第43 行 。