Skip to content

Swift.org logo and link (alt 2) - #138

Open
heckj wants to merge 6 commits into
swiftlang:mainfrom
heckj:docc-render-logo-overview
Open

Swift.org logo and link (alt 2)#138
heckj wants to merge 6 commits into
swiftlang:mainfrom
heckj:docc-render-logo-overview

Conversation

@heckj

@heckj heckj commented Aug 10, 2026

Copy link
Copy Markdown
Member

Summary

An alternate PR to #136 with an end state that reaches into the DocC content and changes the name for the combined documentation. This is more deeply touching into DocC-Render and it's component output, effectively runtime overriding it.


By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.

Screenshots of the size and dark/light mode variations:

Screenshot 2026-08-10 at 11 42 09 AM Screenshot 2026-08-10 at 11 42 03 AM Screenshot 2026-08-10 at 11 42 38 AM Screenshot 2026-08-10 at 11 42 35 AM Screenshot 2026-08-10 at 11 42 25 AM Screenshot 2026-08-10 at 11 42 18 AM

davelester and others added 6 commits August 10, 2026 10:00
… mark

The original approach targeted the Navigator sidebar's `.head-wrapper`,
which swift-docc-render tears down and rebuilds once the navigator
index data finishes loading, discarding whatever a script had inserted
into the loading-skeleton version — so the logo never stuck around.
The masthead's `.pre-title` has no such swap: it mounts once from data
already known at page load, so the logo (appended there, between the
sidebar toggle and the page title) stays visible regardless of the
sidebar's own shown/hidden/drawer state.

Also swaps the placeholder mark for the official currentColor icon from
swiftlang/swift-org-website's assets/images/icon-swift.svg.
swift-docc-render hardcodes this text to the documentation.title
locale string with no theme-settings.json or DocC metadata override
point, so it's rewritten client-side the same way the logo is inserted.
@heckj
heckj requested review from davelester and daveverwer August 10, 2026 18:43
@heckj heckj self-assigned this Aug 10, 2026

@davelester davelester left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Could you remove the black and white version of the logo from that were previously added to the PR?

@heckj heckj mentioned this pull request Aug 10, 2026
@davelester
davelester self-requested a review August 10, 2026 19:01
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.

2 participants