Re: [sphinx-users] Using rst file names for navigation

2020-07-08 Thread bradley...@gmail.com
I am using toctree in each section that has children as you describe above. When I view the section with that toctree entry, I would like the navigation links in the left column to corresponds to the names in the toctree command; i.e., use 'first' instead of the headings in the file first.rst,

Re: [sphinx-users] Using rst file names for navigation

2020-07-08 Thread Stefano David
HI, On Wednesday, 8 July 2020 13:23:02 UTC+2, bradley...@gmail.com wrote: > > I have been using my own documentation system for years and am writing a > program to convert sphinx so that it is easier for others to edit my > documentation, and so that I no longer have to maintain it (It was writt

Re: [sphinx-users] How can one create a Sphinx directive that creates documentation from an externally defined data structure?

2020-07-08 Thread Doug Hellmann
> On Jun 29, 2020, at 3:59 PM, Rollo Konig-Brock wrote: > > Hey there, > > I posted this question on stack overflow, but I think it's a bit too niche > for that site and it's better to just ask the hardcore Sphinx users. > > -- > > How can one create a Sphinx directive that creates doc

Re: [sphinx-users] How can one create a Sphinx directive that creates documentation from an externally defined data structure?

2020-07-08 Thread Rollo Konig-Brock
Thanks Komiya, that's awesome. On Tuesday, 7 July 2020 15:14:54 UTC+1, Komiya Takeshi wrote: > > Hi, > > AFAIK, there are no way to expand the contents for directives via own > custom directive. As a similar way, you can generate whole of > directive via own custom directive: > > .. custom_se

Re: [sphinx-users] Using rst file names for navigation

2020-07-08 Thread bradley...@gmail.com
I have been using my own documentation system for years and am writing a program to convert sphinx so that it is easier for others to edit my documentation, and so that I no longer have to maintain it (It was written years ago in C). In this system one has a title and an abbreviated title for

Re: [sphinx-users] Using rst file names for navigation

2020-07-08 Thread Matt from Documatt
Hi Bradley! Question #1 - You can't use filename as document title. First section found in document will become a document title. Baz will be document title: foo bar baz === but document title is usually at the very top of the file: baz === foo bar Question 2 - you speak about breadcrumb n