pydata-sphinx-theme icon indicating copy to clipboard operation
pydata-sphinx-theme copied to clipboard

Configurable footer components

Open jorisvandenbossche opened this issue 5 years ago • 4 comments

Context

Currently our footer is quite minimal, and auto-populated with some Sphinx flags to show things like the copyright etc. However, many sites use the footer to provide contextual information for readers that scroll to the bottom, things like social media links, site navigation, etc.

Proposal

Our footer should be composable with components, similarly to how our header navbar works. We could re-use some components from the header (e.g., icon-links) and potentially define a footer-specific component or two (e.g., column links that displayed vertically instead of horizontally).

Design inspiration

Name Link
Material for MkDocs image
Furo image
Bokeh image

edit: this was edited heavily by @choldgraf :-)

jorisvandenbossche avatar Oct 30 '19 09:10 jorisvandenbossche

Thanks for opening the issue, I will take the time to put together something.

tritas avatar Oct 30 '19 14:10 tritas

Is the current implementation corresponding to what you were expecting in 2019 or is there still things to change ?

12rambau avatar May 07 '22 20:05 12rambau

I think that the implementation of the footer still hasn't changed by too much...IMO there might still be some nice low-hanging fruit to improve there. (e.g., we could have a footer_start and footer_end configuration similar to what we have in the navbar, that could be populated with things like icon-links)

choldgraf avatar May 11 '22 14:05 choldgraf

I think a big improvement that would be quite simple is to instead of having a copyright setting and render it with © Copyright at the beginning, to have a footer setting without extra content in the template. This would easily allow the current footers, and let anyone who doesn't want that copyright text to not have it.

If backward-compatibility is important, maybe a copyright_prepend = '© Copyright ' setting that can be overwritten, and used instead of the hardcoded text would be an improvement. Easier to users to change a setting than overwrite a template.

datapythonista avatar Sep 14 '22 10:09 datapythonista

solved in #1184 ?

12rambau avatar Feb 16 '23 07:02 12rambau

Ah indeed I think so!

closed by #1184

choldgraf avatar Feb 16 '23 07:02 choldgraf