starred/netbox
1
0
Fork 0
mirror of https://github.com/netbox-community/netbox.git synced 2026-01-11 21:10:29 +01:00
Code Issues 273 Packages Projects Releases 10 Wiki Activity

"latest" version formatting broken at netbox.readthedocs.io #2036

New Issue
Closed
opened 2025-12-29 17:21:40 +01:00 by adam · 2 comments
adam commented 2025-12-29 17:21:40 +01:00
Owner
Copy Link

Originally created by @candlerb on GitHub (Sep 29, 2018).

Change Type

[ ] Addition
[ ] Correction
[ ] Deprecation
[X] Cleanup (formatting, typos, etc.)

Proposed Changes

The layout used at readthedocs has changed, and now when I browse in either Chrome 69 or Firefox 62 under macOS, the top part of the page is obscured by the navigation banner.

The following example is https://netbox.readthedocs.io/en/latest/api/authentication/

image

I can stretch my window fit the full screen width, and the banner gets shorter, but still obscures part of the page.

image

Workaround: switch to "stable" instead of "latest" gives the old formatting (all navigation on left) which works fine.

Proposed change: revert latest to old formatting, or debug the CSS.

Originally created by @candlerb on GitHub (Sep 29, 2018). ### Change Type [ ] Addition [ ] Correction [ ] Deprecation [X] Cleanup (formatting, typos, etc.) ### Proposed Changes The layout used at readthedocs has changed, and now when I browse in either Chrome 69 or Firefox 62 under macOS, the top part of the page is obscured by the navigation banner. The following example is https://netbox.readthedocs.io/en/latest/api/authentication/ ![image](https://user-images.githubusercontent.com/44789/46242798-b277c480-c3c4-11e8-8131-22799af93efa.png) I can stretch my window fit the full screen width, and the banner gets shorter, but still obscures part of the page. ![image](https://user-images.githubusercontent.com/44789/46242807-d9ce9180-c3c4-11e8-93b2-2030a4673c63.png) Workaround: switch to "stable" instead of "latest" gives the old formatting (all navigation on left) which works fine. Proposed change: revert latest to old formatting, or debug the CSS.
adam added the status: acceptedtype: documentation labels 2025-12-29 17:21:40 +01:00
adam closed this issue 2025-12-29 17:21:40 +01:00
adam commented 2025-12-29 17:21:40 +01:00
Author
Owner
Copy Link

@jeremystretch commented on GitHub (Oct 2, 2018):

I'm not sure why the theme changed. We don't specify a theme in mkdocs.yml. It looks like ReadTheDocs may have changed their default theme, which is weird because the original default theme is custom to them.

@jeremystretch commented on GitHub (Oct 2, 2018): I'm not sure why the theme changed. We don't specify a theme in `mkdocs.yml`. It looks like ReadTheDocs may have changed their default theme, which is weird because the original default theme is custom to them.
adam commented 2025-12-29 17:21:40 +01:00
Author
Owner
Copy Link

@candlerb commented on GitHub (Oct 2, 2018):

Maybe this:

The theme setting in mkdocs.yml is now required. That is a good thing and should make things easier going forward.

i.e. maybe it's now falling back to the mkdocs default theme

@candlerb commented on GitHub (Oct 2, 2018): Maybe [this](https://github.com/rtfd/readthedocs.org/issues/4448): > The theme setting in mkdocs.yml is now required. That is a good thing and should make things easier going forward. i.e. maybe it's now falling back to the mkdocs [default theme](https://mkdocs.readthedocs.io/en/stable/#theming-our-documentation)
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
beta
breaking change
complexity: high
complexity: low
complexity: medium
needs milestone
netbox
pending closure
plugin candidate
pull-request
Mirrored from GitHub Pull Request
 severity: high
severity: low
severity: medium
status: accepted
status: backlog
status: blocked
status: duplicate
status: needs owner
status: needs triage
status: revisions needed
status: under review
topic: GraphQL
topic: Internationalization
topic: OpenAPI
topic: UI/UX
topic: cabling
topic: event rules
topic: htmx navigation
topic: industrialization
topic: migrations
topic: plugins
topic: scripts
topic: templating
topic: testing
type: bug
type: deprecation
type: documentation
type: feature
type: housekeeping
type: translation
No Label status: accepted type: documentation
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
adam
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/netbox#2036
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?