跳转至

提交修改

本页是站内投稿入口:填好下面的表单,点一下按钮就会打开一个已经预填正文的 GitHub Issue 页面,把文件拖进去、点提交即可。

三步完成

  1. 选类型、填内容:按要投稿的内容选择「补充资料 / 增补介绍 / 纠错 / 修改 / 新增课程页」,填好必填项。
  2. 生成并提交:点「🚀 生成并提交到 GitHub」,在新标签页里把文件拖进编辑框,然后点 Submit new issue。
  3. 等审核上线:24 小时内机器人会在 Issue 里贴出「变更预览」diff,维护者批准后机器人自动修改仓库、重新构建网站,新内容就上线了。

提交前请确认内容可以公开

Issue、附件和变更预览都在 GitHub 上公开可见。请不要上传含个人隐私、未授权版权或考试作弊相关的材料;上传前请自行确认可以公开分享。

选择投稿类型(带 * 的为必填项):

列表来自站点课程目录;找不到目标页面时请选「新增课程页」。

新页面会创建在 docs/<分类>/<课程名>/index.md,并自动加入导航。

1–40 字,不能包含 / \ : 等字符。

1–120 字,会作为 Issue 标题和提交信息的一部分。

会作为附件在课程页面「补充材料」里的显示名。

点击选择文件,或把文件拖到这里 最多 10 个,单个文件 ≤ 25MB

受浏览器安全限制,网页不能直接把本地文件写入 GitHub;提交后请把这里选好的文件拖入打开的 GitHub 编辑框完成上传(也支持在 GitHub 里点 Choose files)。

只填标题文字,不要带 ##;找不到该小节时机器人会报错。

≤ 20000 字,支持 Markdown。

找到页面中「原文」并替换为「替换为」。原文必须至少 8 个字符、且在页面中恰好出现一次,否则整单会被机器人拒绝(不会做部分修改)。

大文件(超过 25MB)建议先放到南大网盘,再把分享链接填在这里。

提交之后

  1. 交接附件(仅「补充资料」需要):在新的 GitHub Issue 页面里,把本页选好的文件拖进正文编辑框(或在编辑框里点 Choose files 选择),GitHub 会自动上传并插入 user-attachments 链接。本页只记录文件名清单,不会上传文件。单个文件 ≤ 25MB,可以拖多个。
  2. 点 Submit new issue:提交后 Issue 会出现在仓库的 Issues 列表里,不要关闭它。
  3. 等机器人预览:24 小时内机器人会在 Issue 下贴一条评论,里面有 <details> 折叠的变更预览 diff、附件列表和审核命令说明;格式有问题也会在评论里说明原因。
  4. 维护者批准后自动上线:维护者评论 /批准(或加 contribution:approved 标签)后,机器人自动改仓库、提交 main(若 main 受保护则自动开 PR),然后网站重新构建,新内容上线。

担心提交错了?

在维护者批准之前,你随时可以在 Issue 里继续评论说明、编辑 Issue 正文(编辑后机器人会重新预览),或者直接关闭 Issue 撤回。已经上线的修改,可以再提一次「纠错 / 修改」。

常见问题

需要 GitHub 账号吗?

需要,但只需要注册一个免费账号。注册入口见 GitHub 官网。 如果不想注册 GitHub,可以用邮箱备选方式(见下方 FAQ),或直接在 Issues 里留言。

附件可以多大?能传几个?

单个文件 ≤ 25MB(GitHub 拖拽上传的限制),本页一次最多选 10 个文件;GitHub 本身不限上传总数。 超过 25MB 的文件建议先放到南大网盘 / 自己的网站,再把永久分享链接填到「外部链接」里。

能直接在本页上传文件吗?

不能。受浏览器安全限制,网页不能直接把本地文件写入 GitHub。本页的「附件」区域只是帮你记录文件名清单并做大小 / 类型检查; 提交后会打开 GitHub 编辑框,请把选好的文件拖进去(或点 Choose files 选择)完成真正的上传,再点 Submit new issue。

多久能上线?

提交 Issue 后,机器人通常会在 24 小时内贴出变更预览;维护者批准后自动落库并触发网站重建,一般 1–2 天内就能在网站上看到。

提交之后能修改或撤回吗?

可以。批准前:在 Issue 里继续评论、编辑 Issue 正文(机器人会重新预览)或关闭 Issue。 已经上线的修改:再提一次「纠错 / 修改」即可,机器人会生成新的 diff 供维护者审核。

正文太长,GitHub 页面没有预填怎么办?

正文很长时,页面会自动把正文复制到剪贴板,只带标题打开空白 Issue:在编辑框里按 Ctrl+V(Mac 为 ⌘V)粘贴,再拖入附件即可。 也可以把内容保存成 .md 文件,改用「补充资料」上传;或点「👀 预览 Issue 正文」/「📋 复制正文」手动处理。

机器人说「原文找不到 / 出现多次」怎么办?

页面可能已经更新过。请打开目标页面,重新原样复制那段文字(至少 8 个字符,确保只出现一次),再提交一次;如果确实需要改多处,请分成多组替换内容。

还有其他投稿方式吗?

有。完整方式见如何为本网站做贡献,包括: 邮箱 baihaozhen@smail.nju.edu.cn(把 markdown 和资源发过去,注明课程 / 页面)、直接提 GitHub Issue、以及传统的 Pull Request 方式。

我的邮箱/个人信息会被公开吗?

通过本页投稿只会公开你填写的标题、说明、正文和链接,以及你上传的附件。GitHub Issue 会显示你的 GitHub 用户名;不想公开身份就用邮箱备选方式。