Site-wide topbar for navigation and links

[kmike]

Is your feature request related to a problem? Please describe.
It'd be nice to have an option for adding a header to the docs.

It can be used to organize navigation in a different way - for example, for having links which are not related directly to the documentation content, important links to related projects, etc. Sometimes it is also a better place for branding (depends on design).

Describe the solution you'd like
Optional header block.

Describe alternatives you've considered

• Reusing announcement block (hack)
• overriding page.html template to add a header (good to have something standard, out-of-the-box).

[pradyunsg]

Thinking out loud and making notes for a future me... There's basically 2 reasons for someone to want a topbar in documentation:

1. For linking to other resources/projects
2. For splitting the same project's documentation into multiple sections (tutorials, reference, etc.)

I'm actually inclined to create a new theme that derives from Furo, that's making a few different design choices (like no announcements, different navigation handling, logo going into the header instead of sidebar). That can be biased toward larger/multi-project documentation sets; which is also where I imagine that something like this would be more appealing. This would also cleanly separate the code and different behavior, which is good -- it limits the user-facing configuration that Furo has to have (fewer the number of knobs, the easier it is to use).

[pradyunsg]

Closing since I consider this out of scope for Furo.

There's some collaboration work being done with pydata-sphinx-theme (which does have this) as well as various other folks, that'll hopefully result in something nice for this style of content! :)