0

先玩一遍，确认这是你要的

Play it once first

下面这个档案双击就能在浏览器里打开，不必上传任何地方、也不必联网。想先给同事看看，直接把这个档案传给他们也行。

Double-click the file below and it opens in your browser — nothing to upload, no internet needed. Want to show a colleague? Just send them the file.

1

开一个 GitHub 账号（第一次才需要）

Create a GitHub account (first time only)

GitHub 是一个免费放网页的地方。已经有账号的话，跳到步骤 2。

GitHub is a free place to host web pages. Already have an account? Skip to step 2.

1. 打开 github.com/signup。
2. Go to github.com/signup.
3. 填 电邮地址（建议用个人电邮，不要用学校的公务电邮，以免日后转换学校时失去账号）。
4. Enter your email — a personal address is better than a school one, so you don't lose the account if you move schools.
5. 设一个 密码，再取一个 用户名（会出现在你的网址里，例如 msLee-cl，建议简短、全小写、不含空格）。
6. Set a password and pick a username — it becomes part of your web address (e.g. msLee-cl), so keep it short, lowercase, no spaces.
7. 收电邮里的验证码，填进去。
8. Enter the verification code sent to your email.
9. 问你要不要付费方案时，选 Free 就好，这个用途完全够用。
10. When asked about plans, choose Free — it's more than enough for this.

2

把这个游戏复制到你的账号（Fork）

Copy the game into your account (Fork)

1. 打开 原始 repo。
2. Open the original repo.
3. 按右上角的 Fork → Create fork。
4. Click Fork at the top right → Create fork.
5. 几秒后，你的账号下就有一份一模一样的复制品了 —— 你怎么改都不会影响到原版。
6. A few seconds later you have your own identical copy — nothing you do to it affects the original.

3

开启网页功能（GitHub Pages）

Switch the web page on (GitHub Pages)

1. 在你 fork 的那个 repo 里，点上方的 Settings。
2. In your forked repo, click Settings at the top.
3. 左侧栏找到 Pages。
4. Find Pages in the left sidebar.
5. Source 选 Deploy from a branch；Branch 选 main，资料夹选 / (root)，按 Save。
6. Under Source choose Deploy from a branch; set Branch to main and the folder to / (root), then Save.
7. 等 1–2 分钟，重新整理这一页，顶端会出现一个绿框和你的网址。
8. Wait 1–2 minutes and refresh the page; a green box appears at the top with your address.

4

发给学生

Hand it to your students

• 先自己在手机和 iPad 上各开一次，确认按钮灵敏、声音正常。
• Open it once on a phone and once on an iPad yourself; check the buttons respond and the sound works.
• 把网址贴到 Google Classroom、SLS 公告，或用任何免费的 QR code 网站做成二维码，投影在白板上。
• Paste the link into Google Classroom or an SLS announcement, or turn it into a QR code with any free generator and project it.
• 课堂小提醒：右下角 🔊 是总静音、🎵 只关音乐 —— 二十台 iPad 一起响的时候用得上。
• Classroom tip: 🔊 at the bottom right mutes everything and 🎵 mutes just the music — useful with twenty iPads in one room.

5

（可选）要让分数自动进 SLS 教师后台

(Optional) Get the scores into your SLS gradebook

上面那个版本，学生只在自己画面上看到分数。如果你想在 SLS 教师后台的 Gradebook 里直接看到全班成绩、不必收作业也不必改分，就改用 SLS 版。

With the version above, students only see their own score on screen. If you want the whole class's marks to appear in the SLS teacher gradebook — nothing to collect, nothing to mark — use the SLS build instead.

压缩档已经压好了，不必自己压。下载下来直接上传，SLS 要的那种结构（最外层就一个 index.html，没有多包资料夹）它本来就是。

The archive is already packaged — you don't have to zip anything. Download it and upload it as it is; it already has the structure SLS wants (a single index.html at the top level, no folder around it).

1. 在 SLS 课业里选 Question → Free Response → Interactive Response。
2. In SLS choose Question → Free Response → Interactive Response.
3. 上传 unit34sls.zip，Maximum Marks 设 20。
4. Upload unit34sls.zip and set Maximum Marks to 20.
5. 自己用学生视角做一次，再回教师后台确认分数有出现。
6. Do one run as a student, then check the gradebook to confirm the score arrived.

完整步骤与疑难排解：docs/sls-deployment.md；背后原理：docs/xapi-scoring-wrapper.md；官方说明：SLS Teacher User Guide — HTML5 Content Development。

Full walkthrough and troubleshooting: docs/sls-deployment.md; how it works underneath: docs/xapi-scoring-wrapper.md; official reference: SLS Teacher User Guide — HTML5 Content Development.