feat: allow specifying docstring parser

Author: machow

quartodoc/autosummary.py

@@ -427,6 +427,7 @@ def __init__(
         rewrite_all_pages=False,
         source_dir: "str | None" = None,
         dynamic: bool | None = None,
+        parser="numpy",
     ):
         self.layout = self.load_layout(sections=sections, package=package)
 
@@ -435,6 +436,7 @@ def __init__(
         self.dir = dir
         self.title = title
         self.sidebar = sidebar
+        self.parser = parser
 
         self.renderer = Renderer.from_config(renderer)
 
@@ -483,7 +485,7 @@ def build(self, filter: str = "*"):
         # shaping and collection ----
 
         _log.info("Generating blueprint.")
-        blueprint = blueprint(self.layout, dynamic=self.dynamic)
+        blueprint = blueprint(self.layout, dynamic=self.dynamic, parser=self.parser)
 
         _log.info("Collecting pages and inventory items.")
         pages, items = collect(blueprint, base_dir=self.dir)

quartodoc/builder/blueprint.py

@@ -41,7 +41,10 @@ def _auto_package(mod: dc.Module) -> list[Section]:
     # get module members for content ----
     contents = []
     for name, member in mod.members.items():
-        if member.is_module or name.startswith("__all__"):
+        external_alias = member.is_alias and not member.target_path.startswith(
+            mod.name.split(".")[0]
+        )
+        if external_alias or member.is_module or name.startswith("__"):
             continue
 
         contents.append(Auto(name=name))
@@ -268,7 +271,9 @@ def blueprint(el: Auto, package: str) -> Doc:
     ...
 
 
-def blueprint(el: _Base, package: str = None, dynamic: None | bool = None) -> _Base:
+def blueprint(
+    el: _Base, package: str = None, dynamic: None | bool = None, parser="numpy"
+) -> _Base:
     """Convert a configuration element to something that is ready to render.
 
     Parameters
@@ -293,7 +298,7 @@ def blueprint(el: _Base, package: str = None, dynamic: None | bool = None) -> _B
 
     """
 
-    trans = BlueprintTransformer()
+    trans = BlueprintTransformer(parser=parser)
 
     if package is not None:
         trans.crnt_package = package