SHA256
feat: 首页(登录后)顶部加「本学期答疑入口」大卡片
登录后首页原本是贡献热力图/最近活动/仓库列表, 对只来提问的同学是干扰。
现在 navbar 之下、热力图之上插一张约 1/3 屏高(33vh)的卡片, 里面一个按钮直达
本学期答疑区, 顺带给出「提问指南」和官网《学会提问》的入口。
实现:
- custom/templates/user/dashboard/dashboard.tmpl: 覆盖上游同名模板,
只比上游多一行 {{template "custom/tjhlp_semester_card" .}}(便于升级时 diff)
- custom/templates/custom/tjhlp_semester_card.tmpl: 卡片本体(自己写的), 规则:
* 数据来自 .Orgs(当前用户所属组织)
* 学期组织 = 名字形如 tjhlp-<5 位数字>; 26271 => 26|27|1 => 2026-2027 学年第一学期
旧命名 tjhlp-2026s(带字母)、course-team 之类都不认
* 同时匹配多个取最新(名字最大), 按钮指向 <学期组织>/general/issues
* 一个都不匹配 => 整张卡片不显示
判定/文案都在这个文件里, 不依赖 Tailwind 工具类(用行内样式), 升级影响面最小
预览侧:
- preview.sh 新增 semester: 造学期组织 + general 仓库(幂等), 用于看卡片
- preview.sh check 增加登录后的断言(卡片存在 / 按钮链接 / 33vh), 现 17 项全过
预览里实测三个用户: previewadmin(在 26271/25261/2026s 三个组织里) -> 26271,
student1(只在 27282) -> 27282, student2(无组织) -> 不显示卡片且页面正常
This commit is contained in:
@@ -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 个组织验证过)
|
||||
|
||||
尚未覆盖(需要时按同样套路加):
|
||||
|
||||
|
||||
@@ -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}}
|
||||
<div class="ui container tw-mb-4">
|
||||
{{/* 33vh ≈ 屏幕纵向的 1/3; 用行内样式, 不依赖 Tailwind 是否收录了某个工具类 */}}
|
||||
<div class="ui segment" style="min-height:33vh;display:flex;flex-direction:column;justify-content:center;align-items:center;text-align:center;gap:1rem;padding:1.5rem 1rem">
|
||||
<h2 style="margin:0">本学期答疑入口</h2>
|
||||
<p style="margin:0;color:var(--color-text-light-2)">
|
||||
课程问题请进入下面的答疑区提问(一条 Issue 一个问题), 助教与老师会在那里回复。
|
||||
</p>
|
||||
<a class="ui primary fluid button" style="font-size:1.35rem;padding:1rem;max-width:34rem"
|
||||
href="{{AppSubUrl}}/{{$semester}}/general/issues">
|
||||
进入{{$label}}答疑区
|
||||
</a>
|
||||
<p style="margin:0;color:var(--color-text-light-2)">
|
||||
第一次提问? 先看<a href="{{AppSubUrl}}/assets/tjhlp/ask-guide.html">提问指南</a>
|
||||
(也可以看<a href="https://cpp.tongji.sh/Website/ask-question/">课程官网的《学会提问》</a>)
|
||||
</p>
|
||||
<p style="margin:0;color:var(--color-text-light-3);font-size:.85rem">学期组织: {{$semester}}</p>
|
||||
</div>
|
||||
</div>
|
||||
{{end}}
|
||||
@@ -0,0 +1,22 @@
|
||||
{{template "base/head" .}}
|
||||
<div role="main" aria-label="{{.Title}}" class="page-content dashboard feeds">
|
||||
{{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" .}}
|
||||
<div class="ui container flex-container">
|
||||
<div class="flex-container-main">
|
||||
{{template "base/alert" .}}
|
||||
{{template "user/heatmap" .}}
|
||||
{{if .Page.Paginater.TotalPages}}
|
||||
{{template "user/dashboard/feeds" .}}
|
||||
{{else}}
|
||||
{{template "user/dashboard/guide" .}}
|
||||
{{end}}
|
||||
</div>
|
||||
{{template "user/dashboard/repolist" .}}
|
||||
</div>
|
||||
</div>
|
||||
{{template "base/footer" .}}
|
||||
@@ -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}"
|
||||
;;
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -0,0 +1,17 @@
|
||||
{{template "base/head" .}}
|
||||
<div role="main" aria-label="{{.Title}}" class="page-content dashboard feeds">
|
||||
{{template "user/dashboard/navbar" .}}
|
||||
<div class="ui container flex-container">
|
||||
<div class="flex-container-main">
|
||||
{{template "base/alert" .}}
|
||||
{{template "user/heatmap" .}}
|
||||
{{if .Page.Paginater.TotalPages}}
|
||||
{{template "user/dashboard/feeds" .}}
|
||||
{{else}}
|
||||
{{template "user/dashboard/guide" .}}
|
||||
{{end}}
|
||||
</div>
|
||||
{{template "user/dashboard/repolist" .}}
|
||||
</div>
|
||||
</div>
|
||||
{{template "base/footer" .}}
|
||||
Reference in New Issue
Block a user