SHA256
Compare commits
3
Commits
| Author | SHA256 | Date | |
|---|---|---|---|
|
|
1272c1ebec | ||
|
|
487c9e8726 | ||
|
|
787481c2c8 |
@@ -123,7 +123,8 @@ yamllint issue-templates/ # YAML 语法
|
|||||||
python3 customization/build.py # 生成定制语言文件
|
python3 customization/build.py # 生成定制语言文件
|
||||||
python3 customization/build.py --check # 校验生成物是否最新
|
python3 customization/build.py --check # 校验生成物是否最新
|
||||||
customization/preview/preview.sh up # 起本地预览(127.0.0.1:2081)
|
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);
|
机制调查、日常改法与部署/升级流程见 [`customization/README.md`](customization/README.md);
|
||||||
|
|||||||
+57
-13
@@ -106,7 +106,9 @@ customization/
|
|||||||
│ ├── templates/home.tmpl 落地页
|
│ ├── templates/home.tmpl 落地页
|
||||||
│ ├── templates/base/head_navbar.tmpl 导航栏(去掉 docs.gitea.com)
|
│ ├── templates/base/head_navbar.tmpl 导航栏(去掉 docs.gitea.com)
|
||||||
│ ├── templates/user/auth/signin.tmpl 登录页(统一身份认证优先, 管理员登录次要)
|
│ ├── templates/user/auth/signin.tmpl 登录页(统一身份认证优先, 管理员登录次要)
|
||||||
│ ├── public/assets/tjhlp/ask-guide.html 静态「提问指南」页(/assets/tjhlp/...)
|
│ ├── templates/user/dashboard/dashboard.tmpl 首页(登录后); 只比上游多一行 include
|
||||||
|
│ ├── templates/custom/tjhlp_semester_card.tmpl ★ 首页顶部的学期答疑入口卡片(自己写的)
|
||||||
|
│ ├── public/.gitkeep 占位(提问指南已只在官网, 目录留作将来放静态资源)
|
||||||
│ └── options/locale/locale_zh-CN.json 生成物,已 gitignore
|
│ └── options/locale/locale_zh-CN.json 生成物,已 gitignore
|
||||||
└── preview/ 本地预览(独立 compose,独立端口/数据)
|
└── preview/ 本地预览(独立 compose,独立端口/数据)
|
||||||
├── compose.yaml
|
├── compose.yaml
|
||||||
@@ -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 都设了)。
|
`[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. 纳入当前项目 & 部署
|
## 4. 纳入当前项目 & 部署
|
||||||
@@ -241,17 +278,22 @@ GITEA_CUSTOM_DIR=../customization/custom
|
|||||||
|
|
||||||
| 位置 | 内容 | 文件 |
|
| 位置 | 内容 | 文件 |
|
||||||
| ------ | ------ | ------ |
|
| ------ | ------ | ------ |
|
||||||
| 导航栏(未登录) | 「课程官网」 | `custom/templates/base/head_navbar.tmpl` |
|
| 导航栏(未登录) | 「课程官网」/「提问指南」 | `custom/templates/base/head_navbar.tmpl` |
|
||||||
| 用户菜单(已登录) | 「课程官网」 | 同上 |
|
| 用户菜单(已登录) | 「课程官网」/「提问指南」 | 同上 |
|
||||||
| 首页「按模板提问」卡片 | 官网《学会提问》 | `custom/templates/home.tmpl` |
|
| 首页「按模板提问」卡片 | 官网《提问指南》 | `custom/templates/home.tmpl` |
|
||||||
| 首页底部「相关站点」 | 官网 / 学会提问 / 常见问题 / 联系我们 | 同上 |
|
| 首页底部「相关站点」 | 官网 / 提问指南 / 常见问题 / 联系我们 | 同上 |
|
||||||
| 站内提问指南页 | 顶部提示与底部「相关站点」 | `custom/public/assets/tjhlp/ask-guide.html` |
|
| 首页答疑入口卡片 | 官网《提问指南》 | `custom/templates/custom/tjhlp_semester_card.tmpl` |
|
||||||
| 新建 Issue 页的引导链接 | 学会提问 / 课程官网 / 平台速查 | `issue-templates/*/.gitea/ISSUE_TEMPLATE/config.yaml` |
|
| 新建 Issue 页的引导链接 | 提问指南 / 课程官网 | `issue-templates/*/.gitea/ISSUE_TEMPLATE/config.yaml` |
|
||||||
|
|
||||||
> **改地址时要一起改的地方**:官网地址 `https://cpp.tongji.sh/Website/` 在上表前三行的文件
|
官网地址 `https://cpp.tongji.sh/Website/` 出现在上表列出的模板与两个 `config.yaml` 里;
|
||||||
> 与两个 `config.yaml` 里各出现一次;平台自身地址只在
|
平台自身地址只在 `scripts/settings.toml` 的 `gitea.public_url` 里维护一处(Issue 模板里的
|
||||||
> `scripts/settings.toml` 的 `gitea.public_url` 里维护一处(Issue 模板里的
|
`{{BASE_URL}}` 在推送时替换)。
|
||||||
> `{{BASE_URL}}` 在推送时替换)。
|
|
||||||
|
> **提问指南只在官网保留一份**(`/Website/qa/ask/`):平台内原来的副本
|
||||||
|
> `custom/public/assets/tjhlp/ask-guide.html` 已在 2026-09 删除, 相关链接全部指向官网。
|
||||||
|
> 官网 2026-09 改版后的路径: 提问指南 `/Website/qa/ask/`、常见问题 `/Website/qa/faq/`、
|
||||||
|
> 联系我们 `/Website/contact.html`; 旧的 `/Website/ask-question/`、`/Website/faq/`
|
||||||
|
> 只是跳转页, `/Website/contact` 已经 404 —— 不要再写这些旧地址。
|
||||||
|
|
||||||
反向的入口(官网 → 平台)在 Website 仓库里,方案见
|
反向的入口(官网 → 平台)在 Website 仓库里,方案见
|
||||||
[`website-linkage.md`](website-linkage.md)。
|
[`website-linkage.md`](website-linkage.md)。
|
||||||
@@ -315,12 +357,14 @@ cd deploy && ./scripts/backup.sh --quiesce && docker compose pull gitea && docke
|
|||||||
- ✅ 落地页替换为定制 `home.tmpl`(4 张卡片、无 Gitea 功能介绍)
|
- ✅ 落地页替换为定制 `home.tmpl`(4 张卡片、无 Gitea 功能介绍)
|
||||||
- ✅ `[ui.meta]` 元信息替换(`GITEA__ui_0X2E_meta__*` 编码有效)
|
- ✅ `[ui.meta]` 元信息替换(`GITEA__ui_0X2E_meta__*` 编码有效)
|
||||||
- ✅ 页脚 Powered by / 版本号可关闭
|
- ✅ 页脚 Powered by / 版本号可关闭
|
||||||
- ✅ 导航栏 `docs.gitea.com` 外链替换为课程提问指南(整文件覆盖 `head_navbar.tmpl`)
|
- ✅ 导航栏 `docs.gitea.com` 外链替换为官网《提问指南》(`/Website/qa/ask/`)
|
||||||
- ✅ `custom/public/assets/tjhlp/ask-guide.html` 经 `/assets/` 正常访问
|
- ✅ 平台内 `public/assets/tjhlp/ask-guide.html` 已删除, 页面与 Issue 模板全部指向官网
|
||||||
- ✅ zh-CN 整份覆盖后,仓库 Issue 页显示「创建 Issue / 前往 Issue」,不再出现「工单」
|
- ✅ zh-CN 整份覆盖后,仓库 Issue 页显示「创建 Issue / 前往 Issue」,不再出现「工单」
|
||||||
- ✅ 语言文件在 dev 模式下改动即生效(模板仍须重启)
|
- ✅ 语言文件在 dev 模式下改动即生效(模板仍须重启)
|
||||||
- ✅ 登录页改成「统一身份认证」优先 + 「管理员登录」卡片,表单仍可正常登录/报错
|
- ✅ 登录页改成「统一身份认证」优先 + 「管理员登录」卡片,表单仍可正常登录/报错
|
||||||
- ✅ 关闭 `ENABLE_PASSKEY_AUTHENTICATION` 后,登录页不再出现空的通行密钥方框
|
- ✅ 关闭 `ENABLE_PASSKEY_AUTHENTICATION` 后,登录页不再出现空的通行密钥方框
|
||||||
|
- ✅ 首页(登录后)顶部出现学期答疑入口卡片: 只认 `tjhlp-<5 位数字>`、取最新学期、
|
||||||
|
无匹配则不显示(预览里用 3 个用户 × 4 个组织验证过)
|
||||||
|
|
||||||
尚未覆盖(需要时按同样套路加):
|
尚未覆盖(需要时按同样套路加):
|
||||||
|
|
||||||
|
|||||||
+22
-11
@@ -41,8 +41,8 @@ ok "首页可访问"
|
|||||||
|
|
||||||
grep -q "先搜索,再提问" "${tmp}/home.html" &&
|
grep -q "先搜索,再提问" "${tmp}/home.html" &&
|
||||||
ok "首页用的是定制模板 home.tmpl" || bad "首页没有定制模板的内容"
|
ok "首页用的是定制模板 home.tmpl" || bad "首页没有定制模板的内容"
|
||||||
grep -q "assets/tjhlp/ask-guide.html" "${tmp}/home.html" &&
|
grep -q "https://cpp.tongji.sh/Website/qa/ask/" "${tmp}/home.html" &&
|
||||||
ok "导航栏/首页已指向课程提问指南" || bad "没找到提问指南链接"
|
ok "导航栏/首页已指向官网提问指南(/Website/qa/ask/)" || bad "没找到官网提问指南链接"
|
||||||
! grep -q "painless\|极易搭建\|Easy to install\|Cross-platform" "${tmp}/home.html" &&
|
! grep -q "painless\|极易搭建\|Easy to install\|Cross-platform" "${tmp}/home.html" &&
|
||||||
ok "首页已无 Gitea 功能介绍" || bad "首页仍有 Gitea 功能介绍文案"
|
ok "首页已无 Gitea 功能介绍" || bad "首页仍有 Gitea 功能介绍文案"
|
||||||
! grep -qi "powered by" "${tmp}/home.html" &&
|
! grep -qi "powered by" "${tmp}/home.html" &&
|
||||||
@@ -55,14 +55,16 @@ grep -q 'name="description" content="同济大学高级语言程序设计课程
|
|||||||
# --- 与课程官网的联动 -------------------------------------------------------
|
# --- 与课程官网的联动 -------------------------------------------------------
|
||||||
grep -q "https://cpp.tongji.sh/Website/" "${tmp}/home.html" &&
|
grep -q "https://cpp.tongji.sh/Website/" "${tmp}/home.html" &&
|
||||||
ok "首页/导航栏已链接课程官网" || bad "首页没有课程官网链接"
|
ok "首页/导航栏已链接课程官网" || bad "首页没有课程官网链接"
|
||||||
grep -q "https://cpp.tongji.sh/Website/ask-question/" "${tmp}/home.html" &&
|
grep -q "https://cpp.tongji.sh/Website/qa/ask/" "${tmp}/home.html" &&
|
||||||
ok "首页已链接官网《学会提问》" || bad "首页没有《学会提问》链接"
|
ok "首页已链接官网提问指南" || bad "首页没有官网提问指南链接"
|
||||||
if curl_ -fsS -o "${tmp}/guide.html" "${BASE_URL}/assets/tjhlp/ask-guide.html"; then
|
! grep -q "Website/ask-question/\|Website/faq/\|Website/contact\"" "${tmp}/home.html" &&
|
||||||
ok "custom/public 静态页可访问"
|
ok "没有指向官网已迁移/失效的旧地址" ||
|
||||||
grep -q "Website/ask-question/" "${tmp}/guide.html" &&
|
bad "仍有旧地址(ask-question / faq / contact 无 .html)"
|
||||||
ok "站内提问指南已回链官网" || bad "站内提问指南没有官网链接"
|
# 站内提问指南页已按决定删除: 提问指南只在官网保留一份
|
||||||
|
if curl_ -fsS -o /dev/null "${BASE_URL}/assets/tjhlp/ask-guide.html" 2>/dev/null; then
|
||||||
|
bad "平台内还留着 ask-guide.html(提问指南应只在官网)"
|
||||||
else
|
else
|
||||||
bad "提问指南静态页 404"
|
ok "平台内提问指南页已删除"
|
||||||
fi
|
fi
|
||||||
|
|
||||||
# --- 中文术语与登录页 -------------------------------------------------------
|
# --- 中文术语与登录页 -------------------------------------------------------
|
||||||
@@ -106,10 +108,19 @@ if [[ -d ${ROOT}/issue-templates ]]; then
|
|||||||
! grep -rq "example.com" "${ROOT}/issue-templates/" &&
|
! grep -rq "example.com" "${ROOT}/issue-templates/" &&
|
||||||
ok "Issue 模板已无 example.com 占位链接" || bad "Issue 模板里仍有 example.com"
|
ok "Issue 模板已无 example.com 占位链接" || bad "Issue 模板里仍有 example.com"
|
||||||
fi
|
fi
|
||||||
if [[ -f ${ROOT}/custom/options/locale/locale_zh-CN.json ]]; then
|
if [[ -f ${ROOT}/customization/custom/options/locale/locale_zh-CN.json ]]; then
|
||||||
! grep -q "工单" "${ROOT}/custom/options/locale/locale_zh-CN.json" &&
|
! grep -q "工单" "${ROOT}/customization/custom/options/locale/locale_zh-CN.json" &&
|
||||||
ok "生成的 zh-CN 语言文件已无「工单」" || bad "语言文件里仍有「工单」"
|
ok "生成的 zh-CN 语言文件已无「工单」" || bad "语言文件里仍有「工单」"
|
||||||
fi
|
fi
|
||||||
|
# 首页(登录后)的学期答疑入口卡片: 渲染结果需要登录才能看, 这里只断言模板层
|
||||||
|
# (运行时的渲染断言在 customization/preview/preview.sh check 里, 要登录)。
|
||||||
|
if [[ -f ${ROOT}/customization/custom/templates/custom/tjhlp_semester_card.tmpl ]]; then
|
||||||
|
grep -q "本学期答疑入口" "${ROOT}/customization/custom/templates/custom/tjhlp_semester_card.tmpl" &&
|
||||||
|
ok "首页答疑入口卡片模板在位" || bad "卡片模板里没有预期的内容"
|
||||||
|
grep -q 'template "custom/tjhlp_semester_card"' \
|
||||||
|
"${ROOT}/customization/custom/templates/user/dashboard/dashboard.tmpl" &&
|
||||||
|
ok "dashboard.tmpl 已 include 学期答疑入口卡片" || bad "dashboard.tmpl 没有 include 卡片"
|
||||||
|
fi
|
||||||
|
|
||||||
if [[ ${fail} == 0 ]]; then
|
if [[ ${fail} == 0 ]]; then
|
||||||
echo "全部检查通过"
|
echo "全部检查通过"
|
||||||
|
|||||||
@@ -0,0 +1,15 @@
|
|||||||
|
# 这个文件唯一的用途: 让 git 跟踪住这个(现在)空的目录。
|
||||||
|
#
|
||||||
|
# customization/custom/ 下的三个子目录会被逐个 bind mount 进容器:
|
||||||
|
# custom/options -> /data/gitea/options
|
||||||
|
# custom/public -> /data/gitea/public
|
||||||
|
# custom/templates-> /data/gitea/templates
|
||||||
|
#
|
||||||
|
# public/ 原来放的是站内「提问指南」静态页
|
||||||
|
# (public/assets/tjhlp/ask-guide.html)。2026-09 起提问指南只在课程官网保留一份
|
||||||
|
# (https://cpp.tongji.sh/Website/qa/ask/), 平台内的副本已删除, 这个目录就空了。
|
||||||
|
# 目录不能跟着消失: bind mount 的源目录不存在时 docker compose 会【以 root 创建】它,
|
||||||
|
# 之后普通用户/CI 都用不了(同样的坑见 options/.gitkeep)。
|
||||||
|
#
|
||||||
|
# 将来要往平台里放静态资源时, 直接加在 public/ 下即可(例如
|
||||||
|
# public/assets/img/logo.svg -> /QA/assets/img/logo.svg)。
|
||||||
@@ -1,88 +0,0 @@
|
|||||||
<!DOCTYPE html>
|
|
||||||
<html lang="zh-CN">
|
|
||||||
<head>
|
|
||||||
<meta charset="utf-8">
|
|
||||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
|
||||||
<title>提问指南 - 同济大学高级语言程序设计课程</title>
|
|
||||||
<!--
|
|
||||||
静态页, 通过 Gitea 的 custom/public/assets/ 机制对外提供:
|
|
||||||
customization/custom/public/assets/tjhlp/ask-guide.html
|
|
||||||
-> {{AppSubUrl}}/assets/tjhlp/ask-guide.html
|
|
||||||
Gitea 只对 custom/public 下的 robots.txt、.well-known/ 和 assets/ 做静态服务。
|
|
||||||
本页不依赖 Gitea 的 JS/CSS, 可离线打开, 便于直接改文案。
|
|
||||||
-->
|
|
||||||
<style>
|
|
||||||
:root { color-scheme: light dark; }
|
|
||||||
body {
|
|
||||||
margin: 0 auto; padding: 2.5rem 1.25rem 4rem; max-width: 46rem;
|
|
||||||
font: 16px/1.75 -apple-system, "Segoe UI", "Noto Sans CJK SC", "Microsoft YaHei", sans-serif;
|
|
||||||
}
|
|
||||||
h1 { font-size: 1.75rem; margin-bottom: .25rem; }
|
|
||||||
h2 { font-size: 1.15rem; margin-top: 2.25rem; border-bottom: 1px solid #8884; padding-bottom: .35rem; }
|
|
||||||
code { font-family: ui-monospace, SFMono-Regular, Menlo, monospace; background: #888280; padding: .1em .35em; border-radius: 4px; }
|
|
||||||
.lead { color: #666; margin-top: 0; }
|
|
||||||
table { border-collapse: collapse; width: 100%; }
|
|
||||||
th, td { text-align: left; padding: .45rem .6rem; border-bottom: 1px solid #8883; vertical-align: top; }
|
|
||||||
.tip { border-left: 3px solid #3b82f6; background: #3b82f614; padding: .75rem 1rem; border-radius: 0 6px 6px 0; }
|
|
||||||
ol, ul { padding-left: 1.4rem; }
|
|
||||||
</style>
|
|
||||||
</head>
|
|
||||||
<body>
|
|
||||||
<h1>提问指南</h1>
|
|
||||||
<p class="lead">同济大学高级语言程序设计课程 · 课程答疑平台</p>
|
|
||||||
|
|
||||||
<div class="tip">
|
|
||||||
提问规范以课程官网的<a href="https://cpp.tongji.sh/Website/ask-question/">《学会提问》</a>为准,
|
|
||||||
本页是它在答疑平台里的速查版。遇到问题请先看
|
|
||||||
<a href="https://cpp.tongji.sh/Website/faq/">官网常见问题</a>与
|
|
||||||
<a href="https://cpp.tongji.sh/Website/">课程官网</a>上的作业说明。
|
|
||||||
</div>
|
|
||||||
|
|
||||||
<h2>提问前</h2>
|
|
||||||
<ol>
|
|
||||||
<li>在答疑仓库的 Issue 列表里用关键词(题号、函数名、报错信息)搜索,确认没有人问过。</li>
|
|
||||||
<li>自己先调试一遍:编译是否通过、报错信息是什么、最小复现是哪几行。</li>
|
|
||||||
<li>确认问题出在<strong>课程要求</strong>或<strong>你的代码</strong>,而不是环境没有按要求配置。</li>
|
|
||||||
</ol>
|
|
||||||
|
|
||||||
<h2>如何提问</h2>
|
|
||||||
<p>在对应仓库点击 <code>创建 Issue</code>,选择合适的模板后按模板填写:</p>
|
|
||||||
<ul>
|
|
||||||
<li><strong>题目信息</strong>:作业编号、题号、题目要求的关键点。</li>
|
|
||||||
<li><strong>相关代码</strong>:只贴必要片段,用代码块包裹,说明你期望的结果。</li>
|
|
||||||
<li><strong>实际现象</strong>:完整报错信息或错误输出(不要只截图,文字更便于检索)。</li>
|
|
||||||
<li><strong>已尝试的做法</strong>:查过什么资料、改过什么、结果如何。</li>
|
|
||||||
</ul>
|
|
||||||
<div class="tip">提问写得越具体,助教越容易直接定位问题;「我的代码不对,帮忙看看」这类问题通常只能得到「请补充信息」的回复。</div>
|
|
||||||
|
|
||||||
<h2>仓库与标签</h2>
|
|
||||||
<table>
|
|
||||||
<thead><tr><th>位置</th><th>用途</th></tr></thead>
|
|
||||||
<tbody>
|
|
||||||
<tr><td><code>general</code></td><td>课程内容、环境配置等一般性问题</td></tr>
|
|
||||||
<tr><td><code>hwNN</code></td><td>第 NN 次作业的特定问题</td></tr>
|
|
||||||
</tbody>
|
|
||||||
</table>
|
|
||||||
<p>助教会用标签标记处理状态,常见含义:</p>
|
|
||||||
<ul>
|
|
||||||
<li><strong>重复</strong>:已有同样的问题,请到原 Issue 继续讨论。</li>
|
|
||||||
<li><strong>待补充信息</strong>:描述不足以定位,请按提示补充。</li>
|
|
||||||
<li><strong>已解决</strong>:问题已答复,请确认后自行关闭。</li>
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<h2>其它</h2>
|
|
||||||
<ul>
|
|
||||||
<li>不要在 Issue 里粘贴完整的学号、密码等个人信息。</li>
|
|
||||||
<li>作业截止前是提问高峰,助教按时间顺序处理,请耐心等待。</li>
|
|
||||||
<li>与个人成绩、抄袭认定相关的事情请直接联系老师,不要发在公开 Issue 里。</li>
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<h2>相关站点</h2>
|
|
||||||
<ul>
|
|
||||||
<li><a href="https://cpp.tongji.sh/Website/">课程官网</a>:课程信息、作业说明、环境配置、扩展阅读。</li>
|
|
||||||
<li><a href="https://cpp.tongji.sh/Website/ask-question/">学会提问</a>:完整的提问规范,提问前请通读。</li>
|
|
||||||
<li><a href="https://cpp.tongji.sh/Website/faq/">常见问题</a>:中文乱码、Visual Studio 配置等高频问题。</li>
|
|
||||||
<li><a href="https://cpp.tongji.sh/Website/contact">联系我们</a>:网站问题与课程团队联系方式。</li>
|
|
||||||
</ul>
|
|
||||||
</body>
|
|
||||||
</html>
|
|
||||||
@@ -43,7 +43,7 @@
|
|||||||
|
|
||||||
{{if not .IsSigned}}
|
{{if not .IsSigned}}
|
||||||
<a class="item" href="https://cpp.tongji.sh/Website/">课程官网</a>
|
<a class="item" href="https://cpp.tongji.sh/Website/">课程官网</a>
|
||||||
<a class="item" href="{{AppSubUrl}}/assets/tjhlp/ask-guide.html">提问指南</a>
|
<a class="item" href="https://cpp.tongji.sh/Website/qa/ask/">提问指南</a>
|
||||||
{{end}}
|
{{end}}
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
@@ -126,7 +126,7 @@
|
|||||||
{{svg "octicon-tools"}}
|
{{svg "octicon-tools"}}
|
||||||
{{ctx.Locale.Tr "your_settings"}}
|
{{ctx.Locale.Tr "your_settings"}}
|
||||||
</a>
|
</a>
|
||||||
<a class="item" href="{{AppSubUrl}}/assets/tjhlp/ask-guide.html">
|
<a class="item" href="https://cpp.tongji.sh/Website/qa/ask/">
|
||||||
{{svg "octicon-question"}}
|
{{svg "octicon-question"}}
|
||||||
提问指南
|
提问指南
|
||||||
</a>
|
</a>
|
||||||
|
|||||||
@@ -0,0 +1,56 @@
|
|||||||
|
{{/*
|
||||||
|
首页(登录后的仪表盘)顶部的「本学期答疑入口」大卡片。
|
||||||
|
这是本课程自己的模板, 不是上游文件; 插入点见
|
||||||
|
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="https://cpp.tongji.sh/Website/qa/ask/">提问指南</a>
|
||||||
|
</p>
|
||||||
|
<p style="margin:0;color:var(--color-text-light-3);font-size:.85rem">学期组织: {{$semester}}</p>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
{{end}}
|
||||||
@@ -7,9 +7,10 @@
|
|||||||
* 文案直接写中文(平台只面向中文用户), 不复用 Gitea 的 startpage.* 文案,
|
* 文案直接写中文(平台只面向中文用户), 不复用 Gitea 的 startpage.* 文案,
|
||||||
这样首页不再出现「一款极易搭建的自托管 Git 服务」之类的自我推销。
|
这样首页不再出现「一款极易搭建的自托管 Git 服务」之类的自我推销。
|
||||||
* 只改文案/图标/链接, 保留原有 class 与结构, 避免升级后样式失效。
|
* 只改文案/图标/链接, 保留原有 class 与结构, 避免升级后样式失效。
|
||||||
* 课程官网地址 https://cpp.tongji.sh/Website/ 在本文件、base/head_navbar.tmpl、
|
* 课程官网地址 https://cpp.tongji.sh/Website/ 出现在本文件、base/head_navbar.tmpl、
|
||||||
public/assets/tjhlp/ask-guide.html 以及 issue-templates 下两个 config.yaml 里
|
custom/tjhlp_semester_card.tmpl 以及 issue-templates 下两个 config.yaml 里,
|
||||||
各出现一次, 换域名/路径时这几处要一起改(见 customization/README.md「与官网联动」)。
|
换域名/路径时这几处要一起改(见 customization/README.md「与官网联动」)。
|
||||||
|
提问指南只在官网存一份: /Website/qa/ask/ —— 平台内不再保留副本(2026-09 起)。
|
||||||
*/}}
|
*/}}
|
||||||
{{template "base/head" .}}
|
{{template "base/head" .}}
|
||||||
<div role="main" aria-label="{{if .IsSigned}}{{ctx.Locale.Tr "dashboard"}}{{else}}{{ctx.Locale.Tr "home_title"}}{{end}}" class="page-content home">
|
<div role="main" aria-label="{{if .IsSigned}}{{ctx.Locale.Tr "dashboard"}}{{else}}{{ctx.Locale.Tr "home_title"}}{{end}}" class="page-content home">
|
||||||
@@ -41,8 +42,8 @@
|
|||||||
</h1>
|
</h1>
|
||||||
<p class="large tw-text-balance">
|
<p class="large tw-text-balance">
|
||||||
新建 Issue 时请选择合适的模板,写清题号、相关代码、报错信息和已经尝试过的做法。
|
新建 Issue 时请选择合适的模板,写清题号、相关代码、报错信息和已经尝试过的做法。
|
||||||
提问规范见课程官网<a href="https://cpp.tongji.sh/Website/ask-question/">《学会提问》</a>,
|
提问规范与具体做法见课程官网的
|
||||||
平台操作见<a href="{{AppSubUrl}}/assets/tjhlp/ask-guide.html">提问指南</a>。
|
<a href="https://cpp.tongji.sh/Website/qa/ask/">《提问指南》</a>。
|
||||||
</p>
|
</p>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
@@ -70,9 +71,9 @@
|
|||||||
<p class="large">
|
<p class="large">
|
||||||
相关站点:
|
相关站点:
|
||||||
<a href="https://cpp.tongji.sh/Website/">课程官网</a> ·
|
<a href="https://cpp.tongji.sh/Website/">课程官网</a> ·
|
||||||
<a href="https://cpp.tongji.sh/Website/ask-question/">学会提问</a> ·
|
<a href="https://cpp.tongji.sh/Website/qa/ask/">提问指南</a> ·
|
||||||
<a href="https://cpp.tongji.sh/Website/faq/">常见问题</a> ·
|
<a href="https://cpp.tongji.sh/Website/qa/faq/">常见问题</a> ·
|
||||||
<a href="https://cpp.tongji.sh/Website/contact">联系我们</a>
|
<a href="https://cpp.tongji.sh/Website/contact.html">联系我们</a>
|
||||||
</p>
|
</p>
|
||||||
<p>
|
<p>
|
||||||
<small>本平台只用于课程答疑,课程通知、作业要求等以课程官网与课程群为准。</small>
|
<small>本平台只用于课程答疑,课程通知、作业要求等以课程官网与课程群为准。</small>
|
||||||
|
|||||||
@@ -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 ps 查看状态
|
||||||
# ./preview.sh shell 进入容器
|
# ./preview.sh shell 进入容器
|
||||||
# ./preview.sh admin 在预览实例里建一个管理员(用于验证登录后的页面)
|
# ./preview.sh admin 在预览实例里建一个管理员(用于验证登录后的页面)
|
||||||
|
# ./preview.sh semester 造一个学期组织(含 general 仓库), 用于看首页的答疑入口卡片
|
||||||
# ./preview.sh check 构建校验 + 首页文案/页脚/元信息抽查
|
# ./preview.sh check 构建校验 + 首页文案/页脚/元信息抽查
|
||||||
#
|
#
|
||||||
# 说明: 本机 docker 需要 docker 组权限; 当前 shell 没有时会自动改用
|
# 说明: 本机 docker 需要 docker 组权限; 当前 shell 没有时会自动改用
|
||||||
@@ -86,6 +87,31 @@ admin)
|
|||||||
--email "${USERNAME}@example.com" --admin --must-change-password=false
|
--email "${USERNAME}@example.com" --admin --must-change-password=false
|
||||||
echo "管理员: ${USERNAME} / ${PASSWORD}"
|
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)
|
check)
|
||||||
python3 "${ROOT}/build.py" --check --quiet
|
python3 "${ROOT}/build.py" --check --quiet
|
||||||
fail=0
|
fail=0
|
||||||
@@ -100,7 +126,8 @@ check)
|
|||||||
curl -fsS "${BASE_URL}/" -o "${html}"
|
curl -fsS "${BASE_URL}/" -o "${html}"
|
||||||
|
|
||||||
grep -q "先搜索,再提问" "${html}" && ok "首页用的是定制模板 home.tmpl" || bad "首页没有定制模板的内容"
|
grep -q "先搜索,再提问" "${html}" && ok "首页用的是定制模板 home.tmpl" || bad "首页没有定制模板的内容"
|
||||||
grep -q "assets/tjhlp/ask-guide.html" "${html}" && ok "导航栏/首页已指向课程提问指南" || bad "没找到提问指南链接"
|
grep -q "https://cpp.tongji.sh/Website/qa/ask/" "${html}" &&
|
||||||
|
ok "导航栏/首页已指向官网提问指南(/Website/qa/ask/)" || bad "没找到官网提问指南链接"
|
||||||
! grep -q "painless\|极易搭建\|Easy to install\|Cross-platform" "${html}" &&
|
! grep -q "painless\|极易搭建\|Easy to install\|Cross-platform" "${html}" &&
|
||||||
ok "首页已无 Gitea 功能介绍" || bad "首页仍有 Gitea 功能介绍文案"
|
ok "首页已无 Gitea 功能介绍" || bad "首页仍有 Gitea 功能介绍文案"
|
||||||
! grep -qi "powered by" "${html}" && ok "页脚已无 Powered by Gitea" || bad "页脚仍有 Powered by"
|
! grep -qi "powered by" "${html}" && ok "页脚已无 Powered by Gitea" || bad "页脚仍有 Powered by"
|
||||||
@@ -108,18 +135,18 @@ check)
|
|||||||
grep -q 'name="description" content="同济大学高级语言程序设计课程答疑平台"' "${html}" &&
|
grep -q 'name="description" content="同济大学高级语言程序设计课程答疑平台"' "${html}" &&
|
||||||
ok "meta description 已替换" || bad "meta description 未替换"
|
ok "meta description 已替换" || bad "meta description 未替换"
|
||||||
|
|
||||||
curl -fsS -o /dev/null "${BASE_URL}/assets/tjhlp/ask-guide.html" &&
|
# 站内提问指南页已按决定删除(提问指南只在官网保留一份)
|
||||||
ok "custom/public 静态页可访问" || bad "提问指南静态页 404"
|
! curl -fsS -o /dev/null "${BASE_URL}/assets/tjhlp/ask-guide.html" 2>/dev/null &&
|
||||||
|
ok "平台内提问指南页已删除" || bad "平台内还留着 ask-guide.html"
|
||||||
|
|
||||||
# --- 与课程官网的联动 -------------------------------------------------
|
# --- 与课程官网的联动 -------------------------------------------------
|
||||||
grep -q "https://cpp.tongji.sh/Website/" "${html}" &&
|
grep -q "https://cpp.tongji.sh/Website/" "${html}" &&
|
||||||
ok "首页/导航栏已链接课程官网" || bad "首页没有课程官网链接"
|
ok "首页/导航栏已链接课程官网" || bad "首页没有课程官网链接"
|
||||||
grep -q "https://cpp.tongji.sh/Website/ask-question/" "${html}" &&
|
grep -q "https://cpp.tongji.sh/Website/qa/ask/" "${html}" &&
|
||||||
ok "首页已链接官网《学会提问》" || bad "首页没有《学会提问》链接"
|
ok "首页已链接官网提问指南" || bad "首页没有官网提问指南链接"
|
||||||
guide="$(mktemp)"
|
! grep -q "Website/ask-question/\|Website/faq/\|Website/contact\"" "${html}" &&
|
||||||
curl -fsS "${BASE_URL}/assets/tjhlp/ask-guide.html" -o "${guide}"
|
ok "没有指向官网已迁移/失效的旧地址" ||
|
||||||
grep -q "Website/ask-question/" "${guide}" && ok "站内提问指南已回链官网" || bad "站内提问指南没有官网链接"
|
bad "仍有旧地址(ask-question / faq / contact 无 .html)"
|
||||||
rm -f "${guide}"
|
|
||||||
! grep -rq "example.com" "${ROOT}/../issue-templates/" &&
|
! grep -rq "example.com" "${ROOT}/../issue-templates/" &&
|
||||||
ok "Issue 模板已无 example.com 占位链接" || bad "Issue 模板里仍有 example.com"
|
ok "Issue 模板已无 example.com 占位链接" || bad "Issue 模板里仍有 example.com"
|
||||||
|
|
||||||
@@ -137,6 +164,29 @@ check)
|
|||||||
echo " (提示: 预览未配置认证源, 登录页不显示统一身份认证按钮; 见 customization/README.md 3.4)"
|
echo " (提示: 预览未配置认证源, 登录页不显示统一身份认证按钮; 见 customization/README.md 3.4)"
|
||||||
rm -f "${login}"
|
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 "存在检查未通过项"
|
[ "${fail}" = 0 ] && echo "全部检查通过" || echo "存在检查未通过项"
|
||||||
exit "${fail}"
|
exit "${fail}"
|
||||||
;;
|
;;
|
||||||
|
|||||||
@@ -8,3 +8,4 @@ options/locale/locale_zh-CN.json
|
|||||||
templates/home.tmpl
|
templates/home.tmpl
|
||||||
templates/base/head_navbar.tmpl
|
templates/base/head_navbar.tmpl
|
||||||
templates/user/auth/signin.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" .}}
|
||||||
@@ -68,9 +68,15 @@
|
|||||||
Gitea 默认落地页(「一款极易搭建的自托管 Git 服务」), 定制上线后平台首页已换成答疑
|
Gitea 默认落地页(「一款极易搭建的自托管 Git 服务」), 定制上线后平台首页已换成答疑
|
||||||
平台介绍; 若截图里出现过「工单」字样也与现在的 「Issue」不一致。建议定制上线后按同样
|
平台介绍; 若截图里出现过「工单」字样也与现在的 「Issue」不一致。建议定制上线后按同样
|
||||||
流程重拍、**文件名不变**地替换, 这样正文不用改。
|
流程重拍、**文件名不变**地替换, 这样正文不用改。
|
||||||
11. **内容重复**:官网《学会提问》与平台内 `/assets/tjhlp/ask-guide.html` 有重叠。平台侧
|
11. **内容重复(已在平台侧处理完)**:官网提问指南与平台内的副本曾有重叠。2026-09 起
|
||||||
已把官网定为权威版本(站内页顶部注明"以官网为准"并给出链接), 官网页不必反向复制平台
|
**提问指南只在官网保留一份**(`/Website/qa/ask/`), 平台内的
|
||||||
操作细节, 链接到 `/faq/gitea/` 即可。
|
`/assets/tjhlp/ask-guide.html` 已删除, 平台页面与 Issue 模板的引导链接全部指向官网;
|
||||||
|
官网页因此不必再考虑与平台副本同步的问题。
|
||||||
|
|
||||||
|
> **2026-09 官网改版后的路径**:提问指南 `/Website/qa/ask/`、常见问题 `/Website/qa/faq/`、
|
||||||
|
> 联系我们 `/Website/contact.html`。旧的 `/Website/ask-question/`、`/Website/faq/` 已变成
|
||||||
|
> 跳转页, `/Website/contact` 已经 404。本文下面几节写于改版前, 里面的
|
||||||
|
> `/ask-question/`、`/contact.md` 等路径按新路径理解(PR #52 也要相应更新)。
|
||||||
|
|
||||||
## 3. 建议改动(可直接套用)
|
## 3. 建议改动(可直接套用)
|
||||||
|
|
||||||
|
|||||||
@@ -30,7 +30,8 @@ issue-templates/
|
|||||||
## config.yaml 里的链接与占位符
|
## config.yaml 里的链接与占位符
|
||||||
|
|
||||||
`config.yaml` 的 `contact_links` 是「新建 Issue」页面上的引导入口, 目前指向**课程官网**
|
`config.yaml` 的 `contact_links` 是「新建 Issue」页面上的引导入口, 目前指向**课程官网**
|
||||||
(学会提问 / 课程信息 / 常见问题), 把答疑平台和官网串起来。课程官网地址是硬编码常量
|
(提问指南 / 课程信息), 把答疑平台和官网串起来。提问指南只在官网保留一份
|
||||||
|
(`https://cpp.tongji.sh/Website/qa/ask/`, 平台内不再有副本); 课程官网地址是硬编码常量
|
||||||
(`https://cpp.tongji.sh/Website/`), 换域名时两个 `config.yaml` 要一起改。
|
(`https://cpp.tongji.sh/Website/`), 换域名时两个 `config.yaml` 要一起改。
|
||||||
|
|
||||||
平台自身的链接用占位符, 避免把学期组织名写死:
|
平台自身的链接用占位符, 避免把学期组织名写死:
|
||||||
|
|||||||
@@ -1,11 +1,8 @@
|
|||||||
blank_issues_enabled: false
|
blank_issues_enabled: false
|
||||||
contact_links:
|
contact_links:
|
||||||
- name: 提问前必读 · 学会提问
|
- name: 提问前必读 · 提问指南
|
||||||
url: https://cpp.tongji.sh/Website/ask-question/
|
url: https://cpp.tongji.sh/Website/qa/ask/
|
||||||
about: 课程官网上的提问规范。不合规范的提问很可能不会得到回答
|
about: 课程官网上的提问规范与做法。不合规范的提问很可能不会得到回答
|
||||||
- name: 课程官网
|
- name: 课程官网
|
||||||
url: https://cpp.tongji.sh/Website/
|
url: https://cpp.tongji.sh/Website/
|
||||||
about: 课程信息、作业说明、环境配置要求、常见问题
|
about: 课程信息、作业说明、环境配置要求、常见问题
|
||||||
- name: 答疑平台提问指南
|
|
||||||
url: "{{BASE_URL}}/assets/tjhlp/ask-guide.html"
|
|
||||||
about: 搜索 Issue、选择模板、填写信息、关闭 Issue 的平台内速查
|
|
||||||
|
|||||||
@@ -3,9 +3,9 @@ contact_links:
|
|||||||
- name: 一般性问题请到 general 仓库提问
|
- name: 一般性问题请到 general 仓库提问
|
||||||
url: "{{BASE_URL}}/{{ORG}}/general/issues/new/choose"
|
url: "{{BASE_URL}}/{{ORG}}/general/issues/new/choose"
|
||||||
about: 课程内容答疑、环境配置等非作业特定问题请到 general 仓库
|
about: 课程内容答疑、环境配置等非作业特定问题请到 general 仓库
|
||||||
- name: 提问前必读 · 学会提问
|
- name: 提问前必读 · 提问指南
|
||||||
url: https://cpp.tongji.sh/Website/ask-question/
|
url: https://cpp.tongji.sh/Website/qa/ask/
|
||||||
about: 课程官网上的提问规范。不合规范的提问很可能不会得到回答
|
about: 课程官网上的提问规范与做法。不合规范的提问很可能不会得到回答
|
||||||
- name: 课程官网
|
- name: 课程官网
|
||||||
url: https://cpp.tongji.sh/Website/
|
url: https://cpp.tongji.sh/Website/
|
||||||
about: 课程信息、作业说明、环境配置要求、常见问题
|
about: 课程信息、作业说明、环境配置要求、常见问题
|
||||||
|
|||||||
Reference in New Issue
Block a user