Greetings Carl, when using Java/Javadoc I found its better to go the route JavaDoc --> XML --> XSLT --> RST | MD | ADOC | Docbook. It gives you much better control over the document, e. g. what shall be a heading, what a paragraph.
For the sidebar, I use a Java Script since the Furo Sidebar does not work well for very long TOCs (and your TOC will be very long). Also, my Java Script TOC supports simple search and hiding. Have a look here: https://manticore-projects.com/JSQLParser/javadoc_snapshot.html It's not exactly what you need, but it may provide you with templates or guidance. Good luck Andreas On Mon, 2023-06-12 at 12:47 -0700, Carl Gay wrote: > Hi, I'm using a custom domain for the Dylan programming language and > I would like to include all the functions, constants, etc defined > with directives in the table of contents at the correct level. Is it > possible to have the domain directives themselves add entries to the > toctree? > > From what I know so far, I'm thinking that I should be able to > introspect the generated object graph to figure out the current ToC > depth and (somehow) insert nodes at the next level. To be a little > more concrete, if my document looks like this: > > My Library > ********** > > My Module 1 > =========== > > .. function:: foo > > foo is ferocious > > My Module 2 > =========== > > .. constant:: bar > > bar is best > > I would like to see this table of contents in the right sidebar (I'm > using the Furo theme, if it's important): > > My Module 1 > foo > My Module 2 > bar > > I'm hoping that someone can tell me whether I'm heading in the right > direction by trying to do this with the Dylan domain code, or if I > need to look at some other way to accomplish it, so that I don't > spend too much time going down the wrong path. > > Thanks. > -- > You received this message because you are subscribed to the Google > Groups "sphinx-users" group. > To unsubscribe from this group and stop receiving emails from it, > send an email to sphinx-users+unsubscr...@googlegroups.com. > To view this discussion on the web visit > https://groups.google.com/d/msgid/sphinx-users/db4ef36b-d326-47fa-ab9d-6e28b87ab2e9n%40googlegroups.com > . -- You received this message because you are subscribed to the Google Groups "sphinx-users" group. To unsubscribe from this group and stop receiving emails from it, send an email to sphinx-users+unsubscr...@googlegroups.com. To view this discussion on the web visit https://groups.google.com/d/msgid/sphinx-users/9d16d5d0307cda0707b4e78fbdb1c49de6a5958b.camel%40manticore-projects.com.
