第 05 站教材區v2 階段:生成學生入口
課程網站
GitHub Pages|課程入口
學生從這個網站進入每週教材與其他平台。網站由 GitHub Pages(把一個資料夾裡的網頁檔案公開放上網的服務)發布,上面的網頁是從教材原稿建置出來的發布版。
第 05 站教材區v2 階段:生成學生入口
GitHub Pages|課程入口
學生從這個網站進入每週教材與其他平台。網站由 GitHub Pages(把一個資料夾裡的網頁檔案公開放上網的服務)發布,上面的網頁是從教材原稿建置出來的發布版。
本站:第 05 站,屬於教材區。
相連的站:資料從第 04 站進來;再往第 06、07、09、10 站去。
教材區:教材原稿、學生看到的課程網站,以及給筆記本讀的閱讀副本,都在這一區。
什麼內容可以公開;發布之後,再從學生的入口檢查一次。
把原稿、發布到網路上的副本與學生看到的畫面分開,才不會把「技術上發布了」當成「老師核准了」。
這一站的界線
地圖上標示「已發布、可以讀取」,不表示老師已經完成內容核准。
紀錄說明2026-09-08 到 09 日,有把教材接回課程頁的紀錄,也有發布後從公開網址讀回(做完一個動作之後,再把結果讀回來檢查,確認真的寫進去了)的紀錄。
這一站由誰動手、各做什麼:
核定公開的範圍與發布的時機。
複製建置好的檔案,依授權發布,發布後再讀回確認。
Agent 是會依照指示自己讀檔案、寫檔案、執行程式的 AI 工具;v2 稱為 Coding Agent,例如 Codex。
v2 標示的位置:SONIC-repo/class/cm108g-1151/。下表每一列是一個資料夾、檔案、平台紀錄或閘門;縮排的列,屬於上一個資料夾或項目。
| 名稱 | 類型 | 白話說明 |
|---|---|---|
textbook/pages/位置:SONIC-repo/class/cm108g-1151/textbook/pages/ | 資料夾 | 從 Textbook 的 06_web 複製建置好的檔案,放到網站的路徑裡,再由 GitHub Pages 發布。 |
week-01.html … week-18.html位置:class/cm108g-1151/textbook/pages/week-01.html | 檔案 | 學生閱讀的版本,由原稿建置成網頁。它不能當作另一份正式原稿隨意改寫。 |
index.html/每週材料入口位置:class/cm108g-1151/index.html | 檔案 | 課程入口,指向每週教材與其他平台。 |
| Git/Pages 發布與讀回 | 紀錄或設定 | 用 Git(記錄每一次檔案修改、之後可以回頭查版本的工具)提交、部署到網路、公開可以讀取、老師核准,是四種不同的狀態。 |
| Notebook · Teams · 白板 · 互評 | 連結(引用) | 導覽連結,讓學生前往各個服務;這不代表網站把那些服務的資料搬了進來。 |
| 瀏覽器 localStorage | 紀錄或設定 | 學生的閱讀標註與筆記,存在學生自己使用的瀏覽器裡,技術上稱為 localStorage(瀏覽器存在使用者自己電腦裡的資料,別人看不到,老師也看不到);老師收不到這些內容,不能把它們當成學習紀錄。 |
從 第 04 站 教材原稿「建置/發布」(生成/建置)
Textbook 的 06_web 檔案複製到課程網站的程式庫(英文是 repository;用 Git 管理的一個專案資料夾,這門課的網站放在名為 SONIC-repo 的程式庫裡),取得授權後由 GitHub Pages 發布,發布後再讀回確認。
往 第 06 站 雲端硬碟閱讀副本「課程與個案副本」(生成/建置)
選定的課程頁與個案內容,轉成 Google 文件閱讀來源;還沒核准的候選版本,不能自行取代既有的版本。
往 第 07 站 Gemini Notebook 助教「學習入口」(入口連結)
課程網站提供筆記本的入口連結;網站並不保存筆記本裡的對話。
往 第 09 站 課堂即時白板「白板入口」(入口連結)
學生從課程入口前往即時白板;公告本身存在白板的線上資料庫裡。
往 第 10 站 分組與互評平台「互評入口」(入口連結)
課程網站連到分組互評的網頁;受限的資料,要登入並具有課程權限才看得到。
經過這一站的路徑:一份週教材(第 4 步)
下面的連結會另開分頁,前往 v2 已經發布的實例頁。實例頁保留原文,有些是英文或程式碼。
產生教材網頁的程式(Python)全文・去識別
從單元原稿與配套檔,產生學生用的單欄閱讀網頁。這只是一個程式檔,不等於完整的應用程式。
第 1 週教材原稿(Markdown)全文・去識別
把原稿和網頁、產生閱讀副本的程式放在一起看:同一份內容,怎麼變成兩種閱讀版本。原稿存在,不等於老師核准。
Teams 作業批次的執行結果全文・去識別
記錄第 1 週作業已發布、指定週次已排程,以及讀回的結果;也記錄這一批沒有建立公告或附件。
18 週作業規格(英文草稿)全文・去識別
每週的作業由同一份草稿管理:發布與截止時間、作業內容、AI 協作紀錄與格式規則。原文的狀態是 v0.1 草稿,不等於學生目前在 Teams 收到的全部作業。
教材專案的最新交接節錄(原檔第 1–75 行)
前段記錄最新的維護、來源與核准狀態,示範下一次工作先讀什麼、哪些事情仍然不能做。
教材專案的完整歷程與 Agent 分工報告全文・去識別
老師的決定、Agent 接力、樣章、否決、修復、建置與發布,放在同一份真實的專案歷程裡。報告中的工時是原作者依情境所做的估計,沒有經過實證研究。
課程來源導覽(中英)全文・去識別
告訴學生怎麼選週教材、核准逐字稿、長短個案與助教指示,以及資料的界線。
教材專案給 Agent 的工作規範全文・去識別
規定研究、寫作、獨立審查三種角色,各自可以寫入哪裡、要讀什麼、品質怎麼檢查,以及老師核准的界線。
每週的閱讀、任務、評分方式與課堂政策。
學生閱讀版的入口;網站讀得到,和老師核准是兩回事。