311 lines
12 KiB
Python
311 lines
12 KiB
Python
#!/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())
|