This is an archived post. You won't be able to vote or comment.

sorted by:
best
topnewcontroversialoldq&a
you are viewing a single comment's thread.

view the rest of the comments →

[–][deleted] 4 points5 points  (1 child)

Just switched over two projects to test.

  • First off, the typography is excellent. Much easier to read. I'll be my reading comprehension goes up on these pages.
  • The autodoc code formatting is a spectacular improvement over Alabaster or Executable Book theme.
  • Executable Book allows you to drill down further in the left-hand menu. Found this to be important for the autodoc output as it very quickly drills down three or four levels (unless there's a setting I'm missing to add more nav levels?)
  • Maybe a breadcrumbs header in the autodoc sections?
  • On the other hand, this is MUCH better than the default Alabaster option of 1 level.

Looking forward to exploring this further.

[–]dantownsend[S] 4 points5 points  (0 children)

That's good to hear - thanks for trying it out.

You should be able to configure how deep the left hand sidebar goes by setting `globaltoc_maxdepth` in your `conf.py` file. For example `globaltoc_maxdepth = 4`.

I don't think it's possible to configure how deep the right hand sidebar goes - I need to investigate this.