每個科目只有兩個地方要動,版面和功能全部共用。
- 新增
exams/<科目id>.js(id 只能用小寫英文、數字和-,例如electronics-midterm)。 - 在
exams.json最前面加一筆,id要一樣,total填題數。
const BANK = [
// 觀念題
{id:'1-1', set:1, n:1, topic:'二極體', short:'順向偏壓',
q:'題目文字',
o:['選項一','選項二','選項三','選項四'], a:1, // a 是正解的位置,從 0 開始
exp:'解釋',
deep:'<p>觀念與陷阱,可寫 HTML</p><p class="trap">陷阱寫這裡</p>'},
// 計算題:多一個 gen,對應下面 GEN 的名稱
{id:'1-2', set:1, n:2, topic:'歐姆定律', short:'V = IR', gen:'ohm',
q:'電阻 100 Ω 通過 2 A,電壓是多少?',
o:['50 V','100 V','200 V','400 V'], a:2,
exp:'V = IR = 2 × 100 = 200 V。', deep:'<p>…</p>'},
];
// 計算題換數字:沒有計算題可以寫 const GEN = {};
const GEN = {
ohm:{
orig:{R:100,I:2}, // 原題數字,用來顯示計算步驟
rand:()=>({R:pick(50,500,50),I:pick(1,5)}), // 隨機數字,pick(最小, 最大, 間隔)
build:({R,I})=>{const V=R*I;return{
q:`電阻 ${R} Ω 通過 ${I} A,電壓是多少?`,
ans:V, unit:' V',
wr:[V/2,V*2,R/I], // 錯誤答案,照常見錯法設計
steps:[`V = I × R = ${I} × ${R}`,`V = ${fmt(V)} V`]}}},
};
QUIZ.register({
id:'electronics-midterm', // 和檔名一樣
title:'電子學期中考',
eyebrow:'Electronics · HW1',
sets:[{id:1,label:'作業一'}], // 題目的 set 對應這裡的 id
bank:BANK, gen:GEN,
formulas:[['V = IR','歐姆定律','作業一 2']], // 公式、用途、出處,可省略
unitNote:'單位提醒,可省略',
});進度依科目 id 分開存,所以 id 定了就不要改,改了那科的進度會歸零。
- 聽力:題目加
script:'對話原文'、scriptTitle:'標題',會出現朗讀按鈕。例子看exams/english-midterm.js。 - 重點題:題目加
key:true,範圍選單會多一個「只刷重點題」,給考前衝刺用。例子看exams/autocontrol.js(老師列的習題都算重點)。 - 附圖:題目加
img:'assets/<科目id>/檔名.png',圖會顯示在題目文字下方,點開可看原圖。圖片放在assets/<科目id>/,單張盡量低於 200 KB,能用 SVG 就用 SVG。例子看exams/electronics-midterm.js。 - 計算大題(先算再看解答):不寫
o、a,改寫html:'題目內容'、sol:'解答內容',可加no:'2.6.6'顯示原題號。例子看exams/fluid-workbook.js。
每科的題目會依 BANK 的順序自動從 1 編到最後一題(跨章、跨分組都不重複),顯示在題卡、進度格子、錯題本和觀念總覽上。不用在題庫檔另外填。
- 刷題頁的「跳到總題號」輸入數字就會開那一題。
- 進度格子下方的「複製題號表(貼給 AI 用)」會複製每一題的總題號、原題號、題目和選項,貼給 AI 後它就會用總題號講題。
- 自動控制把觀念題排在最前面、計算題依章排在後面,分類清單在
exams/autocontrol.js最後的CONCEPT。 - 網址加
&q=<總題號>會直接開那一題,例如play.html?exam=autocontrol&q=40。 - 新題目要加在
BANK最後面,插在中間會讓後面的總題號全部往後移。
在 QUIZ.register 加 refs:[{id, title, rows:[[左欄, 右欄], …], note}],題目加 refs:['表的 id', …]:
- 觀念總覽最上面會出現「表 1、表 2…」,每列有編號,每張表列出會用到它的總題號。
- 題目上方會出現「要查:表 N」按鈕,點了直接打開那張表。
- 複製題號表時,每題會附「要查」,表的內容附在最後面。
- 自動控制的表和每題要查哪張表,在
exams/autocontrol.js的REFS、USE。