cole-maxwell1
0483209214
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.
44 lines
1.5 KiB
Markdown
44 lines
1.5 KiB
Markdown
# 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.
|