diff --git a/customization/README.md b/customization/README.md index dc1a166..c860a92 100644 --- a/customization/README.md +++ b/customization/README.md @@ -69,6 +69,8 @@ Gitea 把模板 / 语言 / 静态资源都编进了二进制,但读取时走 `as | meta 作者/描述/关键词 | `[ui.meta] AUTHOR/DESCRIPTION/KEYWORDS` | `GITEA__ui_0X2E_meta__DESCRIPTION` 等 | | 页脚 Powered by / 版本号 | `[other] SHOW_FOOTER_POWERED_BY` / `SHOW_FOOTER_VERSION` | `GITEA__other__SHOW_FOOTER_POWERED_BY` | | 自定义主题配色 | `[ui] THEMES` + `custom/public/assets/css/theme-*.css` | `GITEA__ui__THEMES` | +| 关闭通行密钥(WebAuthn) | `[service] ENABLE_PASSKEY_AUTHENTICATION` | `GITEA__service__ENABLE_PASSKEY_AUTHENTICATION` | +| 关闭用户名/密码表单 | `[service] ENABLE_PASSWORD_SIGNIN_FORM` | `GITEA__service__ENABLE_PASSWORD_SIGNIN_FORM` | | Logo / favicon | 放 `custom/public/assets/img/{logo,favicon}.svg` 等 | 同上(文件方式) | > 环境变量规则:`GITEA__<段名>__<键名>`,段名里的 `.` 不能直接写,要编码成 @@ -103,6 +105,7 @@ customization/ ├── custom/ ★ 挂进容器的覆盖层(= $CustomPath 的内容) │ ├── templates/home.tmpl 落地页 │ ├── templates/base/head_navbar.tmpl 导航栏(去掉 docs.gitea.com) +│ ├── templates/user/auth/signin.tmpl 登录页(统一身份认证优先, 管理员登录次要) │ ├── public/assets/tjhlp/ask-guide.html 静态「提问指南」页(/assets/tjhlp/...) │ └── options/locale/locale_zh-CN.json 生成物,已 gitignore └── preview/ 本地预览(独立 compose,独立端口/数据) @@ -165,6 +168,27 @@ customization/preview/preview.sh reset # 清空预览数据重新来 - **模板改动仍需重启**(`reload`),这是 Gitea 的既有行为。 - 需要 docker 权限;当前 shell 不在 docker 组时脚本会自动改用 `sg docker -c`。 +### 3.4 登录页 + +登录页 `custom/templates/user/auth/signin.tmpl` 的结构是「统一身份认证(第一张卡) + +管理员登录(第二张卡)」,认证源那部分直接复用上游的 +`{{template "user/auth/external_auth_methods" .}}`,所以**换认证源不用改模板**。 + +预览实例默认没有配置任何认证源,登录页就只显示管理员卡片。想看到统一身份认证那张卡, +临时加一个认证源即可(用完删掉): + +```bash +# 加: 用 github 这类不需要 discovery 的 provider 最省事, 只为看布局 +sg docker -c "docker exec -u git gitea-preview gitea admin auth add-oauth \ + --name '高程统一身份认证(测试)' --provider github --key k --secret s" +sg docker -c 'docker exec -u git gitea-preview gitea admin auth list' # 看 ID +sg docker -c 'docker exec -u git gitea-preview gitea admin auth delete --id 1' +``` + +**通行密钥(WebAuthn)已关闭**,不是靠模板删的,而是配置: +`[service] ENABLE_PASSKEY_AUTHENTICATION = false`(两处 compose 都设了)。 +上游那块在浏览器不支持条件中介时会渲染成一个空的方框,关掉配置连区块都不再输出。 + --- ## 4. 纳入当前项目 & 部署 @@ -295,10 +319,12 @@ cd deploy && ./scripts/backup.sh --quiesce && docker compose pull gitea && docke - ✅ `custom/public/assets/tjhlp/ask-guide.html` 经 `/assets/` 正常访问 - ✅ zh-CN 整份覆盖后,仓库 Issue 页显示「创建 Issue / 前往 Issue」,不再出现「工单」 - ✅ 语言文件在 dev 模式下改动即生效(模板仍须重启) +- ✅ 登录页改成「统一身份认证」优先 + 「管理员登录」卡片,表单仍可正常登录/报错 +- ✅ 关闭 `ENABLE_PASSKEY_AUTHENTICATION` 后,登录页不再出现空的通行密钥方框 尚未覆盖(需要时按同样套路加): - Logo / favicon 换成本课程的图(需要设计稿;放到 `custom/public/assets/img/`) -- 登录页、注册页、错误页文案 +- 注册页(`user/auth/signup.tmpl`)、错误页文案 - 更多术语(合并请求 / 仓库 / 里程碑…)—— 在 `overrides/` 里加规则即可 - 自定义主题配色(`[ui] THEMES` + `custom/public/assets/css/theme-*.css`) diff --git a/customization/custom/templates/user/auth/signin.tmpl b/customization/custom/templates/user/auth/signin.tmpl new file mode 100644 index 0000000..90b24b9 --- /dev/null +++ b/customization/custom/templates/user/auth/signin.tmpl @@ -0,0 +1,92 @@ +{{/* + 登录页, 整文件覆盖 Gitea 内置 templates/user/auth/signin.tmpl。 + + 维护约定: + * 上游基线: customization/upstream/<版本>/templates/user/auth/signin.tmpl + 升级 Gitea 时先 diff 基线, 把上游的结构性改动(新增表单字段/新认证方式)合并回来。 + * 相对上游的改动只有布局, 逻辑尽量原样搬过来: + 1) 课程同学走的是「高程统一身份认证」(OIDC), 所以把它放进第一张卡片、配说明文字; + 卡片正文复用上游的 {{template "user/auth/external_auth_methods" .}}, + 将来新增/更换认证源不用改这个模板。 + 2) 用户名/密码降级为第二张「管理员登录」卡片, 并在正文里写明只有管理员/助教用。 + 3) 不再渲染通行密钥(passkey)区块 —— 上游那块只有 tw-hidden 的元素, 浏览器不支持 + 条件中介时会留下一个空的方框; 服务端已用 + [service] ENABLE_PASSKEY_AUTHENTICATION = false 关掉该功能。 + * 只用 Gitea 已编译进 CSS 的 class: Tailwind 工具类是按上游模板裁剪过的, + 新增 tw-* 前先 grep assets/css/index.css 确认存在(否则不会生效)。 + * 文案直接写中文(平台只面向中文用户), 表单标签仍走 ctx.Locale.Tr 以便跟随语言设置。 +*/}} +{{template "base/head" .}} +
+
+ {{/* 这些样式与内置模板保持一致, 同时作用于登录/注册/绑定账号页 */}} +
+
+ {{template "base/alert" .}} +
+ + {{$hasExternalAuth := or .OAuth2Providers .EnableOpenIDSignIn .EnableSSPI}} + {{if $hasExternalAuth}} +
+

登录 {{AppName}}

+
+

+ 同学们请使用高程统一身份认证登录, 账号密码与文档作业网站、编程作业网站相同。 +

+ {{template "user/auth/external_auth_methods" .}} +
+
+ {{end}} + + {{if .EnablePasswordSignInForm}} +
+

管理员登录

+
+

+ 此入口仅管理员与助教使用(本地账号)。同学们请使用上方的高程统一身份认证登录。 +

+
+
+ + +
+ {{if not .DisablePassword}} +
+
+ + {{ctx.Locale.Tr "auth.forgot_password"}} +
+ +
+ {{end}} +
+
+ + +
+
+ + {{template "user/auth/captcha" .}} + +
+ +
+
+
+
+ {{end}} + + {{if .ShowRegistrationButton}} +
+
+ {{ctx.Locale.Tr "auth.need_account"}} + {{ctx.Locale.Tr "auth.sign_up_now"}} +
+
+ {{end}} +
+
+
+{{template "base/footer" .}} diff --git a/customization/preview/preview.sh b/customization/preview/preview.sh index 84d59c3..eadefdb 100755 --- a/customization/preview/preview.sh +++ b/customization/preview/preview.sh @@ -126,6 +126,17 @@ check) ! grep -q "工单" "${ROOT}/custom/options/locale/locale_zh-CN.json" && ok "生成的 zh-CN 语言文件已无「工单」" || bad "语言文件里仍有「工单」" + # --- 登录页 ----------------------------------------------------------- + login="$(mktemp)" + curl -fsS -H 'Accept-Language: zh-CN' "${BASE_URL}/user/login" -o "${login}" + grep -q "管理员登录" "${login}" && + ok "登录页有独立的「管理员登录」卡片" || bad "登录页缺少管理员登录卡片" + ! grep -q "webauthn-error\|signin-passkey" "${login}" && + ok "登录页已无空的通行密钥(WebAuthn)方框" || bad "登录页仍有通行密钥区块" + grep -q 'id="external-login-navigator"' "${login}" || + echo " (提示: 预览未配置认证源, 登录页不显示统一身份认证按钮; 见 customization/README.md 3.4)" + rm -f "${login}" + [ "${fail}" = 0 ] && echo "全部检查通过" || echo "存在检查未通过项" exit "${fail}" ;; diff --git a/customization/upstream-files.txt b/customization/upstream-files.txt index 7a5e043..aa96a26 100644 --- a/customization/upstream-files.txt +++ b/customization/upstream-files.txt @@ -7,3 +7,4 @@ options/locale/locale_zh-CN.json templates/home.tmpl templates/base/head_navbar.tmpl +templates/user/auth/signin.tmpl diff --git a/customization/upstream/1.27.3/templates/user/auth/signin.tmpl b/customization/upstream/1.27.3/templates/user/auth/signin.tmpl new file mode 100644 index 0000000..935878e --- /dev/null +++ b/customization/upstream/1.27.3/templates/user/auth/signin.tmpl @@ -0,0 +1,10 @@ +{{template "base/head" .}} +
+
+ {{/* these styles are quite tricky and should also apply to the signup and link_account pages */}} +
+ {{template "user/auth/signin_inner" .}} +
+
+
+{{template "base/footer" .}}