QQgit/scripts/build_theme.py

311 lines
12 KiB
Python
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

#!/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, display=None):
"""blocks: [(selector, indent_for_root, vars_map, extras)],selector 为 '@media ...{ :root{...} }' 时用 nested。
display: 写进 gitea-theme-meta-info 的显示名;Gitea 支持时主题选择器里就显示这个名字,而不是文件名。"""
parts = [HEADER.format(title=title), ""]
if display:
parts.extend([
"gitea-theme-meta-info {",
f' --theme-display-name: "{display}";',
"}",
"",
])
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)], display="QQGit · 浅色")
write_theme(OUT / "theme-qq-dark.css", "qq-dark(蓝白 ins 风 · 仅深色)",
[(":root", False, dark, dark_extras)], display="QQGit · 深色")
write_theme(OUT / "theme-qq-auto.css", "qq(蓝白 ins 风 · 日夜自动跟随系统)",
[(":root", False, light, light_extras),
("@media (prefers-color-scheme:dark) {", True, dark, dark_extras)],
display="QQGit · 跟随系统")
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())