QQgit/docs/DEPLOY.md

1.7 KiB
Raw Blame History

部署说明(阶段 6,需 QQ 批准后才做)

本文件只是操作手册,scripts/deploy.sh 默认是预演,不加 --yes 绝不会动线上。

一、前提

  1. 已在本地/镜像里打开 preview/index.html,日夜两种模式都看过,认可配色与留白。
  2. 仓库已打标签 v1.0-rc1(git tag -l 可查)。
  3. QQ 明确说过「可以部署」。

二、预演(随时可做,零风险)

cd ~/projects/Gitea-font
./scripts/deploy.sh

它会列出将被复制的文件清单、备份路径与后续动作,然后退出,线上不变。

三、真部署

./scripts/deploy.sh --yes                 # 复制 custom/ + 重启
./scripts/deploy.sh --yes --patch-ini     # 另外把 app.ini 的 [ui] 主题切成 qq 系列

--patch-ini 做的事:把 DEFAULT_THEME 改为 qq-auto,并在 THEMES 后追加 qq-auto,qq-light,qq-dark(原有主题全部保留,可随时在用户设置里切回)。 原 app.ini 会备份成 /etc/gitea/app.ini.bak-<时间戳>。

四、回滚

sudo tar xzf /var/backups/gitea-custom-<时间戳>.tar.gz -C /
sudo chown -R git:git /var/lib/gitea/custom
sudo systemctl restart gitea

五、部署后自查清单

  • https://git.qyhhh.top/ 首页 logo 变成蓝白 Git-Q,圆外无白框
  • 浏览器标签页 favicon 是新的小圆章
  • 顶栏、按钮、链接全部蓝白,无绿色残留
  • 代码块字体为 JetBrains Mono
  • 系统浅色/深色切换时,主题自动跟随(qq-auto)
  • 用户设置里仍能选回 github-auto 等旧主题(说明没破坏原有主题)
  • 无 500 错误、无模板解析报错(journalctl -u gitea -n 50 --no-pager)