如何告訴dartdoc記錄所有內容？

Question

我試圖在每個文件中放置我的類，其中類屬於幾個不同的庫。

基本上，這些文件具有library inf.logic;頂部：

• web/logic/realm.dart（進口region.dart）
• web/logic/region.dart（進口../events.dart）
• web/logic/tile.dart

這有library inf.gfx;：

• web/gfx/viewport.dart（進口../logic/realm.dart）

這纔剛剛library inf;：

• web/events.dart

然後，我有主入口點，這似乎在inf落得圖書館默認：

• web/inf.dart（進口gfx/viewport.dart，logic/realm.dart，logic/region.dart，logic/tile.dart）

當我產生dartdoc，似乎只捕捉一些類，看似隨意。儘管主入口點明確使用了上述所有類，但我只能獲得region.dart和events.dart的文檔。沒有包含其他文件，並且引用其他類的文檔中的鏈接導致404。

感覺就像我做錯了什麼。我是否應該爲這些庫創建一個包裝文件並使用part和part of？我真的不喜歡在文件關係之間添加維護需求的想法，這應該已經隱含在導入中。

另外，我該如何擺脫相對路徑？我試過package:inf/logic/realm.dart，但它不工作...

Answer 1

安德烈Mouravski回答了這個郵件列表上：

有幾個問題在這裏：

1. 如果Dartdoc正在生成404個鏈接，然後文件一個包含您可能提供的所有信息的錯誤。這是非常可能的事情打破。 dartbug.com/new

2. 您可以通過傳遞多個入口點同時記錄多件事情。注意：如果您有多個入口點，則應使用'pkg'命令行選項指定您的包文件夾。

3. 你不應該需要一個包裝文件，但dartdoc應該記錄在入口點導入的每個庫，所以可能只需要一個簡單的文件來導入你想要記錄的所有庫。我們正在爲此更好地開展工作，對此我感到抱歉有點失敗。