8000 DOC: left navbar is repeated in the devdocs · Issue #19028 · numpy/numpy · GitHub
[go: up one dir, main page]
Skip to content

8000 DOC: left navbar is repeated in the devdocs #19028

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Closed
mattip opened this issue May 18, 2021 · 2 comments · Fixed by #19264
Closed

DOC: left navbar is repeated in the devdocs #19028

mattip opened this issue May 18, 2021 · 2 comments · Fixed by #19264
Labels
04 - Documentation

Comments

@mattip
Copy link
Member
mattip commented May 18, 2021

See for instance https://numpy.org/devdocs/dev/index.html

This does not happen in the stable docs. Did something change in the theme?
@rossbar
Copy link
Contributor
rossbar commented May 18, 2021

I'm not sure if it's a change in the theme or a change in how sphinx itself is handling files with multiple toctrees. It seems that originally (i.e. in the stable docs) the left sidebar is populated only by the first toctree, whereas the sidebar in the devdocs is populated by both toctrees.

I have to look at things more carefully to see what specifically changed, but this seems like a good hypothesis to start from.

@melissawm
Copy link
Member
melissawm commented Jun 7, 2021 •
edited
Loading

Removing the :hidden: option (see this commit) solves the issue, but now it seems like this toctree at the beginning of the file is not needed, as the same contents are shown in the left sidebar.

I propose just removing it. argh that doesn't work (as mentioned by Ross above). Let me investigate further.

melissawm added a commit to melissawm/numpy that referenced this issue Jun 16, 2021
@melissawm
DOC: fix duplicate navbar in development documentation index
2508e39 
Also update pinned version of sphinx in environment.yml

Fixes numpygh-19028
@melissawm melissawm mentioned this issue Jun 16, 2021
Merged
rossbar pushed a commit that referenced this issue Jun 17, 2021
@melissawm
DOC: fix duplicate navbar in development documentation index (#19264)
0fe94ce 
Also update pinned version of sphinx in environment.yml

Fixes gh-19028
charris pushed a commit to charris/numpy that referenced this issue Jun 17, 2021
@melissawm @charris
DOC: fix duplicate navbar in development documentation index (numpy#1…
be642f5 
…9264)

Also update pinned version of sphinx in environment.yml

Fixes numpygh-19028
@charris charris mentioned this issue Jun 17, 2021
Merged
charris pushed a commit to charris/numpy that referenced this issue Jun 17, 2021
@melissawm @charris
DOC: fix duplicate navbar in development documentation index (numpy#1…
fdf2f10 
…9264)

Also update pinned version of sphinx in environment.yml

Fixes numpygh-19028
@charris charris mentioned this issue Jun 17, 2021
Merged
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees
No one assigned
Labels
04 - Documentation
Projects
None yet
Milestone
No milestone
Development

Successfully merging a pull request may close this issue.

DOC: fix duplicate navbar in development documentation index melissawm/numpy
3 participants
@mattip @rossbar @melissawm
0