Skip to content

Add W favicon to docs (docfx)#229

Merged
Chris-Wolfgang merged 4 commits into
mainfrom
feature/docs-favicon
Jun 18, 2026
Merged

Add W favicon to docs (docfx)#229
Chris-Wolfgang merged 4 commits into
mainfrom
feature/docs-favicon

Conversation

@Chris-Wolfgang

Copy link
Copy Markdown
Owner

Summary

Replicates repo-template PR #413. Adds the canonical W favicon to this repo's DocFX site so the browser tab shows a recognizable Wolfgang branding mark.

Design

White W (Segoe UI Black) on a purple #4a1e9e rounded tile with a lighter #7c5cf6 rim so the tile edge stays visible against dark themes. Self-contained — no webfont dependency.

Files added

  • docfx_project/favicon.svg — primary, scalable, linked via the modern template
  • docfx_project/favicon.ico — multi-size legacy fallback (16/32/48)
  • docfx_project/apple-touch-icon.png — iOS home-screen (180×180)

Wiring (docfx_project/docfx.json)

  • Three assets added to the build resource.files list so they ship in _site
  • _appFaviconPath: "favicon.svg" added under globalMetadata — DocFX modern template's native favicon hook (emits <link rel="icon"> automatically)

Note: _appFaviconPath links only the SVG (which all modern browsers honour). The .ico and apple-touch assets ship in the site for completeness but aren't auto-linked in <head>.

No bypass required

docfx_project/* is unprotected — should merge as a normal PR once CI is green.

@Chris-Wolfgang Chris-Wolfgang merged commit 0fa75f8 into main Jun 18, 2026
10 checks passed
@Chris-Wolfgang Chris-Wolfgang deleted the feature/docs-favicon branch June 18, 2026 21:28
Chris-Wolfgang added a commit that referenced this pull request Jun 19, 2026
Resolves 2 conflict files by taking main's (canonical) version:

- .github/workflows/docfx.yaml — 3 hunks. vNext was behind on:
  - The `env: GITHUB_REPOSITORY: ...` derive that lets the versions.json
    preservation guard work under workflow_call (main's PR #229/#230).
  - The hardened PowerShell error handling in the existing-versions
    fetch (distinguishes 404 from other failures more carefully,
    drops the PS-5-only `-UseBasicParsing` flag).
  - The inlined root-redirect HTML — replaces the external
    `.github/version-picker-template.html` indirection (main's
    PR #195 "canonical/d8-inline-root-redirect"). The template file
    is deleted by this merge.

- docs/DOCFX-VERSION-PICKER.md — add/add. Main's 256-line version
  documents the inlined-HTML approach; vNext's 210-line version
  still described the template file. Taking main's keeps the doc
  internally consistent with the workflow change above.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
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