pymc-devs / pymc-devs/pymc-examples

Improve visuals of the notebook gallery

Open
#447 7 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Python
Stars
398
Forks
325
Avg merge
9d 15m
Merged PRs (30d)
1

Description

The gallery is great, but there is definitely room for improvement. This is particularly noticeable since the core notebooks were added to the top of the page. The thumbnails are small and the full width of the central column of the page is not used.

I'm not sure, but can we fix this simply by editing the thumbnail size here?

https://github.com/pymc-devs/pymc-examples/blob/dce63a03b894d39a0a39a4773f9a0226078391c1/sphinxext/thumbnail_extractor.py#L26

Anyone know where the formatting code for the core notebooks is?

Example 1

Screenshot 2022-10-16 at 11 57 50

Example 2

With a narrower browser window, the right bar becomes hidden (which is fine), but now we have 4 columns of notebooks rather than 3 for the regular notebooks. Not sure if this is set to fill available space.

Screenshot 2022-10-16 at 12 01 27

Tagging @OriolAbril , @twiecki, @reshamas

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with sphinxext/thumbnail_extractor.py at the linked line and inspect how the notebook gallery and core notebooks are formatted. Compare the two screenshots at different browser widths, then trace the relevant gallery styling or layout entry point. Done means the thumbnails use the central column effectively and the gallery has consistent columns across widths.

Written by the indexing model from the issue text.

Assessment

Tech stack
jupyter-notebook, python
Domain
design, documentation
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
32/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.