Yuan 個人網站

這是 yuan-tw.net 的靜態個人網站，用來整理 Yuan 的自我介紹、技術能力、工作經歷、專案、社群活動與公開聯絡方式。

技術棧

• 純靜態 HTML / CSS / JavaScript
• 無 JavaScript 框架
• 無建置流程
• 無外部 CDN 依賴

本機檢視

網站使用 /assets/...、/data/... 等絕對路徑，建議用本機 HTTP server 檢視：

python3 -m http.server 8080

然後開啟 http://localhost:8080/。

主要檔案

• index.html：首頁與結構化資料
• assets/css/site.css：網站樣式與 RWD
• assets/js/site.js：讀取 JSON 並渲染工作經歷、活動經歷與展開互動
• data/experiences.json：前端實際讀取的經歷資料
• file/cv-zh.md、file/cv-zh.pdf：台灣正體中文 ATS 友善 CV
• file/cv-en.md、file/cv-en.pdf：英文 ATS 友善 CV
• llms.txt：AI 與自動化工具友善摘要
• robots.txt：搜尋引擎爬蟲設定
• sitemap.xml：網站地圖
• scripts/validate-site.js：無依賴的靜態資料與網站一致性檢查
• PROJECT.md：專案架構、資料流與維護說明
• AGENTS.md：AI agent 與維護者工作規範

驗證方式

目前沒有建置流程。修改後至少應執行：

node scripts/validate-site.js
python3 -m json.tool data/experiences.json
python3 -m xml.etree.ElementTree sitemap.xml

若更新 file/cv-zh.md 或 file/cv-en.md，PDF 應使用可保留純文字抽取順序的 XeLaTeX 流程重新產生，並用 pdftotext 檢查 ATS 可讀內容：

pandoc file/cv-zh.md --from markdown --pdf-engine=xelatex -V papersize=a4 -V geometry:margin=12mm -V fontsize=10pt -V mainfont="DejaVu Sans" -V CJKmainfont="Noto Sans CJK TC" -V monofont="DejaVu Sans Mono" -V mainfontoptions="Ligatures=NoCommon" -V colorlinks=true -H file/cv-style.tex -o file/cv-zh.pdf
pandoc file/cv-en.md --from markdown --pdf-engine=xelatex -V papersize=a4 -V geometry:margin=12mm -V fontsize=10pt -V mainfont="DejaVu Sans" -V CJKmainfont="Noto Sans CJK TC" -V monofont="DejaVu Sans Mono" -V mainfontoptions="Ligatures=NoCommon" -V colorlinks=true -H file/cv-style.tex -o file/cv-en.pdf

pdftotext -layout file/cv-zh.pdf /tmp/cv-zh.txt
pdftotext -layout file/cv-en.pdf /tmp/cv-en.txt

若要用瀏覽器確認版面，可再啟動本機靜態伺服器：

python3 -m http.server 8080

並用瀏覽器確認首頁、CSS、JS、圖片、data/experiences.json、llms.txt、robots.txt、sitemap.xml 都能正常載入。