您好, 欢迎来到 !    登录 | 注册 | | 设为首页 | 收藏本站

如何将intersphinx与特定于django的结构(如设置)相关联?

5b51 2022/1/14 8:23:14 python 字数 4055 阅读 574 来源 www.jb51.cc/python

使用适当的intersphinx设置,您可以从您自己的文档链接到Django类,如下所示: :class:`django:django.db.models.Model` 但是你如何链接到一个设置? Django使用自己的:setting:为此构造而不是内置的类似:class:.如何使用intersphinx链接到设置? 我尝试过各种各样的咒语,但都没有用(有些可能是错误的): :ref:`djan

概述

:class:`django:django.db.models.Model`

但是你如何链接一个设置? Django使用自己的:setting:为此构造而不是内置的类似:class:.如何使用intersphinx链接到设置?

我尝试过各种各样的咒语,但都没有用(有些可能是错误的):

:ref:`django:ROOT_URLconf`
:ref:`django:root_URLconf`
:setting:`django:ROOT_URLconf`
:ref:`django:setting:ROOT_URLconf`
:django:setting:`ROOT_URLconf`

未定义标签错误:django:root_URLconf和未知解释文本角色“设置”问候我.

:django:setting:`ROOT_URLconf`

在你告诉Sphinx关于intersphinx目标的自定义角色之前不行.

最后通过将Django’s sphinx extension中的一个小片段复制为我的文档旁边的_ext / djangodocs.py来实现它:

def setup(app):
    app.add_crossref_type(
        directivename = "setting",rolename = "setting",indextemplate = "pair: %s; setting",)

我将以下内容添加到我的Sphinx’conf.py中:

import os
import sys

...

sys.path.append(
    os.path.abspath(os.path.join(os.path.dirname(__file__),"_ext")))
# ^^^ I'll do that neater later on.

extensions = ['djangodocs',# ^^^ I added that one.
              'sphinx.ext.autodoc',...
              ]

...

所以:intersphinx可以工作,但是如果你指向一个自定义角色,你需要在本地定义该自定义角色.

总结

以上是编程之家为你收集整理的如何将intersphinx与特定于django的结构(如设置)相关联?全部内容,希望文章能够帮你解决如何将intersphinx与特定于django的结构(如设置)相关联?所遇到的程序开发问题。


如果您也喜欢它,动动您的小指点个赞吧

除非注明,文章均由 laddyq.com 整理发布,欢迎转载。

转载请注明:
链接:http://laddyq.com
来源:laddyq.com
著作权归作者所有。商业转载请联系作者获得授权,非商业转载请注明出处。


联系我
置顶