Skip to content

docs: use absolute image URLs in README for PyPI rendering#11

Closed
mnriem wants to merge 1 commit into
mainfrom
mnriem-fix-2908-pypi-readme-image-urls
Closed

docs: use absolute image URLs in README for PyPI rendering#11
mnriem wants to merge 1 commit into
mainfrom
mnriem-fix-2908-pypi-readme-image-urls

Conversation

@mnriem

@mnriem mnriem commented Jun 25, 2026

Copy link
Copy Markdown
Owner

Summary

The README renders fine on GitHub but the logo and demo GIFs do not appear on the PyPI project page (https://pypi.org/project/specify-cli/) because they use relative paths. PyPI does not resolve relative image paths.

This converts the three relative image references to absolute raw.githubusercontent.com URLs so they display correctly on PyPI while continuing to render on GitHub:

  • media/logo_large.webp (header logo)
  • media/specify_cli.gif
  • media/bootstrap-claude-code.gif

The shields.io badges were already absolute and are unchanged.

Context

Follow-up to github#2915 (which added readme = "README.md" to pyproject.toml). As noted in github#2908, the README now publishes to PyPI but the images still don't render. This addresses that rendering gap.

Relates to github#2908.

Relative image paths do not render on the PyPI project page. Convert the
logo and demo GIF references to absolute raw.githubusercontent.com URLs so
they display correctly on https://pypi.org/project/specify-cli/ while
continuing to render on GitHub.

Fixes the rendering gap noted in github#2908.

Assisted-by: GitHub Copilot (model: Claude Opus 4.8, autonomous)
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@mnriem mnriem closed this Jun 25, 2026
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