Jeremy Maitin-Shepard
Jeremy Maitin-Shepard
Actually I'm rather confused --- roles already seem to work fine with content tabs: ```rst .. md-tab-set:: .. md-tab-item:: Customized content ``n = 4`` :class: custom-tab-item-style This content could be...
Maybe it depends on the sphinx or docutils version?
I was using Sphinx 4.4.0 and docutils 0.17.1
If you add `"sphinx_design"` to the list of extensions in conf.py then octicon works. There does indeed appear to be a bug though in the case that the label starts...
We shouldn't have to pad with whitespace --- I think the first docutils node is getting converted to a string, which is why we are seeing the docutils markup
The bug is actually in these two lines: https://github.com/jbms/sphinx-immaterial/blob/3b1a1a097d2923c7cd8736eb6509a0aca7d96aba/sphinx_immaterial/content_tabs.py#L95 https://github.com/jbms/sphinx-immaterial/blob/3b1a1a097d2923c7cd8736eb6509a0aca7d96aba/sphinx_immaterial/content_tabs.py#L155 For docutils nodes that inherit from TextElement, the first argument to `__init__` is the rawsource, and the second argument is...
Yeah, `render_partial` is the way that Sphinx uses to render snippets like this. However, when profiling documentation generation I discovered a problem with `render_partial`: it is actually quite expensive because...
I don't think there is anything that prevents those referenced being turned into `` elements, but yeah agreed that we don't really want them to do that. Probably we could...
One question is whether it is always desirable to allow rST styling to apply to the navigation as well --- for example, if some portions use a literal or code...
Agreed --- we definitely don't want to be generating documentation for third-party libraries. I assumed that autodoc already skipped imported stuff in some cases, but I guess not.