QQGit — Gitea 极简蓝白 ins 风外观定制(只改 custom/ 覆盖层,不改源码)
https://git.qyhhh.top
- baseline/custom: /var/lib/gitea/custom 完整副本(14 个现有主题 CSS) - baseline/app-ini/ui-section.txt: [ui] 段落快照(app.ini 原件含 SMTP 凭据,已 gitignore) - upstream-templates-1.21.11: 从二进制 embedded 导出的 23 个官方模板,作为 DOM 结构基准 - README.md / .gitignore: 铁律、目录约定与版本标签规范 |
||
|---|---|---|
| baseline | ||
| upstream-templates-1.21.11/templates | ||
| .gitignore | ||
| README.md | ||
README.md
Gitea-font · Gitea 极简蓝白 ins 风外观定制
目标实例:
https://git.qyhhh.top(Gitea 1.21.11,二进制/usr/local/bin/gitea,运行用户git:git) 本仓库是外观定制的工作目录(staging)。所有改动先在这里做出来、经确认后再复制进/var/lib/gitea/custom。
一、铁律(不可违反)
- 只改外观,不改源码:唯一允许的手段是 Gitea 官方的
custom/覆盖机制——custom/templates/*.tmpl(模板覆盖 / 注入钩子)、custom/public/assets/css|js|img|fonts(静态资源)。 绝不修改/usr/local/bin/gitea二进制、绝不重新编译、绝不改/var/lib/gitea以外的源码树。 - 先工作目录、后线上:
custom/只是「待发布副本」;只有拿到明确批准后才执行scripts/deploy.sh。 - 线上基线可回滚:部署前自动打包备份,
scripts/rollback.sh可一键还原。 - 视觉铁律:无文字(No text)、蓝白配色、禁止绿色(告别 Gitea 原版绿茶杯)、大量留白。
二、视觉语言
| 项目 | 规格 |
|---|---|
| Logo | 「蓝白 Git 节点 Q」:浅蓝圆章 + 纯白负空间 Git 分支轨道,3 颗环上 Commit 空心节点 + 环内节点跨环分叉出 Q 的尾巴 |
| 日间色 | 圆章 #60A5FA,轨迹 #FFFFFF |
| 夜间色 | 圆章 #38BDF8,轨迹 #F8FAFC(低眩光,仅调明度,符号完全一致) |
| 圆外 | 100% 透明(Alpha=0),任何顶栏底色下都无白边方框 |
| 主色 | 浅蓝 #60A5FA / #0EA5E9 / 深色模式 #38BDF8 |
| 字体 | JetBrains Mono / JetBrains Mono Nerd Font(代码、Hash、分支名优先) |
| 圆角 | 10px 卡片 / 输入框,克制的呼吸留白 |
三、目录结构
.
├── baseline/ # 线上基线快照(部署前的原始状态,回滚依据)
│ ├── app-ini/ui-section.txt # [ui] 段落快照;app.ini 原件含凭据,已 gitignore
│ └── custom/ # /var/lib/gitea/custom 的完整副本
├── upstream-templates-1.21.11/ # 从二进制导出的官方原生模板(只读参考,防跨版本 DOM 错位)
├── design-assets/ # Logo 设计原图与决策记录
├── custom/ # ★ 待发布的覆盖层(部署时整体同步到线上 custom/)
│ ├── templates/ # 模板覆盖 + custom/ 注入钩子
│ └── public/assets/ # css / js / img / fonts
├── preview/ # 离线可视化预览画廊(本地打开即可看效果,无需线上改动)
└── scripts/ # deploy.sh / rollback.sh
四、标准工作流
# 1) 本地开发(只动 custom/ 与 preview/)
git checkout -b feat/xxx
# 2) 打候选版本,等批准
git tag v1.0-rc1
# 3) 批准后部署(内部会先备份,再同步、修权限、重载)
sudo ./scripts/deploy.sh
# 4) 需要撤销时
sudo ./scripts/rollback.sh
五、版本标签约定
| 标签 | 含义 |
|---|---|
v0.0-baseline |
线上原始状态 + 官方 1.21.11 模板快照 |
v1.0-rcN |
工作目录候选版本,等待确认 |
v1.0-live |
已部署到线上并通过验收 |
六、上传限制(现状记录,不在本次改动范围)
app.ini 中 [picture] 段已调大:AVATAR_MAX_FILE_SIZE = 52428800、AVATAR_MAX_WIDTH/HEIGHT = 4096。