Hi Jonathan, On 2/3/23 15:09, Jonathan Corbet wrote: > Add a new sidebar template that creates a more RTD-like "fisheye" view of > the current place in the document hierarchy. It is far from ideal, but > some readers may find it better for navigating through the documentation as > a whole. > > Signed-off-by: Jonathan Corbet <corbet@xxxxxxx> > --- > Sorry it took so long to get back to this...$EXCUSES plus trying to get > ready for the merge window. > > This version includes the suggestions Akira sent around a couple of > weeks ago. I've also the sidebar TOC go one level deeper when > appropriate. > > There's a bit of JavaScript that attempts to scroll the sidebar > appropriately. It's far from perfect but, hopefully an improvement. It > could be made better, but I've managed to remain blissfully ignorant of > JavaScript over the years, so it's slow going. It would sure be nice if > somebody who is better at that stuff could jump in. > > I think the contents of the sidebar could be improved too, but that's > probably a bigger job. > > As before, the results can be seen at: > > https://static.lwn.net/kerneldoc/ I haven't been following this saga closely but this is looking good to me. Thanks. Nit: it says that it's for kernel 6.2.0-rc2-6.2.0-rc2+. Is that expected? Another question: if I'm deep into the menu tree, is there a way (link) to get back to the top level? Other than editing the URL, that is. > This probably isn't going to get a lot further before the merge window. > So I ask: is this sufficiently better that it should go into 6.3? I'll let the others answer that one. > Documentation/conf.py | 5 +++-- > Documentation/sphinx-static/custom.css | 20 ++++++++++++++++++- > .../sphinx/templates/kernel-toc.html | 11 ++++++++++ > 3 files changed, 33 insertions(+), 3 deletions(-) > create mode 100644 Documentation/sphinx/templates/kernel-toc.html -- ~Randy
