本文撰寫於語言標籤改名之前，舊文中提到的 /zh/... 已於 2026-06-01 重新命名為 /zh-Hans/...，並新增 /zh-Hant/...。

文件伺服器 SEO 升級與重構

2026-05-30

本次更新分為兩條主線：內容渲染層在各頁面類型間完成統一，並在此基礎上完成了完整的 SEO 改造。

渲染重構

  • 看板、列表、看板組、看板列表現共用同一張卡片渲染器：內邊距、背景、陰影與圓角在各類型間完全一致；列表標題改用與看板一致的 h5 樣式。
  • 每頁一個 <h1>，位於麵包屑最後一項 —— 自然貼合頁面位置，無需額外視覺空間，並成為頁面標題的唯一來源。
  • 全面 HTML 轉義：所有使用者可控字串（名稱、描述、麵包屑文字、canonical URL、OG 圖片 URL）現均經過 html_escape 後再交給模板。形如 Q&A: when to use "file" 這類名稱不再破壞 HTML 屬性。
  • 細節打磨：卡片行內圖示與文字間距、列表與看板圓角統一、列表標題上下內邊距與看板卡片對齊。

SEO 與多語言 URL

  • /zh/... 與 /ja/... 路徑：每個頁面現可透過對應語言的獨立可爬取 URL 存取；原始裸 URL（例如 /policies/）繼續提供預設語言（英文）。
  • 每頁 <link rel="alternate" hreflang="...">：Google 可為不同語言訪客提供對應版本。
  • canonical、Open Graph、Twitter Card、JSON-LD BreadcrumbList 標籤覆蓋每一頁。社群平台的連結預覽現可正確顯示標題、描述與圖片。
  • /sitemap.xml：由後台任務每小時自動產生與重新整理，包含所有頁面及其 hreflang 備用 URL。
  • /op/switch_lang/<code>：全新的語言切換端點，保持 URL 與 Cookie 同步。點擊「中文」會跳轉到 /zh/<當前頁面>/。

緣由

渲染重構清理了長期以來按頁面類型分別實作的重複程式碼；SEO 與多語言改造讓文件可被搜尋引擎收錄、可被分享：主站訪客保留語言偏好，同時搜尋引擎將每種語言索引為獨立、可爬取的頁面。