QQgit/README.md

3.4 KiB
Raw Blame History

Gitea-font · Gitea 极简蓝白 ins 风外观定制

目标实例:https://git.qyhhh.top(Gitea 1.21.11,二进制 /usr/local/bin/gitea,运行用户 git:git) 本仓库是外观定制的工作目录(staging)。所有改动先在这里做出来、经确认后再复制进 /var/lib/gitea/custom。

一、铁律(不可违反)

  1. 只改外观,不改源码:唯一允许的手段是 Gitea 官方的 custom/ 覆盖机制—— custom/templates/*.tmpl(模板覆盖 / 注入钩子)、custom/public/assets/css|js|img|fonts(静态资源)。 绝不修改 /usr/local/bin/gitea 二进制、绝不重新编译、绝不改 /var/lib/gitea 以外的源码树。
  2. 先工作目录、后线上:custom/ 只是「待发布副本」;只有拿到明确批准后才执行 scripts/deploy.sh。
  3. 线上基线可回滚:部署前自动打包备份,scripts/rollback.sh 可一键还原。
  4. 视觉铁律:无文字(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。