feat(theme): align custom themes with Gitea 1.27

Import upstream Gitea light and dark themes so new defaults and syntax styles remain compatible across upgrades. Replace the custom navbar template with CSS-based logo overrides and remove redundant Chroma and CodeMirror assets. Add theme color-scheme metadata, correct relative asset paths, apply CSP nonces to analytics scripts, and document installation, compatibility, upgrade, and licensing requirements.
2026-09-07 16:24:29 -05:00
parent 1532ef27be
commit 0483209214
12 changed files with 76 additions and 551 deletions
@@ -0,0 +1,43 @@
+# CodeCraftsmen Gitea Theme
+
+Custom themes and branding for the CodeCraftsmen Gitea instance.
+
+## Compatibility
+
+The theme supports Gitea 1.27.x. Each custom theme imports the matching built-in
+Gitea theme and overrides only the CodeCraftsmen palette, typography, and logo.
+This allows new upstream theme variables to retain their Gitea defaults.
+
+The repository intentionally avoids overriding Gitea's internal templates. The
+navbar logo is replaced through theme CSS so Gitea template changes are applied
+normally during upgrades.
+
+## Installation
+
+Copy `public` and `templates` into the instance's Gitea custom path, configure
+the available themes, and restart Gitea:
+
+```ini
+[ui]
+THEMES = gitea-auto,gitea-light,gitea-dark,codecraftsmen-auto,codecraftsmen-light,codecraftsmen-dark
+DEFAULT_THEME = codecraftsmen-auto
+```
+
+The homelab repository vendors these files under
+`ansible/roles/gitea/files/theme` so a Gitea rebuild does not depend on this
+repository being available from the Gitea instance.
+
+## Upgrade Process
+
+1. Update the imported Gitea version locally.
+2. Compare the custom palette with the built-in light and dark themes for that
+   exact release.
+3. Test anonymous, authenticated, and administrator pages with light, dark, and
+   auto themes.
+4. Synchronize the reviewed files into the homelab Gitea role.
+
+## Assets
+
+The font and branding files are project-supplied assets. Their presence in this
+repository does not grant redistribution rights. Confirm the applicable font
+and brand licenses before making the repository public or redistributing it.