5.7 KiB
5.7 KiB
TODO · Gitea 蓝白 ins 风外观定制(v1.0)
本文件是仓库里的持久化清单;GUI 会话里还有一份同名 todo 面板,两者内容一致。 状态:
[x]完成[~]进行中[ ]未开始[!]等待批准
阶段 1 · Git 基线与素材归档 — 完成
- 1.1
git init -b main,user.name=QQ、user.email=qq@qyhhh.top - 1.2 快照线上
/var/lib/gitea/custom→baseline/custom/ - 1.3 快照
/etc/gitea/app.ini的[ui]段 →baseline/app-ini/ui-section.txt(原件含 SMTP 密码,.gitignore排除,不进仓库) - 1.4
gitea embedded view导出官方 1.21.11 模板 23 个 →upstream-templates-1.21.11/ - 1.5 导出官方
index.css/theme-auto.css作为变量派生源 →vendor/ - 1.6 提交并打标签
v0.0-baseline(commit62b45b2)
阶段 2 · Logo 套件 — 完成
- 2.1 决策锁定 方案 2-A:日间
#60A5FA圆章 + 纯白负空间 Git-Q;夜间仅把圆章提到#38BDF8 - 2.2 原图归档
design-assets/:image-ca10a7ce.png(日间)、image-33a59194.png(夜间) - 2.3 矢量 SVG:
logo.svg(内嵌@media (prefers-color-scheme:dark)自动换色)、logo-light.svg、logo-dark.svg、favicon.svg(32 栅格重绘,非缩放) - 2.4 位图导出:
logo.png(512)、logo-dark.png(512)、favicon.png(180)、apple-touch-icon.png(180)、favicon-32.png(32) - 2.5 三底色目视确认(
#FFFFFF/#0D1117/#161B22):圆外 100% 透明,无白框
阶段 3 · 三套主题 CSS — 完成
- 3.1
scripts/build_theme.py:解析官方:root→ 叠加台面/主色 → 派生 primary 明暗族与 alpha 族 - 3.2
degreen():色相 60–170°(绿/黄绿)统一转 188° 青蓝,保留明度与饱和度 - 3.3 修正则坑:
url("data:image/svg+xml;...")值被截断 → 改用支持引号的表达式并跳过 degreen - 3.4 产出
theme-qq-auto.css/theme-qq-light.css/theme-qq-dark.css(各 243 变量) - 3.5
scripts/audit_colors.py审计:三套主题无绿色残留,全部通过
阶段 4 · 模板钩子与细节层 — 完成
- 4.1 本地内置
JetBrains Monowoff2(400/500/700),不走 CDN - 4.2
custom/public/assets/css/qq-ui.css:字体、8px 圆角、顶栏毛玻璃、滚动条、卡片、页脚 - 4.3
custom/templates/custom/header.tmpl:preload 字体 + 引入qq-ui.css+theme-colormeta - 4.4
custom/templates/custom/footer.tmpl:.qq-footer页脚(ICP 备案号留注释占位) - 4.5
custom/templates/home.tmpl:基于官方精简,logo 168×168 + 三卡首页(沿用官方 i18n key)
阶段 5 · 离线预览与候选版 — 完成
- 5.1
preview/index.html:首页 / 仓库列表 / 文件页+代码块 / 组件 / Logo 双底色校验 5 段 - 5.2 右上角胶囊切换 浅色 / 自动 / 深色(切
<link disabled>,localStorage 记忆) - 5.3
scripts/check_preview.py:变量、类名、日夜媒体查询全绿;24 个资源引用零缺失 - 5.4 提交并打标签
v1.0-rc1 - 5.5 QQ 在预览页验收通过(2026-11-03),直接进入阶段 6
阶段 6 · 部署上线 — 等待批准
- 6.1
scripts/deploy.sh:默认预演,列出将复制的文件与备份路径,零改动 - 6.2
--yes真部署:tar备份 →rsync custom/→chown -R git:git→systemctl restart gitea - 6.3
--patch-ini:备份app.ini后把[ui]改为DEFAULT_THEME=qq-auto并追加qq-auto,qq-light,qq-dark - 6.4
scripts/rollback.sh+docs/DEPLOY.md(含部署后 7 项自查清单) - 6.5 已获 QQ 明确批准并执行
./scripts/deploy.sh --yes --patch-ini(2026-11-03 09:37) - 6.6 部署后验收通过,已打标签
v1.0-live - 6.8 覆盖
custom/templates/base/footer_content.tmpl:删掉官方整条页脚(Powered by Gitea / 版本 / 耗时 / 语言 / 许可证 / API),改为悬挂式页脚显示 闽ICP备2023002932号(position:fixed贴底 +body{padding-bottom:42px},2026-11-03 已部署) - 6.7 部署后修补:语言圆点统一品牌蓝(压掉 Shell 亮绿)、页脚去重(不再出现两行 Powered by Gitea)、主题选择器显示名改为
QQGit · 浅色/深色/跟随系统
部署记录
| 时间 | 动作 | 备份 |
|---|---|---|
| 2026-11-03 09:37 | deploy.sh --yes --patch-ini 首次上线(custom/ 全量 + [ui] 切到 qq-auto) |
/var/backups/gitea-custom-20261103-093751.tar.gz |
| 2026-11-03 09:39 | 语言圆点 + 页脚去重 二次部署 | /var/backups/gitea-custom-20261103-093913.tar.gz |
| 2026-11-03 09:xx | 主题显示名修补 三次部署 | 见 /var/backups/ 最新包 |
app.ini 每次改动前都另存 app.ini.bak-<时间戳>。
已知遗留(不在本次范围)
- 服务器
dpkg --audit中 openresty / openresty-opm / openresty-resty 处于半配置状态 (既有问题,非本次引入;装librsvg2-bin时被触发,已stop+reset-failed,站点仍 200)
v1.1 动效层(首页 + 登录页)
- 7.1
qq-fx.css/qq-fx.js:粒子星座、旋转光环、渐变标题、打字口号、毛玻璃卡片 - 7.2 登录页卡片化(不覆盖模板,纯 CSS 作用域
.page-content.user.signin) - 7.3 页脚补语言切换(
{{if not .SignedUser}}+/?lang=xx纯链接,不依赖 JS) - 7.4 修复 index.css 干扰:
.page-footer窄屏 column/space-between、.inline.field堆叠 → 全部用显式 flex 规则钉死 - 7.5 上线并实拍验证(桌面浅色 / 登录页 / 深色走预览图)
- 7.6 待 QQ 提供公安联网备案号后追加