rootiest/fish-config
1
1
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(site): use real Gitea logo for header social link #106

Merged
rootiest merged 2 commits from feat-starlight-gitea-icon into main 2026-08-17 20:05:57 +00:00
Conversation 0 Commits 2 Files Changed 8
+1519 -44
rootiest commented 2026-08-17 19:31:14 +00:00
Owner
Copy Link
Copy Source

Summary

  • The top-right header link to the Gitea repo used Starlight's generic code-branch icon. Wires up starlight-plugin-icons + UnoCSS (Iconify) so it can render pajamas:gitea instead.
  • Adds a custom SocialIcons.astro override that swaps in the real Gitea logo for the Gitea social link, falling back to Starlight's default icon set for anything else.
  • Enables the plugin's sidebar (sidebar: true) and codeblock (codeblock: true) icon support in astro.config.mjs for future use — not applied to any content yet.
  • Documents the new setup in docs/site/README.md.
  • Minifies the header logo SVG, flagged during dev-server auditing: 56KB of unminified, high-precision path data with no embedded raster, down to ~8.9KB (SVGO, then a further manual pass) with no visual difference.

Manual Verification Checklist

  • cd docs/site && npm install && npm run dev, confirm the header shows the Gitea logo (not the generic branch icon)
  • Hover the icon — it should shift to the accent hover color like the rest of the header controls
  • Check both light and dark themes
  • npm run build completes cleanly with no broken links
  • Sidebar/codeblocks render unchanged (no icons expected yet, just infrastructure)
  • Header logo still renders correctly at normal size (no visual regression from the SVG minification)
## Summary - The top-right header link to the Gitea repo used Starlight's generic `code-branch` icon. Wires up [`starlight-plugin-icons`](https://docs.rettend.me/starlight-plugin-icons) + UnoCSS (Iconify) so it can render `pajamas:gitea` instead. - Adds a custom `SocialIcons.astro` override that swaps in the real Gitea logo for the `Gitea` social link, falling back to Starlight's default icon set for anything else. - Enables the plugin's sidebar (`sidebar: true`) and codeblock (`codeblock: true`) icon support in `astro.config.mjs` for future use — not applied to any content yet. - Documents the new setup in `docs/site/README.md`. - Minifies the header logo SVG, flagged during dev-server auditing: 56KB of unminified, high-precision path data with no embedded raster, down to ~8.9KB (SVGO, then a further manual pass) with no visual difference. ## Manual Verification Checklist - [x] `cd docs/site && npm install && npm run dev`, confirm the header shows the Gitea logo (not the generic branch icon) - [x] Hover the icon — it should shift to the accent hover color like the rest of the header controls - [x] Check both light and dark themes - [x] `npm run build` completes cleanly with no broken links - [x] Sidebar/codeblocks render unchanged (no icons expected yet, just infrastructure) - [x] Header logo still renders correctly at normal size (no visual regression from the SVG minification)
rootiest added 1 commit 2026-08-17 19:31:15 +00:00
feat(docs-site): add starlight-plugin-icons, use real Gitea logo in header f32e0d0ce5 
The header social link used Starlight's generic `code-branch` icon.
Wires up starlight-plugin-icons + UnoCSS (Iconify) and overrides
SocialIcons to render `pajamas:gitea` for the Gitea link instead, while
falling back to Starlight's default icon set for anything else. Sidebar
and codeblock icon support are enabled but unused for now.
rootiest added 1 commit 2026-08-17 20:03:15 +00:00
perf(docs-site): minify header logo SVG f865ad766d 
logo.svg was 56KB of unminified, high-precision path data with no
embedded raster. Running it through SVGO (default preset, multipass)
cuts it to ~20KB with no visual difference.

perf(docs-site): further minify header logo SVG. Cut to ~8.9KB with no visual difference.
rootiest force-pushed feat-starlight-gitea-icon from 69cadb41fc to f865ad766d 2026-08-17 20:03:15 +00:00 Compare
rootiest merged commit 3ef83d1747 into main 2026-08-17 20:05:57 +00:00
rootiest deleted branch feat-starlight-gitea-icon 2026-08-17 20:05:58 +00:00
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
Clear labels
Compat/Breaking
Breaking change that won't be backward compatible
 Kind/Bug
Something is not working
 Kind/Documentation
Documentation changes
 Kind/Enhancement
Improve existing functionality
 Kind/Feature
New functionality
 Kind/Security
This is security issue
 Kind/Testing
Issue or pull request related to testing
Priority
Critical
1
The priority is critical
Priority
High
2
The priority is high
Priority
Low
4
The priority is low
Priority
Medium
3
The priority is medium
Reviewed
Confirmed
1
Issue has been confirmed
Reviewed
Duplicate
2
This issue or pull request already exists
Reviewed
Invalid
3
Invalid issue
Reviewed
Won't Fix
3
This issue won't be fixed
Status
Abandoned
3
Somebody has started to work on this but abandoned work
Status
Blocked
1
Something is blocking this issue or pull request
Status
Need More Info
2
Feedback is required to reproduce issue or to continue work
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
rootiest (Rootiest)
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: rootiest/fish-config#106