Brendan
Brendan
If a ref link is present in a toc title, then I would be surprised if clicking the link within the displayed toc will actually have an effect.
I took a swing at letting `docutils.nodes.raw` get partially rendered and then only injecting `` tags in the title's text data... So, we should be able to use sphinx-design's inline...
I'll push my changes to a test branch for experimentation/review. My primary goal is to allow icons in the nav menu (not concerned about supporting all other roles). Yes, putting...
I just realized the metadata tag approach won't work with `toctree` captions. Doesn't feel like a deal breaker, but it would be easy to support if using the inline icon...
> relative to the parent directory that contains the sphinx builder’s HTML output This description may be too terse or inadequate, but it is correct. The parent of the builder's...
I'd opt for the `autodoc-skip-member` event. Manually maintaining an `__all__` attribute makes patching in updates rather cumbersome and is largely discouraged (almost as discouraged as using `import *`).
Could rst templates be used like auto-summary does?
> similar to what is done for C++ in the work-in-progress cpp apigen branch. This was my second idea. I think that would also solve #152
+1 to this. looks like the link points to docs that use a rtd theme (not doxygen html output).
After examining the `pformat()` comparison, this issue is somewhat similar to https://github.com/michaeljones/breathe/issues/827