Is it possible to auto-generate subpages?

[jasonho-lynx]

Hi, thank you for working on this package! I was trying it out and found that renderer pages were specified like this:

renderer:
  type: mkdocs
  pages:
    - title: Home
      name: index
      contents: [<MY MODULES>]

Where <MY MODULES> would be something like package_a.module_b.*. Is it possible to have something like:

renderer:
  pages:
    - title: Home
      name: index
      contents: [package_a]

So that all modules within package_a will each get their own subpage? Currently, specifying package_a.* puts all modules onto the same page.

Thanks!

[NiklasRosenstein]

Hey @jasonho-lynx ,

Unfortunately there's currently no functionality that automatically "expands" a package's submodule into its own pages. I would say right now Pydoc-Markdown's architecture unfortunately does not natively support that without implementing a new "renderer" plugin (which could "wrap" another renderer and add to it's "pages" configuration).

I've written down some thoughts on a new rendering pipeline for Pydoc-Markdown here (#211) but not sure when I'll get to that.

Best,
Niklas