新建 Issue 时请选择合适的模板,写清题号、相关代码、报错信息和已经尝试过的做法。 - 提问规范见课程官网《学会提问》, - 平台操作见提问指南。 + 提问规范与具体做法见课程官网的 + 《提问指南》。
diff --git a/customization/README.md b/customization/README.md index 3e6989f..d3082a4 100644 --- a/customization/README.md +++ b/customization/README.md @@ -108,7 +108,7 @@ customization/ │ ├── 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/...) +│ ├── public/.gitkeep 占位(提问指南已只在官网, 目录留作将来放静态资源) │ └── options/locale/locale_zh-CN.json 生成物,已 gitignore └── preview/ 本地预览(独立 compose,独立端口/数据) ├── compose.yaml @@ -278,17 +278,22 @@ GITEA_CUSTOM_DIR=../customization/custom | 位置 | 内容 | 文件 | | ------ | ------ | ------ | -| 导航栏(未登录) | 「课程官网」 | `custom/templates/base/head_navbar.tmpl` | -| 用户菜单(已登录) | 「课程官网」 | 同上 | -| 首页「按模板提问」卡片 | 官网《学会提问》 | `custom/templates/home.tmpl` | -| 首页底部「相关站点」 | 官网 / 学会提问 / 常见问题 / 联系我们 | 同上 | -| 站内提问指南页 | 顶部提示与底部「相关站点」 | `custom/public/assets/tjhlp/ask-guide.html` | -| 新建 Issue 页的引导链接 | 学会提问 / 课程官网 / 平台速查 | `issue-templates/*/.gitea/ISSUE_TEMPLATE/config.yaml` | +| 导航栏(未登录) | 「课程官网」/「提问指南」 | `custom/templates/base/head_navbar.tmpl` | +| 用户菜单(已登录) | 「课程官网」/「提问指南」 | 同上 | +| 首页「按模板提问」卡片 | 官网《提问指南》 | `custom/templates/home.tmpl` | +| 首页底部「相关站点」 | 官网 / 提问指南 / 常见问题 / 联系我们 | 同上 | +| 首页答疑入口卡片 | 官网《提问指南》 | `custom/templates/custom/tjhlp_semester_card.tmpl` | +| 新建 Issue 页的引导链接 | 提问指南 / 课程官网 | `issue-templates/*/.gitea/ISSUE_TEMPLATE/config.yaml` | -> **改地址时要一起改的地方**:官网地址 `http://10.80.42.185/Website/` 在上表前三行的文件 -> 与两个 `config.yaml` 里各出现一次;平台自身地址只在 -> `scripts/settings.toml` 的 `gitea.public_url` 里维护一处(Issue 模板里的 -> `{{BASE_URL}}` 在推送时替换)。 +官网地址 `http://10.80.42.185/Website/` 出现在上表列出的模板与两个 `config.yaml` 里; +平台自身地址只在 `scripts/settings.toml` 的 `gitea.public_url` 里维护一处(Issue 模板里的 +`{{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-linkage.md`](website-linkage.md)。 @@ -352,8 +357,8 @@ cd deploy && ./scripts/backup.sh --quiesce && docker compose pull gitea && docke - ✅ 落地页替换为定制 `home.tmpl`(4 张卡片、无 Gitea 功能介绍) - ✅ `[ui.meta]` 元信息替换(`GITEA__ui_0X2E_meta__*` 编码有效) - ✅ 页脚 Powered by / 版本号可关闭 -- ✅ 导航栏 `docs.gitea.com` 外链替换为课程提问指南(整文件覆盖 `head_navbar.tmpl`) -- ✅ `custom/public/assets/tjhlp/ask-guide.html` 经 `/assets/` 正常访问 +- ✅ 导航栏 `docs.gitea.com` 外链替换为官网《提问指南》(`/Website/qa/ask/`) +- ✅ 平台内 `public/assets/tjhlp/ask-guide.html` 已删除, 页面与 Issue 模板全部指向官网 - ✅ zh-CN 整份覆盖后,仓库 Issue 页显示「创建 Issue / 前往 Issue」,不再出现「工单」 - ✅ 语言文件在 dev 模式下改动即生效(模板仍须重启) - ✅ 登录页改成「统一身份认证」优先 + 「管理员登录」卡片,表单仍可正常登录/报错 diff --git a/customization/check.sh b/customization/check.sh index 18616aa..6111464 100755 --- a/customization/check.sh +++ b/customization/check.sh @@ -41,8 +41,8 @@ ok "首页可访问" grep -q "先搜索,再提问" "${tmp}/home.html" && ok "首页用的是定制模板 home.tmpl" || bad "首页没有定制模板的内容" -grep -q "assets/tjhlp/ask-guide.html" "${tmp}/home.html" && - ok "导航栏/首页已指向课程提问指南" || bad "没找到提问指南链接" +grep -q "http://10.80.42.185/Website/qa/ask/" "${tmp}/home.html" && + ok "导航栏/首页已指向官网提问指南(/Website/qa/ask/)" || bad "没找到官网提问指南链接" ! grep -q "painless\|极易搭建\|Easy to install\|Cross-platform" "${tmp}/home.html" && ok "首页已无 Gitea 功能介绍" || bad "首页仍有 Gitea 功能介绍文案" ! grep -qi "powered by" "${tmp}/home.html" && @@ -55,14 +55,16 @@ grep -q 'name="description" content="同济大学高级语言程序设计课程 # --- 与课程官网的联动 ------------------------------------------------------- grep -q "http://10.80.42.185/Website/" "${tmp}/home.html" && ok "首页/导航栏已链接课程官网" || bad "首页没有课程官网链接" -grep -q "http://10.80.42.185/Website/ask-question/" "${tmp}/home.html" && - ok "首页已链接官网《学会提问》" || bad "首页没有《学会提问》链接" -if curl_ -fsS -o "${tmp}/guide.html" "${BASE_URL}/assets/tjhlp/ask-guide.html"; then - ok "custom/public 静态页可访问" - grep -q "Website/ask-question/" "${tmp}/guide.html" && - ok "站内提问指南已回链官网" || bad "站内提问指南没有官网链接" +grep -q "http://10.80.42.185/Website/qa/ask/" "${tmp}/home.html" && + ok "首页已链接官网提问指南" || bad "首页没有官网提问指南链接" +! grep -q "Website/ask-question/\|Website/faq/\|Website/contact\"" "${tmp}/home.html" && + ok "没有指向官网已迁移/失效的旧地址" || + bad "仍有旧地址(ask-question / faq / contact 无 .html)" +# 站内提问指南页已按决定删除: 提问指南只在官网保留一份 +if curl_ -fsS -o /dev/null "${BASE_URL}/assets/tjhlp/ask-guide.html" 2>/dev/null; then + bad "平台内还留着 ask-guide.html(提问指南应只在官网)" else - bad "提问指南静态页 404" + ok "平台内提问指南页已删除" fi # --- 中文术语与登录页 ------------------------------------------------------- diff --git a/customization/custom/public/.gitkeep b/customization/custom/public/.gitkeep new file mode 100644 index 0000000..4327ba7 --- /dev/null +++ b/customization/custom/public/.gitkeep @@ -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 起提问指南只在课程官网保留一份 +# (http://10.80.42.185/Website/qa/ask/), 平台内的副本已删除, 这个目录就空了。 +# 目录不能跟着消失: bind mount 的源目录不存在时 docker compose 会【以 root 创建】它, +# 之后普通用户/CI 都用不了(同样的坑见 options/.gitkeep)。 +# +# 将来要往平台里放静态资源时, 直接加在 public/ 下即可(例如 +# public/assets/img/logo.svg -> /QA/assets/img/logo.svg)。 diff --git a/customization/custom/public/assets/tjhlp/ask-guide.html b/customization/custom/public/assets/tjhlp/ask-guide.html deleted file mode 100644 index b30de22..0000000 --- a/customization/custom/public/assets/tjhlp/ask-guide.html +++ /dev/null @@ -1,88 +0,0 @@ - - -
- - -同济大学高级语言程序设计课程 · 课程答疑平台
- - - -在对应仓库点击 创建 Issue,选择合适的模板后按模板填写:
| 位置 | 用途 |
|---|---|
general | 课程内容、环境配置等一般性问题 |
hwNN | 第 NN 次作业的特定问题 |
助教会用标签标记处理状态,常见含义:
-- 第一次提问? 先看提问指南 - (也可以看课程官网的《学会提问》) + 第一次提问? 先看课程官网的提问指南
学期组织: {{$semester}}
diff --git a/customization/custom/templates/home.tmpl b/customization/custom/templates/home.tmpl index 5625d79..f08c63c 100644 --- a/customization/custom/templates/home.tmpl +++ b/customization/custom/templates/home.tmpl @@ -7,9 +7,10 @@ * 文案直接写中文(平台只面向中文用户), 不复用 Gitea 的 startpage.* 文案, 这样首页不再出现「一款极易搭建的自托管 Git 服务」之类的自我推销。 * 只改文案/图标/链接, 保留原有 class 与结构, 避免升级后样式失效。 - * 课程官网地址 http://10.80.42.185/Website/ 在本文件、base/head_navbar.tmpl、 - public/assets/tjhlp/ask-guide.html 以及 issue-templates 下两个 config.yaml 里 - 各出现一次, 换域名/路径时这几处要一起改(见 customization/README.md「与官网联动」)。 + * 课程官网地址 http://10.80.42.185/Website/ 出现在本文件、base/head_navbar.tmpl、 + custom/tjhlp_semester_card.tmpl 以及 issue-templates 下两个 config.yaml 里, + 换域名/路径时这几处要一起改(见 customization/README.md「与官网联动」)。 + 提问指南只在官网存一份: /Website/qa/ask/ —— 平台内不再保留副本(2026-09 起)。 */}} {{template "base/head" .}}新建 Issue 时请选择合适的模板,写清题号、相关代码、报错信息和已经尝试过的做法。 - 提问规范见课程官网《学会提问》, - 平台操作见提问指南。 + 提问规范与具体做法见课程官网的 + 《提问指南》。
相关站点: 课程官网 · - 学会提问 · - 常见问题 · - 联系我们 + 提问指南 · + 常见问题 · + 联系我们
本平台只用于课程答疑,课程通知、作业要求等以课程官网与课程群为准。 diff --git a/customization/preview/preview.sh b/customization/preview/preview.sh index 46e3bde..3f18f0e 100755 --- a/customization/preview/preview.sh +++ b/customization/preview/preview.sh @@ -126,7 +126,8 @@ check) curl -fsS "${BASE_URL}/" -o "${html}" grep -q "先搜索,再提问" "${html}" && ok "首页用的是定制模板 home.tmpl" || bad "首页没有定制模板的内容" - grep -q "assets/tjhlp/ask-guide.html" "${html}" && ok "导航栏/首页已指向课程提问指南" || bad "没找到提问指南链接" + grep -q "http://10.80.42.185/Website/qa/ask/" "${html}" && + ok "导航栏/首页已指向官网提问指南(/Website/qa/ask/)" || bad "没找到官网提问指南链接" ! grep -q "painless\|极易搭建\|Easy to install\|Cross-platform" "${html}" && ok "首页已无 Gitea 功能介绍" || bad "首页仍有 Gitea 功能介绍文案" ! grep -qi "powered by" "${html}" && ok "页脚已无 Powered by Gitea" || bad "页脚仍有 Powered by" @@ -134,18 +135,18 @@ check) grep -q 'name="description" content="同济大学高级语言程序设计课程答疑平台"' "${html}" && 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 "http://10.80.42.185/Website/" "${html}" && ok "首页/导航栏已链接课程官网" || bad "首页没有课程官网链接" - grep -q "http://10.80.42.185/Website/ask-question/" "${html}" && - ok "首页已链接官网《学会提问》" || bad "首页没有《学会提问》链接" - guide="$(mktemp)" - curl -fsS "${BASE_URL}/assets/tjhlp/ask-guide.html" -o "${guide}" - grep -q "Website/ask-question/" "${guide}" && ok "站内提问指南已回链官网" || bad "站内提问指南没有官网链接" - rm -f "${guide}" + grep -q "http://10.80.42.185/Website/qa/ask/" "${html}" && + ok "首页已链接官网提问指南" || bad "首页没有官网提问指南链接" + ! grep -q "Website/ask-question/\|Website/faq/\|Website/contact\"" "${html}" && + ok "没有指向官网已迁移/失效的旧地址" || + bad "仍有旧地址(ask-question / faq / contact 无 .html)" ! grep -rq "example.com" "${ROOT}/../issue-templates/" && ok "Issue 模板已无 example.com 占位链接" || bad "Issue 模板里仍有 example.com" diff --git a/customization/website-linkage.md b/customization/website-linkage.md index 5afdfbd..e7a410b 100644 --- a/customization/website-linkage.md +++ b/customization/website-linkage.md @@ -68,9 +68,15 @@ Gitea 默认落地页(「一款极易搭建的自托管 Git 服务」), 定制上线后平台首页已换成答疑 平台介绍; 若截图里出现过「工单」字样也与现在的 「Issue」不一致。建议定制上线后按同样 流程重拍、**文件名不变**地替换, 这样正文不用改。 -11. **内容重复**:官网《学会提问》与平台内 `/assets/tjhlp/ask-guide.html` 有重叠。平台侧 - 已把官网定为权威版本(站内页顶部注明"以官网为准"并给出链接), 官网页不必反向复制平台 - 操作细节, 链接到 `/faq/gitea/` 即可。 +11. **内容重复(已在平台侧处理完)**:官网提问指南与平台内的副本曾有重叠。2026-09 起 + **提问指南只在官网保留一份**(`/Website/qa/ask/`), 平台内的 + `/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. 建议改动(可直接套用) diff --git a/issue-templates/README.md b/issue-templates/README.md index 743f285..ad94009 100644 --- a/issue-templates/README.md +++ b/issue-templates/README.md @@ -30,7 +30,8 @@ issue-templates/ ## config.yaml 里的链接与占位符 `config.yaml` 的 `contact_links` 是「新建 Issue」页面上的引导入口, 目前指向**课程官网** -(学会提问 / 课程信息 / 常见问题), 把答疑平台和官网串起来。课程官网地址是硬编码常量 +(提问指南 / 课程信息), 把答疑平台和官网串起来。提问指南只在官网保留一份 +(`http://10.80.42.185/Website/qa/ask/`, 平台内不再有副本); 课程官网地址是硬编码常量 (`http://10.80.42.185/Website/`), 换域名时两个 `config.yaml` 要一起改。 平台自身的链接用占位符, 避免把学期组织名写死: diff --git a/issue-templates/general/.gitea/ISSUE_TEMPLATE/config.yaml b/issue-templates/general/.gitea/ISSUE_TEMPLATE/config.yaml index 1ecd6a9..4ac857c 100644 --- a/issue-templates/general/.gitea/ISSUE_TEMPLATE/config.yaml +++ b/issue-templates/general/.gitea/ISSUE_TEMPLATE/config.yaml @@ -1,11 +1,8 @@ blank_issues_enabled: false contact_links: - - name: 提问前必读 · 学会提问 - url: http://10.80.42.185/Website/ask-question/ - about: 课程官网上的提问规范。不合规范的提问很可能不会得到回答 + - name: 提问前必读 · 提问指南 + url: http://10.80.42.185/Website/qa/ask/ + about: 课程官网上的提问规范与做法。不合规范的提问很可能不会得到回答 - name: 课程官网 url: http://10.80.42.185/Website/ about: 课程信息、作业说明、环境配置要求、常见问题 - - name: 答疑平台提问指南 - url: "{{BASE_URL}}/assets/tjhlp/ask-guide.html" - about: 搜索 Issue、选择模板、填写信息、关闭 Issue 的平台内速查 diff --git a/issue-templates/homework/.gitea/ISSUE_TEMPLATE/config.yaml b/issue-templates/homework/.gitea/ISSUE_TEMPLATE/config.yaml index a94277e..3a0fcbb 100644 --- a/issue-templates/homework/.gitea/ISSUE_TEMPLATE/config.yaml +++ b/issue-templates/homework/.gitea/ISSUE_TEMPLATE/config.yaml @@ -3,9 +3,9 @@ contact_links: - name: 一般性问题请到 general 仓库提问 url: "{{BASE_URL}}/{{ORG}}/general/issues/new/choose" about: 课程内容答疑、环境配置等非作业特定问题请到 general 仓库 - - name: 提问前必读 · 学会提问 - url: http://10.80.42.185/Website/ask-question/ - about: 课程官网上的提问规范。不合规范的提问很可能不会得到回答 + - name: 提问前必读 · 提问指南 + url: http://10.80.42.185/Website/qa/ask/ + about: 课程官网上的提问规范与做法。不合规范的提问很可能不会得到回答 - name: 课程官网 url: http://10.80.42.185/Website/ about: 课程信息、作业说明、环境配置要求、常见问题