#!/usr/bin/env python3 # -*- coding: utf-8 -*- """从 Gitea 1.21.11 官方 CSS 派生「蓝白 ins 风」主题变量。 设计原则 -------- 1. **不改源码**:只读取二进制里导出的官方 CSS 作为数据源,产出标准的自定义主题文件。 2. **版本锁定**:数据源是 `vendor/index-1.21.11.css`(浅色 :root)与 `vendor/theme-auto-1.21.11.css`(深色 :root,位于 prefers-color-scheme 媒体查询内), 两者均来自 `gitea embedded view`,与线上 1.21.11 二进制 100% 对齐。 3. **颜色可推导**:主色 7 级深浅 + 9 级透明度全部由 `mix()` 计算,改一个主色整族跟着变。 4. **全局剔除绿色**:任何绿色系(色相 60°–170°)的变量值统一转到青蓝 188°,保留原有 明度与饱和度,这样 diff 高亮、成功态、告警橄榄色都不会再出现绿色,但语义层次仍可区分。 输出 ---- custom/public/assets/css/theme-qq-auto.css 日夜自动(跟随系统) custom/public/assets/css/theme-qq-light.css 仅浅色 custom/public/assets/css/theme-qq-dark.css 仅深色 用法 ---- python3 scripts/build_theme.py """ import colorsys import re import sys from pathlib import Path ROOT = Path(__file__).resolve().parent.parent VENDOR = ROOT / "vendor" OUT = ROOT / "custom" / "public" / "assets" / "css" VERSION = "1.21.11" # ---------------------------------------------------------------- 调色板 LIGHT_PRIMARY = "#3B82F6" # 按钮 / 链接主色(配纯白文字满足对比度) LIGHT_PRIMARY_CONTRAST = "#FFFFFF" LIGHT_HOVER = "#2563EB" LIGHT_ACTIVE = "#1D4ED8" DARK_PRIMARY = "#38BDF8" # 冰蓝主色(暗底上用深色文字保证对比度) DARK_PRIMARY_CONTRAST = "#0B1220" DARK_HOVER = "#7DD3FC" DARK_ACTIVE = "#22D3EE" CYAN_LIGHT, CYAN_LIGHT_TEXT = "#0891B2", "#0E7490" CYAN_DARK, CYAN_DARK_TEXT = "#22D3EE", "#67E8F9" LIGHT_SURFACES = { "--color-body": "#FFFFFF", "--color-box-body": "#FFFFFF", "--color-box-header": "#F8FAFC", "--color-card": "#F8FAFC", "--color-menu": "#FFFFFF", "--color-footer": "#FFFFFF", "--color-nav-bg": "#FFFFFF", "--color-header-wrapper": "#FFFFFF", "--color-secondary-bg": "#F1F5F9", "--color-input-background": "#F8FAFC", "--color-input-border": "#E2E8F0", "--color-input-text": "#0F172A", "--color-secondary": "#E2E8F0", "--color-secondary-dark-1": "#CBD5E1", "--color-secondary-dark-2": "#94A3B8", "--color-secondary-dark-3": "#64748B", "--color-secondary-dark-4": "#475569", "--color-secondary-light-1": "#E2E8F0", "--color-secondary-light-2": "#F1F5F9", "--color-text": "#0F172A", "--color-text-dark": "#020617", "--color-text-light": "#334155", "--color-text-light-1": "#475569", "--color-text-light-2": "#64748B", "--color-text-light-3": "#94A3B8", "--color-code-bg": "#FFFFFF", "--color-code-sidebar-bg": "#F8FAFC", "--color-markup-code-block": "#F1F5F9", "--color-hover": "rgba(15,23,42,0.04)", "--color-active": "rgba(15,23,42,0.07)", "--color-shadow": "rgba(15,23,42,0.08)", "--color-light-border": "rgba(15,23,42,0.08)", "--color-button": "#FFFFFF", "--color-label-text": "#0F172A", "--color-success-text": CYAN_LIGHT_TEXT, "--color-success-border": "#A5D8E4", "--color-success-bg": "#F0FAFD", "--color-green": CYAN_LIGHT, "--color-green-light": "#22D3EE", "--color-green-dark-1": CYAN_LIGHT_TEXT, "--color-green-dark-2": "#155E75", "--color-teal": CYAN_LIGHT, } DARK_SURFACES = { "--color-body": "#0D1117", "--color-box-body": "#161B22", "--color-box-header": "#161B22", "--color-box-body-highlight": "#1C2128", "--color-card": "#161B22", "--color-menu": "#161B22", "--color-footer": "#0D1117", "--color-nav-bg": "#161B22", "--color-header-wrapper": "#161B22", "--color-secondary-bg": "#1C2128", "--color-input-background": "#0D1117", "--color-input-border": "#30363D", "--color-input-text": "#E6EDF3", "--color-secondary": "#30363D", "--color-secondary-dark-1": "#3D444D", "--color-text": "#E6EDF3", "--color-text-dark": "#F0F6FC", "--color-text-light": "#C9D1D9", "--color-text-light-1": "#B1BAC4", "--color-text-light-2": "#8B949E", "--color-text-light-3": "#6E7681", "--color-code-bg": "#161B22", "--color-code-sidebar-bg": "#0D1117", "--color-markup-code-block": "rgba(240,246,252,0.06)", "--color-hover": "rgba(240,246,252,0.08)", "--color-active": "rgba(240,246,252,0.12)", "--color-shadow": "rgba(1,4,9,0.45)", "--color-light-border": "rgba(240,246,252,0.10)", "--color-button": "#161B22", "--color-label-text": "#E6EDF3", "--color-success-text": CYAN_DARK_TEXT, "--color-success-border": "#1E4C5C", "--color-success-bg": "#0F2A33", "--color-green": CYAN_DARK, "--color-green-light": "#67E8F9", "--color-green-dark-1": CYAN_DARK, "--color-green-dark-2": "#0891B2", "--color-teal": CYAN_DARK, "--color-console-bg": "#0D1117", "--color-console-border": "#30363D", "--color-console-menu-bg": "#161B22", } HEX_RE = re.compile(r"#([0-9a-fA-F]{3,8})\b") # ---------------------------------------------------------------- 颜色工具 def hex_to_rgb(h): h = h.lstrip("#") if len(h) == 3: h = "".join(c * 2 for c in h) return tuple(int(h[i:i + 2], 16) for i in (0, 2, 4)) def rgb_to_hex(rgb): return "#%02X%02X%02X" % tuple(max(0, min(255, round(v))) for v in rgb) def mix(a, b, t): """把 a 向 b 混合 t(0..1)。""" ra, rb = hex_to_rgb(a), hex_to_rgb(b) return rgb_to_hex(tuple(ra[i] + (rb[i] - ra[i]) * t for i in range(3))) def with_alpha(hex_color, pct): """#RRGGBB + 百分比 → #RRGGBBAA。""" r, g, b = hex_to_rgb(hex_color) return "#%02x%02x%02x%02x" % (r, g, b, round(pct / 100 * 255)) def degreen(match): """把绿色系(色相 60–170)统一转到青蓝 188°,保留明度/饱和度。""" h = match.group(1) if len(h) not in (3, 6): return match.group(0) r, g, b = hex_to_rgb(h) hh, ll, ss = colorsys.rgb_to_hls(r / 255, g / 255, b / 255) deg = hh * 360 if 60 <= deg <= 170 and ss > 0.08: nr, ng, nb = colorsys.hls_to_rgb(188 / 360, ll, ss) return "#%02x%02x%02x" % (round(nr * 255), round(ng * 255), round(nb * 255)) return match.group(0) def primary_family(base, contrast, hover, active, toward_light, toward_dark): """生成 Gitea 需要的整套主色变量(深浅 7 级 + 透明度 9 级)。""" fam = { "--color-primary": base, "--color-primary-contrast": contrast, "--color-primary-hover": hover, "--color-primary-active": active, } for n in range(1, 8): # dark-N:向浅色方向递进 fam[f"--color-primary-dark-{n}"] = mix(base, toward_light, n * 0.14) for n in range(1, 8): # light-N:向深色方向递进 fam[f"--color-primary-light-{n}"] = mix(base, toward_dark, n * 0.11) for n in range(1, 10): fam[f"--color-primary-alpha-{n * 10}"] = with_alpha(base, n * 10) return fam # ---------------------------------------------------------------- 解析官方 CSS def extract_vars(path): css = path.read_text(encoding="utf-8") for m in re.finditer(r":root\s*\{([^{}]*)\}", css): body = m.group(1) if "--color-primary" not in body: continue out = {} # 值里可能含 url("data:image/svg+xml;..."),分号必须受引号保护 for d in re.finditer(r"(--[a-z0-9-]+)\s*:\s*((?:[^;\"]|\"[^\"]*\")+)", body): out[d.group(1)] = d.group(2).strip() return out raise SystemExit(f"未能在 {path} 中找到 :root 变量块") def apply_palette(vars_in, surfaces, primary, contrast, hover, active, toward_light, toward_dark, is_dark): out = dict(vars_in) out.update(surfaces) out.update(primary_family(primary, contrast, hover, active, toward_light, toward_dark)) out["--color-accent"] = hover if not is_dark else active out["--color-small-accent"] = mix(primary, "#FFFFFF" if not is_dark else "#000000", 0.45) out["--is-dark-theme"] = "true" if is_dark else "false" for k, v in list(out.items()): # 内联 SVG 蒙版里的 #rrggbb 不能动,否则会破坏图标形状 out[k] = v if "url(" in v else HEX_RE.sub(degreen, v) return out # ---------------------------------------------------------------- 输出 HEADER = """/*! * Gitea 主题 · {title} * 由 scripts/build_theme.py 从 Gitea {version} 官方 CSS 自动派生,请勿手改本文件。 * 视觉规范:蓝白 ins 风 —— 纯白 / 深墨底 + 清透蓝主色 + 零绿色。 * 生成时间以 Git 提交为准;重新生成:python3 scripts/build_theme.py */""".format(version=VERSION, title="{title}") def render_var_block(vars_map, indent): pad = " " * indent return "\n".join(f"{pad}{k}:{vars_map[k]};" for k in sorted(vars_map)) def write_theme(path, title, blocks): """blocks: [(selector, indent_for_root, vars_map, extras)],selector 为 '@media ...{ :root{...} }' 时用 nested。""" parts = [HEADER.format(title=title), ""] for selector, nested, vars_map, extras in blocks: if not nested: parts.append(f"{selector}" + "{") parts.append(render_var_block(vars_map, 2)) parts.extend(f" {e};" for e in extras) parts.append("}") else: # @media 包裹 parts.append(f"{selector}") parts.append(" :root{") parts.append(render_var_block(vars_map, 4)) parts.extend(f" {e};" for e in extras) parts.append(" }") parts.append("}") parts.append("") path.write_text("\n".join(parts), encoding="utf-8") def main(): light_src = extract_vars(VENDOR / f"index-{VERSION}.css") dark_src = extract_vars(VENDOR / f"theme-auto-{VERSION}.css") light = apply_palette( light_src, LIGHT_SURFACES, LIGHT_PRIMARY, LIGHT_PRIMARY_CONTRAST, LIGHT_HOVER, LIGHT_ACTIVE, toward_light="#FFFFFF", toward_dark="#0F172A", is_dark=False, ) # 深色块 = 浅色变量全集打底(官方深色块只覆盖部分键),再叠深色台面与主色 dark_base = {k: v for k, v in light.items()} dark = apply_palette( dark_base, DARK_SURFACES, DARK_PRIMARY, DARK_PRIMARY_CONTRAST, DARK_HOVER, DARK_ACTIVE, toward_light="#F0F6FC", toward_dark="#010409", is_dark=True, ) # 官方深色块里显式声明过的键优先(例如 --color-diff-* 的深色取值) for k, v in dark_src.items(): if k in dark and k not in DARK_SURFACES and not k.startswith("--color-primary"): dark[k] = v if "url(" in v else HEX_RE.sub(degreen, v) OUT.mkdir(parents=True, exist_ok=True) light_extras = ["color-scheme:light", "accent-color:var(--color-primary)"] dark_extras = ["color-scheme:dark", "accent-color:var(--color-primary)"] write_theme(OUT / "theme-qq-light.css", "qq-light(蓝白 ins 风 · 仅浅色)", [(":root", False, light, light_extras)]) write_theme(OUT / "theme-qq-dark.css", "qq-dark(蓝白 ins 风 · 仅深色)", [(":root", False, dark, dark_extras)]) write_theme(OUT / "theme-qq-auto.css", "qq(蓝白 ins 风 · 日夜自动跟随系统)", [(":root", False, light, light_extras), ("@media (prefers-color-scheme:dark) {", True, dark, dark_extras)]) for name, data in (("theme-qq-auto.css", light), ("theme-qq-light.css", light), ("theme-qq-dark.css", dark)): p = OUT / name print(f"{name:22s} {p.stat().st_size:>7d} bytes vars={len(data)}") print(f"浅色 primary={light['--color-primary']} body={light['--color-body']}") print(f"深色 primary={dark['--color-primary']} body={dark['--color-body']}") if __name__ == "__main__": sys.exit(main())