add a custom 404 page

[neuromusic]

📚 Documentation

Currently, a 404 error yields a generic Github 404 page

Github pages supports custom 404 pages... my understanding is that they use whatever page is at /404.html

• pure HTML example: https://draft.dev/learn/github-pages-404
• Jekyll example: https://docs.github.com/en/pages/getting-started-with-github-pages/creating-a-custom-404-page-for-your-github-pages-site

This should be fairly easy with sphinx by adding a top level 404 page that is hidden from the ToC

[melissawm]

I believe this should be a napari/napari-sphinx-theme issue - should we migrate this there?

[psobolewskiPhD]

I think this actually belongs in the deployed repo, so https://github.com/napari/napari.github.io
https://docs.github.com/en/pages/getting-started-with-github-pages/creating-a-custom-404-page-for-your-github-pages-site

[jni]

Yes and no — I would like to avoid editing that repo manually as much as possible — ideally, we build the page in the docs repo as an unversioned page and it gets deployed from there. What do you think @psobolewskiPhD?

It would be fun to play with the island theme, something like "you're off the map" and an ocean theme with a weird fin sticking out of the water... 😃

[jni]

(In fact, maybe it is a theme issue, and it just needs to go into the unversioned pages list...?)

[melissawm]

I just saw this comment now so I might have to update napari/napari.github.io#394 😅 but I'm happy to do that.