文件版本

文件網站會將每個實際發布版本保存在各自的版本目錄中。目前版本維持在網站根目錄；舊目錄則是歷史版本，不再維護。

網站版本	路徑	狀態
0.14.0	/	目前版本
0.13.3	/v0.13.3/	實際發布之 0.13.3 網站的快照
0.13.2	/v0.13.2/	實際發布之 0.13.2 網站的快照
0.13.1	/v0.13.1/	實際發布之 0.13.1 網站的快照
0.13.0	/v0.13.0/	實際發布之 0.13.0 網站的快照
0.12.1	/v0.12.1/	實際發布之 0.12.1 網站的快照
0.12.0	/v0.12.0/	實際發布之 0.12.0 網站的快照
0.11.0	/v0.11.0/	實際發布之 0.11.0 網站的快照
0.10.0	/v0.10.0/	實際發布之 0.10.0 網站的快照
0.9.0	/v0.9.0/	實際發布之 0.9.0 網站的快照
0.3.0	/v0.3.0/	凍結的歷史網站

這些路徑以部署網站為基準，因此同一份清單也能用在 /askr/ 這類儲存庫前綴下。根目錄的 askr-versions.json 是唯一維護的版本清單來源。表格與下方 JSON 範例列出完整英文網站歷史；目前繁體中文標題列的版本選單則從 v0.14.0 開始，v0.13.3 及更舊的繁體中文快照維持不變：

{
  "mode": "inline",
  "longTitle": "Interferometric Purcell Filter",
  "versions": [
    {"label": "0.14.0", "root": "/", "latest": true},
    {"label": "0.13.3", "root": "/v0.13.3/"},
    {"label": "0.13.2", "root": "/v0.13.2/"},
    {"label": "0.13.1", "root": "/v0.13.1/"},
    {"label": "0.13.0", "root": "/v0.13.0/"},
    {"label": "0.12.1", "root": "/v0.12.1/"},
    {"label": "0.12.0", "root": "/v0.12.0/"},
    {"label": "0.11.0", "root": "/v0.11.0/"},
    {"label": "0.10.0", "root": "/v0.10.0/"},
    {"label": "0.9.0", "root": "/v0.9.0/"},
    {"label": "0.3.0", "root": "/v0.3.0/"}
  ]
}

請將版本清單檔加入 project.resources。每個 root 都代表一個完整版本網站，路徑以該網站的部署根目錄為基準。版本選擇器由 Askr 提供；網站使用者需自行管理封存目錄與版本清單檔。圖集的來源快照存放在 archives/v*/；從儲存庫根目錄執行完整的 quarto render . 會建置英文與繁體中文網站，並將快照複製到公開的 _site/v*/。目前的圖集建置會依這份根目錄清單產生繁體中文版本選單清單，納入 v0.14.0 起的版本；目前繁體中文網站的最新項目會連至自身根目錄 (./)，中文封存站則使用各自網站為基準的路徑。這是圖集網站的建置設定，不是擴充套件功能；v0.13.3 及更舊的繁體中文快照維持不變。不需另行維護第二份版本清單。建置輔助工具不會隨 quarto add 安裝。

若要指定固定目的地，請使用 href，而非 root。相對路徑與單斜線開頭的 href 都以網站為基準；絕對網址則保留原本的網域。固定目的地不會保留目前頁面的路徑。若版本選擇器的版本清單檔位於封存網站內，其 root 項目仍以該封存網站的根目錄為基準。圖集會從根目錄版本清單產生這些封存站專用的中繼資料。

inline 模式會在短標題旁顯示目前版本；title 模式則顯示標題與箭頭，並在選單中顯示版本號。可試用長標題範例。longTitle 為選填欄位，只在 title 模式使用。

同一份本機版本清單會提供選擇器的初始項目。若執行期間提供外部設定，仍以該設定為準；Askr 不會依主題版本中繼資料推測選擇器項目。請維護單一版本清單，避免在頁面標記中重複維護。

鍵盤操作

版本選擇器是可展開的控制項，內容是一般連結，不是清單方塊。按 Tab 移至按鈕，再按 Enter 或空白鍵開啟選單。按 Tab 或 Shift-Tab 可在連結間移動；按 Enter 開啟連結。按 Escape 關閉選單並將焦點移回按鈕。移出焦點或按一下選單外部也會關閉選單，但不會將焦點移回按鈕。目前版本連結會有 aria-current="true" 標記。

歷史版本網站

0.13.3、0.13.2、0.13.1、0.13.0、0.12.1、0.12.0、0.11.0、0.10.0 與 0.9.0 快照都取自各版實際發布於 GitHub Pages 的網站；0.3.0 快照維持原樣。這些都是不再維護的歷史文件。

目前的 0.14.0 版本選擇器在切換版本時會保留目前頁面的路徑、查詢參數與片段識別字。一般同源點擊會先檢查目的頁；若回應為 404，便開啟所選網站的首頁。若發生網路錯誤，則保留原目的頁。使用 Cmd／Ctrl 點擊或在新分頁開啟等特殊點擊，以及外部網址，都維持瀏覽器的原有行為；這些情況由網站主機顯示錯誤頁面。

0.13.3、0.13.2、0.13.1、0.13.0、0.12.1、0.12.0、0.11.0、0.10.0 與 0.9.0 的版本清單都只有一個封存站內的 root，值為 ./，用來標示目前版本；所有版本連結都會開啟各自設定的首頁。凍結版 0.3.0 的版本清單使用網域根目錄路徑與固定連結，讓 /askr/ 前綴下的導覽正常運作。圖集的建置輔助工具會依根目錄版本清單產生封存版本的清單檔，不會改寫舊版 HTML。

0.3.0 快照沒有本頁。選擇該版本時會前往其首頁，而不會開啟不存在的頁面。

發布新版本

替換目前網站根目錄前，請先將實際發布中的網站放入來源封存目錄。例如，下一版發布前，先將 0.14.0 封存至 archives/v0.14.0/；下次建置會將快照複製到 _site/v0.14.0/，公開路徑仍為 /v0.14.0/，並在輸出目錄產生該封存版的清單檔。接著將 v0.14.0 加入 _scripts/build_zh_tw.py 的 ARCHIVED_SITES，並更新根目錄版本清單檔，列出新的目前版本並保留較舊版本。0.14.0 仍是目前版本時，清單只需保留一筆目前版本。網站使用者需自行發布及管理所屬網站。

圖集也提供長標題範例。其版本清單欄位 longTitle 為選填，不會影響版本導覽。