網站以 Jekyll 將 Markdown 文章、Liquid 範本和靜態頁面組合成 HTML。正式部署由 GitHub Actions 執行 .github/workflows/pages.yml：取得程式碼、執行 Instagram 同步（有提供 Secret 時）、計算文章推薦、建置 Jekyll、部署 GitHub Pages。工作流程在 main 更新、手動觸發及每日 UTC 10:17 執行；每日排程主要用來更新 Instagram（香港時間約 18:17）。
網站設定在 _config.yml，目前網址為 https://jungian16types.com、baseurl 為空。GitHub Pages 發佈來源應使用 GitHub Actions。Liquid 樣板須經 Jekyll 建置，不能直接用瀏覽器開啟原始檔來預覽。
| 路徑 | 用途 |
|---|---|
index.html |
首頁、首頁介紹及社群／Instagram 內容 |
_includes/header.html、_includes/footer.html |
全站共用頁首和頁尾 |
_includes/site-theme-links.html |
載入共用主題、元件、夜間模式樣式與主題切換程式 |
_layouts/post.html |
文章頁版型、分享區、標籤、SEO 中繼資料與文章結構化資料 |
_posts/ |
Jekyll 文章來源 |
templates/文章範本.md |
新文章的起始範本 |
theory/index.html、theory/<分類>/index.html、_includes/theory-page.html |
理論文章總目錄與七個易讀分類網址，共用同一頁面內容；人物分析文章列表會動態讀取文章資料 |
tags/index.html、tags/<標籤>/index.html、_includes/person-analysis-tag-page.html |
標籤索引、各標籤文章頁，以及人物分析標籤預覽頁 |
_data/person_analysis_tags.yml |
人物分析專用的八種標籤名稱與顯示順序 |
quiz/、quiz/start/、quiz/results/ |
測驗入口、作答頁與易讀結果網址；舊編號網址保留轉址 |
/alchemy/ |
煉金工房 |
assets/css/ |
共用視覺、夜間模式、首頁、測驗與結果頁樣式 |
assets/js/ |
主題切換、測驗、文章連結預覽等互動程式 |
assets/images/、img/ |
網站圖片和舊站媒體資產；新增文章圖檔優先放 assets/images/ |
_data/ |
Jekyll 使用的資料檔，例如測驗對照、Instagram 貼文及建置產生的相關文章資料 |
scripts/ |
建置前執行的相關文章計算和 Instagram 同步程式 |
.github/workflows/pages.yml |
自動建置與部署流程 |
| 頁面 | 網址 |
|---|---|
| 主頁 | / |
| 類型測驗入口 | /quiz/ |
| 測驗作答 | /quiz/start/ |
| 理論文章總目錄 | /theory/ |
| 基礎概念 | /theory/basics/ |
| 類型描述 | /theory/types/ |
| 常見問題 | /theory/faq/ |
| 榮格原文 | /theory/sources/ |
| 系統對比 | /theory/compare/ |
| 站主銳評 | /theory/commentary/ |
| 人物分析 | /theory/people/ |
| 人物分析標籤索引 | /tags/ |
| 人物分析標籤頁 | /tags/ET分析/、/tags/EF分析/、/tags/ES分析/、/tags/EN分析/、/tags/IT分析/、/tags/IF分析/、/tags/IS分析/、/tags/IN分析/ |
| 煉金工房 | /alchemy/ |
| 關於本站 | /about/ |
| 測驗結果 | /quiz/results/<類型或功能>/ |
測驗結果及主要頁面仍接受舊的 WordPress 編號網址，並轉到上述新網址。理論七個分頁由 _includes/theory-page.html 共用頁面內容，各自有易讀網址並會直接選取對應分類。人物分析文章需使用 subcategory: 人物分析；八種專用標籤控制分類內篩選及標籤預覽頁。舊的 ?section= 連結仍可使用。
頁首和頁尾由 _includes/header.html、_includes/footer.html 共用；版面樣式主要在 assets/css/site-chrome.css 和 assets/css/site-theme.css。理論文章的七個分類位於 theory/index.html 同一頁，分類切換不會載入另一個 HTML 頁。人物分析標籤頁由 tags/<標籤>/index.html 引入共用樣板，不需為每個標籤複製列表邏輯。不要復原已淘汰的獨立理論分類頁或舊分類封面縮圖。
全站日夜模式由 assets/js/theme-mode.js 切換，選擇保存於瀏覽器 localStorage。共用基礎色彩在 assets/css/site-theme.css，夜間覆寫在 assets/css/night-mode.css；新增元件時應同時確認白天和夜間的文字、背景、按鈕、邊框及焦點狀態。各頁或舊結果頁仍可能有自己的內嵌樣式，若夜間外觀不一致，需檢查其選擇器與載入順序。
文章頁的 canonical、Open Graph／社群分享資料及 Article 結構化資料由 _layouts/post.html 與 _includes/seo-canonical.html 輸出。網站圖示包含根目錄的 favicon.png 和 apple-touch-icon.png；改 logo 或網站名稱時，記得檢查瀏覽器分頁圖示及分享預覽。
scripts/build_related.py 產生，不要手動維護 _data/related_posts.json。