holoviz-dev / nbsite

Build a tested, sphinx-based website from notebooks
https://nbsite.pyviz.org
BSD 3-Clause "New" or "Revised" License
28 stars 14 forks source link

Rework the gallery implementation for examples.pyviz.org #256

Closed maximlt closed 1 year ago

maximlt commented 1 year ago

The gallery on examples.pyviz.org is quite different from the various galleries built for Panel/HoloViews/hvPlot. In the former gallery each example has its own section and the sections are inlined, while in the sections are vertically delimited.

Multiple inlined sections on examples.pyviz.org: image

HoloViews Gallery with two sections: image

examples.pyviz.org was last built with the sphinx_pyviz_theme and relied on some of its features, while now the HoloViz sites rely on the pydata_sphinx_theme

In this PR I chose not to adapt the existing functions that generate the gallery to the use case of examples.pyviz.org. Instead I created a simpler functions tailored to its use case, removing some features I deemed non-desired for examples.pyviz.org. This was also to avoid breaking the existing HoloViz galleries, as I don't think the gallery build is tested at all.

This is how the gallery looks now: image

maximlt commented 1 year ago

That code has been added directly to the examples site, as it was very specific to that site.