[x] Update SinglePageRenderer interface (or add a new interface) for rendering single docspec objects (instead of only a module)
[x] Make a resolver separately configurable (as it is not provided through SinglePageRenderer and it wouldn't make much sense for it to have such a capability)
[x] Make MarkdownRenderer produce Novella @anchor tags
[x] Make CrossRefProcessor procuce Novella {@link} tags
[x] (Option to) hide the module name when referencing it with the @pydoc tag? (If yes, maybe we should include the module name somewhere else in the generated documentation for the module members)
[x] Automatically detect source linker configuration if possible
[x] Add an option to use anchor HTML tags instead of Markdown header IDs for links between API objects (maybe enabled by default) because the IDs for Markdown headers might not be unique (e.g. two API objects with the same name in the same page)
Goal of this PR is to
@pydoc
tagSinglePageRenderer
interface (or add a new interface) for rendering single docspec objects (instead of only a module)SinglePageRenderer
and it wouldn't make much sense for it to have such a capability)MarkdownRenderer
produce Novella@anchor
tagsCrossRefProcessor
procuce Novella{@link}
tags@pydoc
tag? (If yes, maybe we should include the module name somewhere else in the generated documentation for the module members)Late state considerations:
If you are interested in an introduction to how the new system works, check out the Using Novella guide in the documentation.