cole-maxwell1
5acb05d7cf
Declare the Alro heading font with its intended 700 weight and explicitly apply that weight to branded headings. Preserve the homepage logo image in the accessibility tree while rendering the theme-specific visual artwork. Update repository guidance to document the self-contained theme architecture, Gitea 1.27.3 synchronization requirements, production asset hashing, and the complete six-theme verification matrix.
47 lines
1.8 KiB
Markdown
47 lines
1.8 KiB
Markdown
# CodeCraftsmen Gitea Theme
|
|
|
|
Custom themes and branding for the CodeCraftsmen Gitea instance.
|
|
|
|
## Compatibility
|
|
|
|
The theme supports Gitea 1.27.x and is currently synchronized with Gitea 1.27.3.
|
|
The light and dark themes are self-contained copies of the matching built-in
|
|
theme variable sets with CodeCraftsmen palette and typography overrides. The
|
|
auto theme conditionally imports those two local theme files according to the
|
|
user's preferred color scheme.
|
|
|
|
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. Compare the custom light and dark variable sets with the built-in themes from
|
|
the exact target release.
|
|
2. Add, remove, or rename variables to match that release while preserving the
|
|
CodeCraftsmen palette values.
|
|
3. Test anonymous, authenticated, and administrator pages with all six themes,
|
|
including both system color schemes for the two 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.
|