Docusaurus | covia.io

📄️ Docusaurus i18n 國際化實戰完整教學：從零到多語言網站

COVIA 平台從繁中單語擴展至繁中/英/日/德四語的完整 i18n 實戰紀錄，涵蓋 `docusaurus.config.js` 配置、檔案結構、翻譯工作流、常見 broken links / slug 衝突的排解方案。

針對 Docusaurus + Cloudflare Pages 部署後手機字體消失問題的完整排錯流程，含 /static/ 路徑陷阱、@font-face 正確配置、手機實機測試步驟。

繁體中文字體完整字集 15-25MB 的體積挑戰，透過 Google Fonts 動態子集化、WOFF2 格式、display=swap、preconnect 與本地部署策略降低 FCP/LCP 與流量消耗。

零基礎建立靜態知識網站的完整流程：Node.js + Docusaurus + GitHub + Cloudflare Pages 免費部署，含平台比較（Vercel/Netlify/Coolify）與階段性部署策略建議。

解決 Cloudflare Pages 建置 Docusaurus 時常見的 ESM exports 錯誤（如 unicorn-magic），說明本地 `npm run build` + 手動上傳 build 目錄的穩定部署流程。

Docusaurus 客製化實務：CSS 類別來源、Hero 區塊設計與響應式、Google 字體引入、Footer 社交圖標、SEO 標題設計、Open Graph 與 Twitter Card 完整配置。

逐步實作指南：Python 爬蟲收集網站實際字符集、fontTools.subset 產生 WOFF2 子集、CSS @font-face + preload + display=swap 策略，將 15-20MB 中文字體縮減至數百 KB。