dart - 我如何告诉 dartdoc 记录所有内容？

Question

我试图将我的类分别放在一个文件中，这些类属于几个不同的库。

基本上，这些文件library inf.logic;位于顶部：

这有library inf.gfx;：

这只是library inf;：

inf然后我有了主入口点，默认情况下它似乎最终出现在库中：

web/inf.dart（进口gfx/viewport.dart, logic/realm.dart, logic/region.dart, logic/tile.dart）

当我生成 dartdoc 时，它似乎只捕获了一些类，似乎是随机的。尽管主入口点显式使用了上述所有类，但我只得到为region.dartand生成的文档events.dart。不包括其他文件，并且文档中引用其他类的链接会导致 404。

感觉就像我做错了什么。我应该求助于为库创建一个包装文件并使用partandpart of吗？我真的不喜欢在文件关系之间添加维护需求的想法，这应该已经从导入中隐含了。

另外，我怎样才能摆脱相对路径？我试过package:inf/logic/realm.dart了，还是不行……</p>

score 0 · Accepted Answer

Andrei Mouravski 在邮件列表中回答了这个问题：

这里有几个问题：

如果 Dartdoc 正在生成 404 链接，则使用您可能提供的所有信息提交错误。很可能有什么东西坏了。dartbug.com/new
您可以通过传递多个入口点同时记录多个内容。注意：如果你有多个入口点，你应该使用'pkg'命令行选项来指定你的包文件夹。
您不需要包装文件，但 dartdoc 应该记录在入口点中导入的每个库，因此可能只需要一个简单的文件来导入您想要记录的所有库。我们正在为此做一些更好的事情，我很抱歉它现在有点坏了。

1 回答 1