Published on

WikiCraft - 用 Notion 與 Craft 風格重塑維基百科閱讀體驗

Authors

平常查資料幾乎每天都會點進維基百科,內容很豐富沒話說,但坦白講,原本的頁面排版我一直看不太習慣——字距偏密、左右側邊欄佔了不少空間,表格和資訊框(Infobox)也還停留在比較早期的網頁風格,文章一長,閱讀起來就很容易視覺疲勞。

另一方面,之前也一直想找個實際的小題目來練手,完整走一遍 開發並上架 Chrome 與 Safari 瀏覽器擴充功能(Extension) 的流程。與其做一個沒人用的 Demo,不如做一個自己每天打開瀏覽器都會用到的工具,於是就誕生了這個開源 side project:WikiCraft。

WikiCraft 前後對照預覽

WikiCraft 做了哪些調整?

設計靈感主要來自 Notion 與 Craft 這類現代筆記工具,目標是讓維基百科變得像一篇乾淨好讀的數位筆記,但同時完整保留原生功能(條目編輯、討論頁、修訂歷史、多語系切換都正常運作,不會為了美化把功能閹割掉)。

幾個我自己最在意的細節:

1. 原地排版優化與智慧精簡版面

重新調整了內文的字體階層、行距與舒適的閱讀欄寬,並自動隱藏右側比較重複的原生「外觀(Appearance)」面板,把左側的目次(TOC)改造成類似 Notion 的懸浮大綱,在長文章裡跳轉章節會順手很多。

2. 深淺色雙模式與零閃爍載入(No FOUC)

內建暖白(Light)與柔和深灰(Dark)兩種配色,也可以直接跟隨系統外觀自動切換。

寫這種主題擴充功能最怕「開網頁的瞬間先閃一下白底,然後才變黑」。為了避免這個問題,WikiCraft 會在 document_start 階段就透過快取把主題 CSS 變數掛上去,確保頁面載入時不會閃爍。

WikiCraft 淺色與深色雙模式

3. 卡片化表格,順便清理手寫死顏色

維基百科有很多右側資訊框(Infobox)、資料表格(.wikitable)和底部導覽框(.navbox),裡面常常混著編輯者手寫的 inline style 背景色,切到深色模式時經常會變成一塊刺眼的亮色或字體看不清楚。

WikiCraft 除了把這些區塊重塑成圓角現代卡片,也加了樣式清理邏輯把突兀的硬編碼背景色壓掉;另外在 1.0.1 版也修掉深色模式下維基百科 Logo 遇到 .skin-invert 時被雙重反白的小 bug。

4. 雙入口切換與純本地隱私

在維基百科頂欄右上角放了一個低調的膠囊切換鈕,點瀏覽器工具列圖示也能打開極簡控制面板,隨時切換模式或暫停主題。權限上只要求 storage 並僅在 *.wikipedia.org 網域本地執行,完全不收集或傳輸任何瀏覽紀錄。

技術選型與上架練手

這次底層是用 WXT + TypeScript + Manifest V3 來寫:

  • WXT 的開發體驗真的滿舒服的,支援 HMR 熱重載,目錄結構(entrypoints/、assets/、public/)也很直覺,打包 Chrome MV3 跟整理 i18n(支援繁體中文與英文)都省事不少。
  • Chrome Web Store 這邊已經順利通過審核上架,從建立專案、填寫隱私權政策、準備 1280×800 宣傳對比圖到送審,整個流程走過一次後對規則清楚很多。
  • Safari (macOS) 則是透過 Xcode 轉換封裝成 Safari Web Extension 送審,目前正在等待審查結果。

心得後記

這種「不爽原生介面就自己蓋一層 CSS / JS」的 side project 其實很療癒,開發週期短、回饋感極強,寫完當天自己查資料就能直接用上。

如果你也跟我一樣覺得原本的維基百科版面看久了有點累,歡迎到 Chrome 線上應用程式商店 裝來玩玩看;有興趣看實作細節或遇到奇怪破版的條目,也歡迎到 GitHub 逛逛、發 Issue 或順手給顆 Star 👍

參考資料