技術架構

這個示範網站怎麼收到請求、怎麼部署、熱門關鍵字從哪裡來。

1. 使用者開啟網頁

  1. 瀏覽器開啟網址
  2. GitHub Pages靜態 HTML沒有伺服器、沒有資料庫
  3. 搜尋search-index.json在瀏覽器裡比對標題與內文

每一頁都是事先產生好的檔案,所以這是唯讀的示範網站:不能登入、發文或留言。

2. 建置(每天一次,以及每次 push 到 main)

  1. GitHub Actions排程或 push每天台灣時間 07:23
  2. 暫存 SQLite建表 + 示範資料migrate → seed_demo
  3. update_trends抓今日關鍵字失敗時沿用上一版
  4. build_site輸出每一頁Django 範本渲染成 HTML
  5. deploy-pages上線

3. 熱門關鍵字怎麼來

  1. 資料來源pttweb.ccPTT 今日全站熱門
  2. requests + BeautifulSoup抓標題去掉 Re:、[問卦] 等分類
  3. jieba繁中斷詞繁體字典 + 停用詞
  4. Counter算出前 10 名同一篇重複的詞只算一次
  5. 首頁前 5 名另存一份 trends.json

使用的技術

產生網頁
Python 3.12、Django 5.2(範本與資料模型)、nh3(過濾文章 HTML)
資料
建置時用暫存 SQLite,示範文章與留言都是虛構的
爬蟲與斷詞
requests、BeautifulSoup 4、jieba
前端
手寫 CSS、Noto Sans TC,搜尋用一小段原生 JavaScript
部署
GitHub Actions → GitHub Pages