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行。