Skip to content

Add an icon to every menu entry - #22

Merged
cdiddens merged 2 commits into
pyoomph:mainfrom
cdiddens:menu-icons
Aug 7, 2026
Merged

Add an icon to every menu entry#22
cdiddens merged 2 commits into
pyoomph:mainfrom
cdiddens:menu-icons

Conversation

@cdiddens

@cdiddens cdiddens commented Aug 7, 2026

Copy link
Copy Markdown
Collaborator

Adds a small icon in front of each of the five nav entries.

  • Documentation / Source Code get their projects' marks — the Read the Docs book and the GitHub Invertocat — in white. White is a permitted variant for both: Read the Docs publishes a "light logo" (#fafafa) for dark backgrounds, and GitHub's brand guidelines list white as one of the allowed colours and explicitly permit using the mark to link to GitHub.
  • Features / About / Installation get hand-drawn glyphs on the same 24×24 grid (star, info circle, download arrow), filled with currentColor so they follow the label colour on hover.

Both marks are inline SVG, so nothing new lands under _generated/media/. #menu a becomes white-space: nowrap so each icon stays on the same line as its label when the menu wraps on narrow screens.

Note: the deploy check will show red, as it does on every PR from a fork — the build succeeds and only the gh-pages push fails on the read-only token. It goes green on merge.

🤖 Generated with Claude Code

https://claude.ai/code/session_01Fmhceke9votYhvWyGSBKyG

cdiddens and others added 2 commits August 4, 2026 14:38
Adds two sections to CLAUDE.md:

- Publishing: which remote is the live site (upstream = pyoomph, origin =
  the fork), the branch -> push -> gh pr create -> merge flow, and why a PR
  from a fork always shows a failing check (deploy.yml also runs on
  pull_request, but GITHUB_TOKEN is read-only for fork PRs, so only the
  push to gh-pages 403s - nothing is published and it clears on merge).

- Finding new publications for pubs.bib: the About page lists publications
  that *use* pyoomph, not everything that cites it. Records the three open
  citation indexes to query for works citing the main JCP paper, the
  dedupe traps, and the screening step.

Papers that cite the JCP paper without using pyoomph are collected in the
new pubs_excluded.md, so they do not have to be screened again. It starts
with the four found on 2026-08-04.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_019XJeo2Rp5sDjApHWf77wza
The two external entries get their projects' marks: the Read the Docs
book and the GitHub Invertocat, both in white. White is a permitted
variant for both - Read the Docs publishes a "light logo" (#fafafa) for
dark backgrounds, and GitHub's brand guidelines allow the Invertocat in
white and explicitly permit using the mark to link to GitHub.

The three internal entries get hand-drawn glyphs on the same 24x24 grid
(star, info circle, download arrow), filled with currentColor so they
follow the label colour on hover.

The marks are inline SVG rather than image files, so nothing needs to be
added under _generated/media/. `#menu a` becomes white-space: nowrap to
keep each mark on the same line as its label when the menu wraps on
narrow screens.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Fmhceke9votYhvWyGSBKyG
@cdiddens
cdiddens merged commit 4a230b2 into pyoomph:main Aug 7, 2026
1 check failed
@cdiddens
cdiddens deleted the menu-icons branch August 7, 2026 13:42
cdiddens added a commit that referenced this pull request Aug 7, 2026
A PR from a fork only ever gets a read-only GITHUB_TOKEN, whatever the
permissions: contents: write declaration says, so the push to gh-pages
always failed with a 403 and marked the run red. Nothing was published
by those runs, and nothing could have been - see the runs on PRs #19-#22.

Gating the deploy step on the event turns the PR check into what is
actually useful there: it verifies that gen_page.sh still builds, which
would catch e.g. an upstream readthedocs layout change breaking
gen_example_gallery.py. Publishing still happens on push to main.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Fmhceke9votYhvWyGSBKyG
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant