diff --git a/README.md b/README.md index a729d7a..95bf010 100644 --- a/README.md +++ b/README.md @@ -123,7 +123,8 @@ yamllint issue-templates/ # YAML 语法 python3 customization/build.py # 生成定制语言文件 python3 customization/build.py --check # 校验生成物是否最新 customization/preview/preview.sh up # 起本地预览(127.0.0.1:2081) -customization/preview/preview.sh check # 自动校验首页/页脚/meta/术语 +customization/preview/preview.sh semester # 造一个学期组织, 看首页答疑入口卡片 +customization/preview/preview.sh check # 自动校验首页/登录页/卡片/页脚/meta/术语 ``` 机制调查、日常改法与部署/升级流程见 [`customization/README.md`](customization/README.md); diff --git a/customization/README.md b/customization/README.md index c860a92..3e6989f 100644 --- a/customization/README.md +++ b/customization/README.md @@ -106,6 +106,8 @@ customization/ │ ├── templates/home.tmpl 落地页 │ ├── templates/base/head_navbar.tmpl 导航栏(去掉 docs.gitea.com) │ ├── templates/user/auth/signin.tmpl 登录页(统一身份认证优先, 管理员登录次要) +│ ├── templates/user/dashboard/dashboard.tmpl 首页(登录后); 只比上游多一行 include +│ ├── templates/custom/tjhlp_semester_card.tmpl ★ 首页顶部的学期答疑入口卡片(自己写的) │ ├── public/assets/tjhlp/ask-guide.html 静态「提问指南」页(/assets/tjhlp/...) │ └── options/locale/locale_zh-CN.json 生成物,已 gitignore └── preview/ 本地预览(独立 compose,独立端口/数据) @@ -189,6 +191,41 @@ sg docker -c 'docker exec -u git gitea-preview gitea admin auth delete --id 1' `[service] ENABLE_PASSKEY_AUTHENTICATION = false`(两处 compose 都设了)。 上游那块在浏览器不支持条件中介时会渲染成一个空的方框,关掉配置连区块都不再输出。 +### 3.5 首页(登录后)的「本学期答疑入口」卡片 + +登录后首页上游会给贡献热力图、最近活动、仓库列表, 对只来提问的同学是干扰。 +我们在页面顶部加了一张约 1/3 屏高的卡片, 里面一个按钮直接跳到本学期答疑区。 + +涉及两个文件: + +| 文件 | 作用 | +|---|---| +| `custom/templates/user/dashboard/dashboard.tmpl` | 覆盖上游同名模板, **只比上游多一行** `{{template "custom/tjhlp_semester_card" .}}`(插在 navbar 之后、`flex-container` 之前) | +| `custom/templates/custom/tjhlp_semester_card.tmpl` | 卡片本身(本课程自己写的, 上游没有这个文件) | + +判定与规则(都在卡片文件里, 改它就行): + +- 数据来自 `.Orgs` —— 当前登录用户所属的全部组织(`routers/web/user/home.go` 的 Dashboard 注入); +- 「学期组织」= 名字形如 `tjhlp-<5 位数字>`: `tjhlp-26271` 表示 26|27|1 → + 2026-2027 学年第一学期; 旧命名 `tjhlp-2026s`(带字母)不认, 其它前缀(`course-team`)也不认; +- 同时匹配多个时取**名字最大**的(即最新学期), 所以同学同时在上学期/本学期组织里也只会看到本学期; +- 按钮指向 `{{AppSubUrl}}/<学期组织>/general/issues` + —— 依赖「每个学期组织都有一个 `general` 仓库」这个约定(`tjhlp setup init` 会建); +- 一个都匹配不上就**整张卡片不显示**(宁可不显示, 也不给同学一个错的入口)。 + +预览里怎么看: + +```bash +./preview.sh admin # 先有管理员(仅首次) +./preview.sh semester # 建 tjhlp-26271 + general 仓库, 创建者即成员 +# 想验证筛选规则, 再建几个干扰项: 旧的 tjhlp-25261 / 带字母的 tjhlp-2026s +./preview.sh semester previewadmin previewadmin123 tjhlp-2026s +# 然后浏览器登录 http://127.0.0.1:2081 (previewadmin / previewadmin123) 看首页 +``` + +`./preview.sh check` 会自动登录 previewadmin 抓一次首页, 断言卡片存在、按钮指向 +`<学期组织>/general/issues`、高度是 `33vh`。 + --- ## 4. 纳入当前项目 & 部署 @@ -321,6 +358,8 @@ cd deploy && ./scripts/backup.sh --quiesce && docker compose pull gitea && docke - ✅ 语言文件在 dev 模式下改动即生效(模板仍须重启) - ✅ 登录页改成「统一身份认证」优先 + 「管理员登录」卡片,表单仍可正常登录/报错 - ✅ 关闭 `ENABLE_PASSKEY_AUTHENTICATION` 后,登录页不再出现空的通行密钥方框 +- ✅ 首页(登录后)顶部出现学期答疑入口卡片: 只认 `tjhlp-<5 位数字>`、取最新学期、 + 无匹配则不显示(预览里用 3 个用户 × 4 个组织验证过) 尚未覆盖(需要时按同样套路加): diff --git a/customization/custom/templates/custom/tjhlp_semester_card.tmpl b/customization/custom/templates/custom/tjhlp_semester_card.tmpl new file mode 100644 index 0000000..316e126 --- /dev/null +++ b/customization/custom/templates/custom/tjhlp_semester_card.tmpl @@ -0,0 +1,57 @@ +{{/* + 首页(登录后的仪表盘)顶部的「本学期答疑入口」大卡片。 + 这是本课程自己的模板, 不是上游文件; 插入点见 + custom/templates/user/dashboard/dashboard.tmpl(只比上游多一行 include)。 + + 逻辑: + * .Orgs = 当前用户所属的全部组织, 由 routers/web/user/home.go 的 Dashboard + 处理器注入(organization.GetUserOrgsList, 按 lower_name 升序); + * 「学期组织」的判定 = 名字形如 tjhlp-<5 位数字>, 例如 + tjhlp-26271 = 2026-2027 学年第一学期(26|27|1) + 旧命名 tjhlp-2026s 这种带字母的不算, 也不认其它前缀的组织; + * 取其中名字最大(即最新学期)的一个; + * 渲染成一张约 1/3 屏高的大卡片, 按钮直达该组织的 general 仓库 Issue 区。 + + 匹配不上就整张卡片不显示: 宁可什么都不显示, 也不要给同学一个错的入口。 + 改判定规则/文案只需要动这个文件(不要动 dashboard.tmpl 的其余部分)。 +*/}} +{{$semester := ""}} +{{range .Orgs}} + {{$name := .Name}} + {{$code := StringUtils.TrimPrefix $name "tjhlp-"}} + {{if and + (ne $code $name) + (eq (len $code) 5) + (StringUtils.Contains "0123456789" (slice $code 0 1)) + (StringUtils.Contains "0123456789" (slice $code 1 2)) + (StringUtils.Contains "0123456789" (slice $code 2 3)) + (StringUtils.Contains "0123456789" (slice $code 3 4)) + (StringUtils.Contains "0123456789" (slice $code 4 5))}} + {{if or (eq $semester "") (gt $name $semester)}}{{$semester = $name}}{{end}} + {{end}} +{{end}} +{{if $semester}} + {{$code := StringUtils.TrimPrefix $semester "tjhlp-"}} + {{$term := slice $code 4 5}} + {{$termText := printf "第%s学期" $term}} + {{if eq $term "1"}}{{$termText = "第一学期"}}{{else if eq $term "2"}}{{$termText = "第二学期"}}{{end}} + {{$label := printf "20%s-20%s 学年%s" (slice $code 0 2) (slice $code 2 4) $termText}} +
+ {{/* 33vh ≈ 屏幕纵向的 1/3; 用行内样式, 不依赖 Tailwind 是否收录了某个工具类 */}} +
+

本学期答疑入口

+

+ 课程问题请进入下面的答疑区提问(一条 Issue 一个问题), 助教与老师会在那里回复。 +

+ + 进入{{$label}}答疑区 + +

+ 第一次提问? 先看提问指南 + (也可以看课程官网的《学会提问》) +

+

学期组织: {{$semester}}

+
+
+{{end}} diff --git a/customization/custom/templates/user/dashboard/dashboard.tmpl b/customization/custom/templates/user/dashboard/dashboard.tmpl new file mode 100644 index 0000000..b779156 --- /dev/null +++ b/customization/custom/templates/user/dashboard/dashboard.tmpl @@ -0,0 +1,22 @@ +{{template "base/head" .}} +
+ {{template "user/dashboard/navbar" .}} + {{/* ★ 本课程新增(上游没有这一行): 首页顶部的「本学期答疑入口」卡片。 + 卡片内容在 custom/templates/custom/tjhlp_semester_card.tmpl; + 升级 Gitea 时先 diff upstream/<版本>/templates/user/dashboard/dashboard.tmpl, + 确认上游结构变化后把这一行重新插到 navbar 之后即可。 */}} + {{template "custom/tjhlp_semester_card" .}} +
+
+ {{template "base/alert" .}} + {{template "user/heatmap" .}} + {{if .Page.Paginater.TotalPages}} + {{template "user/dashboard/feeds" .}} + {{else}} + {{template "user/dashboard/guide" .}} + {{end}} +
+ {{template "user/dashboard/repolist" .}} +
+
+{{template "base/footer" .}} diff --git a/customization/preview/preview.sh b/customization/preview/preview.sh index eadefdb..46e3bde 100755 --- a/customization/preview/preview.sh +++ b/customization/preview/preview.sh @@ -8,6 +8,7 @@ # ./preview.sh ps 查看状态 # ./preview.sh shell 进入容器 # ./preview.sh admin 在预览实例里建一个管理员(用于验证登录后的页面) +# ./preview.sh semester 造一个学期组织(含 general 仓库), 用于看首页的答疑入口卡片 # ./preview.sh check 构建校验 + 首页文案/页脚/元信息抽查 # # 说明: 本机 docker 需要 docker 组权限; 当前 shell 没有时会自动改用 @@ -86,6 +87,31 @@ admin) --email "${USERNAME}@example.com" --admin --must-change-password=false echo "管理员: ${USERNAME} / ${PASSWORD}" ;; +semester) + # 造一个学期组织 + general 仓库, 用来在预览里验证首页(登录后)的答疑入口卡片。 + # 幂等: 已存在就跳过。默认建 tjhlp-26271(2026-2027 学年第一学期 的命名), + # 想验证"只认最新学期/不认旧命名"可以再建几个: + # ./preview.sh semester previewadmin previewadmin123 tjhlp-25261 + # ./preview.sh semester previewadmin previewadmin123 tjhlp-2026s + USERNAME="${2:-previewadmin}" + PASSWORD="${3:-previewadmin123}" + ORG="${4:-tjhlp-26271}" + api() { curl -fsS --noproxy '*' -u "${USERNAME}:${PASSWORD}" -H 'Content-Type: application/json' "$@"; } + if api "${BASE_URL}/api/v1/orgs/${ORG}" >/dev/null 2>&1; then + echo "组织 ${ORG} 已存在, 跳过创建" + else + api -X POST -d "{\"username\":\"${ORG}\",\"full_name\":\"${ORG}\"}" "${BASE_URL}/api/v1/orgs" >/dev/null + echo "已创建组织 ${ORG}(创建者即成员, 也就是 ${USERNAME})" + fi + if api "${BASE_URL}/api/v1/repos/${ORG}/general" >/dev/null 2>&1; then + echo "仓库 ${ORG}/general 已存在" + else + api -X POST -d '{"name":"general","auto_init":true,"private":true}' \ + "${BASE_URL}/api/v1/orgs/${ORG}/repos" >/dev/null + echo "已创建仓库 ${ORG}/general" + fi + echo "用 ${USERNAME} 登录 ${BASE_URL} 看首页卡片; 期望按钮指向 ${ORG}/general/issues" + ;; check) python3 "${ROOT}/build.py" --check --quiet fail=0 @@ -137,6 +163,29 @@ check) echo " (提示: 预览未配置认证源, 登录页不显示统一身份认证按钮; 见 customization/README.md 3.4)" rm -f "${login}" + # --- 首页(登录后)的「本学期答疑入口」卡片 ----------------------------- + # 预览里没有管理员/学期组织时会跳过(只提示), 不算失败。 + cj="$(mktemp)" + dash="$(mktemp)" + trap 'rm -f "${html}" "${cj}" "${dash}"' EXIT + curl -fsS -c "${cj}" -b "${cj}" -X POST \ + --data-urlencode "user_name=${PREVIEW_ADMIN_USER:-previewadmin}" \ + --data-urlencode "password=${PREVIEW_ADMIN_PASSWORD:-previewadmin123}" \ + "${BASE_URL}/user/login" -o /dev/null || true + curl -fsS -b "${cj}" "${BASE_URL}/" -o "${dash}" || true + if ! grep -q 'class="page-content dashboard' "${dash}"; then + echo " (提示: 预览里没有可登录的 previewadmin; 跑 ./preview.sh admin 后再检查登录后页面)" + elif grep -q "本学期答疑入口" "${dash}"; then + ok "首页(登录后)有「本学期答疑入口」卡片" + grep -q "/tjhlp-[0-9]\{5\}/general/issues" "${dash}" && + ok "卡片按钮指向 <学期组织>/general/issues" || + bad "卡片按钮链接不是 <学期组织>/general/issues" + grep -q "min-height:33vh" "${dash}" && + ok "卡片高度约 1/3 屏(33vh)" || bad "卡片没有 33vh 高度" + else + echo " (提示: 当前登录用户不属于任何学期组织 => 卡片不显示; 跑 ./preview.sh semester 造一个)" + fi + [ "${fail}" = 0 ] && echo "全部检查通过" || echo "存在检查未通过项" exit "${fail}" ;; diff --git a/customization/upstream-files.txt b/customization/upstream-files.txt index aa96a26..e15736e 100644 --- a/customization/upstream-files.txt +++ b/customization/upstream-files.txt @@ -8,3 +8,4 @@ options/locale/locale_zh-CN.json templates/home.tmpl templates/base/head_navbar.tmpl templates/user/auth/signin.tmpl +templates/user/dashboard/dashboard.tmpl diff --git a/customization/upstream/1.27.3/templates/user/dashboard/dashboard.tmpl b/customization/upstream/1.27.3/templates/user/dashboard/dashboard.tmpl new file mode 100644 index 0000000..dc7a3fe --- /dev/null +++ b/customization/upstream/1.27.3/templates/user/dashboard/dashboard.tmpl @@ -0,0 +1,17 @@ +{{template "base/head" .}} +
+ {{template "user/dashboard/navbar" .}} +
+
+ {{template "base/alert" .}} + {{template "user/heatmap" .}} + {{if .Page.Paginater.TotalPages}} + {{template "user/dashboard/feeds" .}} + {{else}} + {{template "user/dashboard/guide" .}} + {{end}} +
+ {{template "user/dashboard/repolist" .}} +
+
+{{template "base/footer" .}}