feat: add extra inventory items using canonical path

Author: machow

quartodoc/builder/collect.py

@@ -39,10 +39,19 @@ def exit(self, el: layout.Doc):
         p_el = page_node.value
 
         uri = f"{self.base_dir}/{p_el.path}.html#{el.anchor}"
+
+        # item corresponding to the specified path ----
+        # e.g. this might be a top-level import
         self.items.append(
             layout.Item(name=el.obj.path, obj=el.obj, uri=uri, dispname=None)
         )
 
+        # item corresponding to the canonical path ----
+        # this is where the object is defined (which may be deep in a submodule)
+        self.items.append(
+            layout.Item(name=el.obj.canonical_path, obj=el.obj, uri=uri, dispname=None)
+        )
+
         return el
 
     @dispatch