書籍清單 使用指南
「書籍清單」(網址 /course/booklist/)是網站共用的書本目錄:每一本書記錄書名、簡介、作者等基本資料,以及目錄架構(部/章),供「以書會友」課程匯入章節結構、或「個人讀書筆記」選書時直接帶入,不用重複輸入。瀏覽完全公開,任何人都能查詢;新增與編輯則需要特定權限。
一、瀏覽書籍清單
首頁以卡片方式呈現每一本書:封面、書名、作者、分類、適讀對象、出版年份/頁數,以及簡介摘要;若這本書已有 AI 參考摘要,會多一個「AI摘要」標籤。
上方可用四種篩選(可同時使用,每個選項後面的數字是符合條件的書籍數):
- 分類
- 推薦人
- 適讀對象(學齡前、小學低/中/高年級、國中、高中、高中以上、不限年齡)
- 發佈狀態(只有站務管理員才看得到這個篩選,一般使用者永遠只看得到已發佈的書)
有套用篩選時,旁邊會出現「清除篩選」的連結。清單下方有分頁可翻頁。
未發佈的書籍只有站務管理員能看到(會多標示「未發佈」的灰色標籤),其他人完全看不到,不會出現在清單或計數裡。
二、書籍詳情頁
點書名進入詳情頁,會看到:
- 書名、分類標籤、AI摘要標籤(若有)
- 簡介
- 「目前正在讀或讀過這本書的人數」
- 目錄:依序列出每個部/章的標題(只有標題,不含內容——書籍清單本身不存任何讀後感或摘要內容)
- 公開的讀書筆記:若有人把自己依這本書寫的「個人讀書筆記」設為公開,這裡會列出他們的名字,點進去可直接看他們寫的筆記
- 有編輯權限的人,標題旁會多一個「編輯」按鈕
三、新增/編輯書籍(需要權限)
只有課程老師、班級/社團管理員(或站務管理員)才能新增或編輯書籍;一般讀者的畫面上不會出現「+新增書籍」或「編輯」按鈕。
有權限的人在首頁可點「+新增書籍」,或在詳情頁點「編輯」,進入編輯畫面:
用 JSON 匯入(可省去手動輸入)
- Import Multiple Books from JSON:上傳一份 JSON,可以是單本書的資料(會直接帶入下方欄位,存檔前還能再調整),也可以是多本書的陣列(會列出清單,按「Import All Books Now」一次全部建立)。
- 編輯既有書籍時,還會多一個 「Import summary_ai (AI摘要) for This Book」 的匯入框,可上傳章節摘要 JSON,一次把每一章的 AI 參考摘要填進目錄裡;有「Dry run(先預覽、不寫入)」與「Force(強制依較短的一方對齊,章節數不一致時可能對錯)」兩個選項。
手動填寫欄位
- 書名、作者、ISBN、分類(可選既有分類,或在下方輸入框打新分類名稱直接建立)、出版社、頁數、出版年份、簡介、推薦人、適讀對象(以逗號分隔多個標籤)、封面(圖片路徑或網址)、網址(目錄資料來源網頁)
- 已發佈:勾選後才會出現在一般讀者看到的書籍清單裡;不勾選就只有站務管理員能看到。
- AI摘要:是否顯示「AI摘要」標籤,通常由匯入 summary_ai 後自動勾選,也可以手動開關。
目錄結構
- 按「+ 新增 level_one」新增一個大目錄項(例如「第一部」),裡面再按「+ 新增 level_two」新增小目錄項(例如「第一章」)。每一項都可以用上/下箭頭調整順序、或刪除。
- 所有欄位與目錄結構改好之後,要按最下方的「Save」才會真正存檔;不想存就按「Cancel」離開。
小提醒
- 書籍清單只負責書名、簡介與目錄架構,不負責任何人的讀後感或摘要內容——寫心得請到「個人讀書筆記」或課程裡進行。
- 書籍一旦被課程或個人讀書筆記拿來用,之後在書籍清單把目錄改掉,對方不用重新匯入也會跟著更新;但也因此改目錄時要小心,避免影響已經在用這本書的課程或筆記。
- 新增書籍前可先用「Import Multiple Books from JSON」檢查是否已有現成資料,比手動一筆一筆輸入快很多。