SHA256
forked from course-team/tjhlp-gitea
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 个组织验证过)
|
||||
|
||||
尚未覆盖(需要时按同样套路加):
|
||||
|
||||
|
||||
Reference in New Issue
Block a user