Dartdoc: 从第三方包链接到 api.dartlang.org 上 sdk 中的标识符

创建于 2015-07-28  ·  8评论  ·  资料来源: dart-lang/dartdoc

支持指向 sdk 标识符的链接(例如List )。 链接应该添加到(类、方法、...)签名和文档注释(标记链接)中的类型。

P1 customer angular enhancement help wanted

所有8条评论

这事有进一步更新吗? 是否可以对其进行分类并标记优先级,例如 P1 :)

@devoncarew我们还有人在做 dartdoc 吗?

@keertip正在努力,但这不是她的主要任务; 欢迎投稿。

@devoncarew - 感谢您的更新。 我们可以至少为这个问题指定一个优先级吗?
也许也将其标记为需要帮助

这是对 api.dartlang.org 的外部链接请求,还是对自动包含依赖项的请求?

前者,我想。

我相信这是对外部生成的 API 文档的请求,默认情况下,它使用 SDK 类链接到 SDK 文档。 例如,如果外部包(例如args )具有 Map 属性(例如commands ),则大多数人希望能够单击 Map 并访问https://api.dartlang.org/stable/dart-core /地图类.html。

选项可能是 (1) 不生成这些链接或 (2) 链接到特定版本的 SDK API 文档。 这些链接可能应该与同一包内的链接具有不同的默认格式。

行。 #1368 解决了后者,但前者绝对在我的关注范围内。 打算调整问题的标题,使其更加清晰。

1524 应该使这更容易。 Dartdoc 现在有一些基本的包边界意识,我们可以用它来确定是否应该生成备用超链接,所以现在只是实现生成的问题。

此页面是否有帮助?
0 / 5 - 0 等级