Show the official ORCID iD icon next to ORCID links#142
Open
RichardLitt wants to merge 1 commit into
Open
Conversation
Add the official ORCID iD SVG (green roundel from ORCID's brand guidelines, https://info.orcid.org/brand-guidelines/) at assets/orcid-id.svg and update the authors hook to render it next to ORCID identifiers wherever they appear. Hook changes (.config/hooks/authors.py): - New _orcid_markdown(orcid, asset_prefix) helper renders [ <orcid>](https://orcid.org/<orcid>) so mkdocs rewrites the relative asset path correctly for both source roots. - _render_author_page uses asset_prefix="../" since author pages are generated under authors/<slug>.md. - _render_pattern_bullets uses asset_prefix="" since pattern pages live at the docs root. The SVG declares intrinsic width/height of 16px so the icon renders at a sensible inline size without requiring attr_list or extra CSS. Verified with `mkdocs build --strict`: clean build, icon copied to /assets/orcid-id.svg in the site output, rendered HTML on both author pages and pattern-page chips contains the expected <img alt="ORCID iD icon" ...> inside the ORCID anchor.
This was referenced May 23, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Builds on top of #141.
What this changes
Right now, an ORCID on an author's page or in a pattern's contributor list shows up as the word "ORCID" or the bare ORCID number. This PR adds the official ORCID iD icon (the small green roundel you see on ORCID's own site and on most academic profile pages) next to those numbers. It's a small visual change — purely cosmetic — but it makes ORCIDs instantly recognisable as ORCIDs at a glance.
Where you'll see it
What to click on the preview site
/authors/ciara-flanagan/— Ciara's page; the ORCID line at the top has the icon now./embed-wellbeing-into-student-hackathons/— scroll to Contributors; each contributor's ORCID is shown with the icon.What this doesn't change
authors.ymlcontinue to show no ORCID line, same as before.Stacking
This PR is stacked on top of #141 — please merge that one first. Once #141 is in, this one rebases automatically onto
main.🤖 Generated with Claude Code