Open HaiyiMei opened 1 year ago
Thanks for opening your first issue here! Engagement like this is essential for open source projects! :hugs:
If you haven't done so already, check out EBP's Code of Conduct. Also, please try to follow the issue template as it helps other community members to contribute more effectively.
If your issue is a feature request, others may react to it, to raise its prominence (see Feature Voting).
Welcome to the EBP community! :tada:
I don’t see any captions in the sidebar currently, what happened?
I think this is intentional, but I'm finding myself wanting to be able to do the same, where there are multiple H1 headings, and having those show up on the primary sidebar. xref: https://github.com/executablebooks/sphinx-book-theme/issues/337
I run into this and am out of ideas how to work around. The only option that works reasonably OK is to use the caption
of toctree, but it looks rather silly in the main page that practically the same thing as the heading and then as the caption.
So, if it's not possible to include level1 heading in the sidebar, then either of these workaround would be great to achieve something similar (minus a link to the heading anchor, but I can live with that):
https://github.com/Caltech-IPAC/irsa-tutorials/pull/27 https://github.com/nasa-fornax/fornax-demo-notebooks/issues/295
Describe the bug
context When I add
.. toctree::
inindex.rst
like this:The content of
tmp.md
is:expectation After build the docs, I expected the sidebar (or so-called navbar) to have every first-level head of
.md
file, which ishead1
andhead2
.bug But instead, I got only the first title in sidebar like this:
Reproduce the bug
All files are compressed into
test.zip
: test.zipThe main files of this zip are as follows:
index.rst
:tmp.md
conf.py
List your environment
No response