简体   繁体   English

在 pdoc3 自动化 html 文档中缩短链接名称

[英]Making link names shorter in pdoc3 automated html documentation

I am generating html documentation via docstring and pdoc3 for the first time.我第一次通过 docstring 和 pdoc3 生成 html 文档。

I would like to replace displayed names of qualified internal and external links, as I have seen for example in the pdoc3 documentation itself as such我想替换显示的合格内部和外部链接的名称,例如我在 pdoc3 文档本身中看到的那样

A special type of documentation object `pdoc.External` is used to...

result in this text, where "External" is a link.生成此文本,其中“外部”是一个链接。

"A special type of documentation object External is used to..." “一种特殊类型的文档 object 外部用于...”

When I do the same pdoc.External is displayed in the html text.当我执行相同的操作时,pdoc.External 会显示在 html 文本中。

I would like to do this for my internal links as well as referring some external resources like eg package.module.functionname where I would like the text to only be functionname and link to an external webpage that I provide like the numpy or scipy documentation.我想为我的内部链接执行此操作,并引用一些外部资源,例如 package.module.functionname,我希望文本只是函数名并链接到我提供的外部网页,如 numpy 或 Z10EAZ590D34CD3541C20C2文档。

Thanks in advance提前致谢

You can use this for link inside your project:您可以将其用于项目中的链接:

[visible text](project/my_module.html)

or for website或用于网站

[visible text](www.qwant.com)

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

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