SHA256
官网改版后提问指南在 https://cpp.tongji.sh/Website/qa/ask/, 平台内不再单独留一份: - 删除 customization/custom/public/assets/tjhlp/ask-guide.html - home.tmpl(「按模板提问」卡片 + 底部相关站点)、base/head_navbar.tmpl(未登录导航 与用户菜单两处)、学期答疑入口卡片: 全部改指官网 /Website/qa/ask/ - issue-templates 两个 config.yaml 同样改指官网; general 里原来那条「答疑平台提问指南」 (指向平台内副本)直接去掉, 只剩「提问指南」+「课程官网」两条官网入口 - 顺手修掉两个已失效的官网地址: /Website/faq/ -> /Website/qa/faq/(旧的是跳转页), /Website/contact -> /Website/contact.html(旧地址现在 404) - custom/public 因此变成空目录, 加 .gitkeep 占位: bind mount 的源目录不存在时 docker compose 会以 root 创建它, 之后普通用户/CI 写不进去(同 options/.gitkeep 的坑) 断言同步: check.sh 与 preview.sh check 改为断言指向 /Website/qa/ask/、页面里没有 ask-question//Website/faq//Website/contact" 这些旧地址、平台内副本已 404。 实测(预览): 首页与导航栏 3 处 qa/ask/、1 处 qa/faq/、1 处 contact.html, 登录后卡片 再 2 处 qa/ask/; 两套检查脚本全过; scripts 80 个测试全过。
This commit is contained in:
@@ -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}}
|
||||
<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}}
|
||||
</div>
|
||||
|
||||
@@ -126,7 +126,7 @@
|
||||
{{svg "octicon-tools"}}
|
||||
{{ctx.Locale.Tr "your_settings"}}
|
||||
</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"}}
|
||||
提问指南
|
||||
</a>
|
||||
|
||||
@@ -48,8 +48,7 @@
|
||||
进入{{$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>)
|
||||
第一次提问? 先看课程官网的<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>
|
||||
|
||||
@@ -7,9 +7,10 @@
|
||||
* 文案直接写中文(平台只面向中文用户), 不复用 Gitea 的 startpage.* 文案,
|
||||
这样首页不再出现「一款极易搭建的自托管 Git 服务」之类的自我推销。
|
||||
* 只改文案/图标/链接, 保留原有 class 与结构, 避免升级后样式失效。
|
||||
* 课程官网地址 https://cpp.tongji.sh/Website/ 在本文件、base/head_navbar.tmpl、
|
||||
public/assets/tjhlp/ask-guide.html 以及 issue-templates 下两个 config.yaml 里
|
||||
各出现一次, 换域名/路径时这几处要一起改(见 customization/README.md「与官网联动」)。
|
||||
* 课程官网地址 https://cpp.tongji.sh/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" .}}
|
||||
<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>
|
||||
<p class="large tw-text-balance">
|
||||
新建 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>
|
||||
</div>
|
||||
</div>
|
||||
@@ -70,9 +71,9 @@
|
||||
<p class="large">
|
||||
相关站点:
|
||||
<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/faq/">常见问题</a> ·
|
||||
<a href="https://cpp.tongji.sh/Website/contact">联系我们</a>
|
||||
<a href="https://cpp.tongji.sh/Website/qa/ask/">提问指南</a> ·
|
||||
<a href="https://cpp.tongji.sh/Website/qa/faq/">常见问题</a> ·
|
||||
<a href="https://cpp.tongji.sh/Website/contact.html">联系我们</a>
|
||||
</p>
|
||||
<p>
|
||||
<small>本平台只用于课程答疑,课程通知、作业要求等以课程官网与课程群为准。</small>
|
||||
|
||||
Reference in New Issue
Block a user