简体   繁体   English

pdoc 不会将函数参数生成为链接

[英]pdoc does not generate the function arguments as links

I am using pdoc3 in order to generate my project docs.我正在使用pdoc3来生成我的项目文档。 The project is composed from 2 py modules:该项目由 2 个 py 模块组成:

  • api.py api.py
  • model.py模型.py

The data structures are defined in model.py and used in api.py.数据结构在model.py 中定义并在api.py 中使用。

The generated HTML does not generate the function arguments as links.生成的 HTML 不会将函数参数生成为链接。

How can I make pdoc generate the function args (data structures) as links?如何让 pdoc 生成函数 args(数据结构)作为链接?

==Code snippets== ==代码片段==

api.py api.py

def create_user(auth: Auth, user: User) -> CreateUserApiCallResult:
    """
    Create a User
    """
    return create_users(auth, [user])

model.py模型.py

@dataclass
class User:
    email: str
    inviteMessage: str
    accessGroups: List[str]
    profileData: ProfileData

Generated HTML生成的 HTML

在此处输入图片说明

To produce HTML documentation of your whole package :要生成整个包的 HTML 文档:

pdoc --html --output-dir build my_package

documentation of pdoc3 pdoc3 的文档

It will create the links if there is no importation error.如果没有输入错误,它将创建链接。

声明:本站的技术帖子网页,遵循CC BY-SA 4.0协议,如果您需要转载,请注明本站网址或者原文地址。任何问题请咨询:yoyou2525@163.com.

 
粤ICP备18138465号  © 2020-2024 STACKOOM.COM