site: migrate logos to brand kit, fix hero heading, green social card#20
Merged
Conversation
Finish moving modern-python.org onto the canonical brand/build kit: - brand/build: add wordmark() (transparent two-color hero lockup, light + cream/gold-dark variants) and mark() (transparent chevron, no background); render.py emits wordmark.svg, wordmark-dark.svg, mark.svg. Tests cover both. - just sync-assets: regenerate the kit and copy the site subset into docs/assets. - Header: theme.logo -> assets/mark.svg (chevron mark), keeping Material's "Modern Python" site title and search beside it. Favicon -> assets/favicon.svg. - Hero: replace the inline single-color wordmark with the two-color brand wordmark inside the page <h1>, scheme-swapped light/dark in extra.css. The <h1> suppresses Material's injected "Home" fallback heading. - index.md gains a `title: Modern Python` so the header topic reads the brand name instead of the nav default "Home"; overrides/main.html overrides htmltitle so the homepage tab title stays "Modern Python" (not duplicated). - Move the "Built with uv, ruff, and ty" tagline to the page bottom. - Social card: og:image -> assets/social-card-green.png (green card). - Retire the superseded scripts/gen_*.py generators and the old modern-python* assets and cream social-card.png. - architecture/site-branding.md documents the asset pipeline and wiring. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This was referenced Jun 28, 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.
Finishes moving modern-python.org onto the canonical
brand/build/kit, and fixes the stray "Home" heading.What changed
MODERN+ goldPYTHON), generated from the brand kit, swapped light/dark by color scheme. It lives inside the page<h1>, which suppresses Material's injected<h1>Home</h1>fallback.theme.logois the compact chevronmark.svg; Material's "Modern Python" title and search stay in place.index.mdgainstitle: Modern Pythonso the scroll-reveal header topic reads the brand name instead of "Home", andoverrides/main.htmloverrideshtmltitleso the homepage tab title staysModern Python(no duplication).favicon.svg.og:imagepoints at the green card (social-card-green.png).Brand kit / tooling
brand/build/geometry.pygainswordmark()(transparent two-color lockup) andmark()(transparent chevron);render.pyemitswordmark.svg,wordmark-dark.svg,mark.svg. Tests added intests/.just sync-assetsregenerates the kit and copies the site subset intodocs/assets/.scripts/gen_logo_svg.py/gen_social_card.pyand the oldmodern-python*assets + creamsocial-card.png.architecture/site-branding.mddocuments the pipeline and wiring.Verification
uv run pytest— 17 passeduv run mkdocs build— clean; no<h1>Home</h1>, tab titleModern Python, header/hero/favicon/og:image all reference the new assetsjust check-planning— OKmkdocs serveand confirmed in-browser🤖 Generated with Claude Code