這是放在你電腦裡的完整網站專案,位置是 C:\Users\Louis\Desktop\CWLI\personal-site。
本站同時作為個人介紹、作品集、面試履歷與長期技術知識索引。原本 C:\Users\Louis\Desktop\links 保留,新版採獨立資料夾維護。
直接雙擊根目錄的 開啟網站.html,就會開啟 dist/index.html。也可以直接將 dist/index.html 拖進瀏覽器。
所有前端資源均在本專案內,不需要 CDN、安裝套件或建置;介紹、作品詳情、技術搜尋與履歷可在本機使用。外部作品連結、Email 與 LINE 則連到對應網站或應用程式。
需要 HTTP 預覽時,在本資料夾執行:
node scripts/preview.mjs
開啟程式顯示的 http://127.0.0.1:5503。關閉預覽可按 Ctrl+C。一般修改內容不需要執行發佈工具。
personal-site/
├─ 開啟網站.html 雙擊開啟本機網站
├─ README.md 本說明與 Git 使用方式
├─ QA.md 驗證紀錄與限制
├─ .editorconfig UTF-8 與兩格縮排設定
├─ .gitattributes Git 文字換行與圖片格式設定
├─ .gitignore Git 排除暫存檔與憑證
├─ dist/ 完整網站;可直接開啟與修改
│ ├─ index.html 五個頁面的版面與固定文案
│ ├─ content.js 個人資料、能力、作品、技術主題、履歷
│ ├─ styles.css 共用版面、手機版、列印版
│ ├─ studio.css 個人工作室首頁、作品舞台與微互動
│ ├─ tools.css 小工具卡片、搜尋分類與首頁入口
│ ├─ work.css 作品頁及作品詳情的閱讀字級與響應式排版
│ ├─ app.js 導覽、列表、搜尋、分類、詳情與列印
│ ├─ tools/ 羽球 badminton/、FANUC 查找 fanuc-macro/、加工 machining-calculator/
│ └─ assets/ 共用 theme.css、頭像、圖示與專案截圖
├─ docs/
│ ├─ support-center-case.md 代表作品的事實與畫面來源
│ ├─ badminton-tool.md 羽球工具複本、修改位置與驗證說明
│ ├─ fanuc-macro-tool.md FANUC 資料、手冊來源及工具維護方式
│ └─ machining-calculator.md 加工計算、單位、公式來源與維護方式
├─ scripts/
│ ├─ preview.mjs 可選的本機預覽工具
│ ├─ check-fanuc.mjs FANUC 條目、來源關聯及 G65 引數對照檢查
│ ├─ check-machining.mjs 加工公式、輸入驗證與單位換算檢查
│ └─ publish-source.mjs 可選的 Sites 發佈工具
└─ .openai/hosting.json 既有 Sites 身分與部署設定
.git/ 保存本機版本紀錄;.staging/ 是先前發佈保留的封裝資料,已排除於 Git 之外,不是日常編輯的位置。
主要編輯 dist/content.js:
profile:個人資料與聯絡入口。姓名、職稱、個人簡介與 Email 會套用到頁面;其餘固定文案與頁尾位於 index.html。showcase:首頁可切換的專案畫面,包含按鈕標籤、標題、圖片路徑、說明與對應正式網址。tools:個人小工具清單,已加入「羽球開打」、「FANUC Macro B 指令手冊」及「加工計算工具箱」。填入工具名稱、分類、用途、標籤與網址後,工具箱會自動產生卡片、分類與搜尋。competencies:四類能力,會同步顯示在首頁與履歷。projects:每個案例保留背景、方法、證據與下一步;只有可確認的成果才加入。knowledge:每個主題包含分類、關鍵字與文章段落。現有 8 篇為整理範本;轉成正式文章時,需同步調整 app.js 的範本顯示文字。resume:個人摘要、技術清單與待補資料。dist/assets/theme.css 管理主站與小工具共用配色;dist/styles.css 管理共用版面與列印版;dist/studio.css 管理新版首頁排版與微互動。dist/app.js 管理導覽、作品舞台、案例詳情、知識搜尋與分類。
| 想修改什麼 | 編輯位置 |
|---|---|
| 姓名、職稱、簡介、聯絡方式 | content.js 的 profile |
| 首頁專長與履歷能力 | content.js 的 competencies |
| 新增作品、補上成果與證據 | content.js 的 projects |
| 新增技術主題與文章段落 | content.js 的 knowledge |
| 履歷摘要、技術與待補資料 | content.js 的 resume |
| 首頁大標題、固定介紹、頁尾 | index.html 的繁體中文分區 |
| 首頁展示的專案畫面與連結 | content.js 的 showcase |
| 新增自己的小工具 | content.js 的 tools;本機程式放在 dist/tools/ |
| 主站與工具的背景、文字、按鈕及卡片色彩 | assets/theme.css 的共用色彩變數 |
| 首頁錯落卡片、漂浮標籤、畫面舞台 | studio.css 的繁體中文分區 |
| 小工具的卡片與搜尋分類版面 | tools.css 的繁體中文分區 |
| 作品頁標題、摘要、標籤及作品詳情字級 | work.css 的繁體中文分區 |
| 手機與列印版面 | styles.css 的響應式與列印區塊 |
| 搜尋、切頁與詳情行為 | app.js 的編號功能區塊 |
用 VS Code 或其他支援 UTF-8 的文字編輯器開啟整個資料夾。修改後儲存,再重新整理瀏覽器;若仍看到舊樣式,可按 Ctrl+F5。
新增資料時,複製同類型的一整個物件,保留欄位名稱與逗號。projects 與 knowledge 的 id 應維持唯一且穩定,因為它會成為詳情網址的一部分。
上方導覽「小工具」與首頁「打開工具箱」皆通往 #tools。目前已有「羽球開打」,程式位於 dist/tools/badminton/;詳細修改說明見 docs/badminton-tool.md。
「FANUC Macro B 指令手冊」位於 dist/tools/fanuc-macro/,涵蓋 Macro B 與銑床/加工中心常用 G、M 指令。條目與來源分別在 macro-data.js、command-data.js 維護;支援代碼別名、變數範圍、中文及多詞搜尋、用途分類、收藏、複製與 G65 引數對照。修改後可執行 node scripts/check-fanuc.mjs 檢查資料。完整說明見 docs/fanuc-macro-tool.md。
FANUC 手機版的 App 外觀集中於同目錄 mobile.css;固定搜尋、底部「查指令/引數表/收藏/說明」、分頁查詢記憶及詳情返回由 app.js 管理,800px 以下啟用。
「加工計算工具箱」位於 dist/tools/machining-calculator/,提供銑削、鑽削、車削、螺紋與攻牙、公差與配合五個分類,支援公英制、即時計算、複製結果及收藏。手機使用大圖示分類列與底部「分類/計算/收藏/說明」導覽。公差依使用者輸入的圖面偏差計算,沒有內建 ISO 等級表;攻牙底孔僅提供公制 60° 切削攻牙粗估。公式核心、目錄與介面分別在 engine.js、catalog.js、app.js 維護,修改後執行 node scripts/check-machining.mjs。完整說明見 docs/machining-calculator.md。
加工工具首頁與收藏頁的五張原創加工插圖放在同目錄 illustrations/,使用 SVG 保持放大清晰;桌機與手機的插圖尺寸由 app.css 的 .category-art 調整。
羽球工具的手機介面集中在 dist/tools/badminton/mobile.css(四分頁、底部導覽、觸控尺寸)與 mobile-app.js(切頁、焦點、操作按鈕位置);本機 Bootstrap Icons 由 icons.js 管理,原始 SVG 與授權放在 vendor/icons/。修改手機版不需要另建一份名單、比分或儲存資料。
在 dist/content.js 找到 tools 陣列,保留既有工具,再依下列格式加入新物件。以下為填寫範例,需替換成自己的名稱與可開啟網址:
tools: [
{
id: 'my-tool',
title: '我的工具名稱',
category: '日常工具',
description: '簡短說明這個工具能幫忙完成什麼事情。',
url: 'tools/my-tool/index.html',
icon: 'grid',
tags: ['關鍵字'],
source: '個人工具'
}
],
dist/tools/my-tool/index.html,相關 CSS、JavaScript、圖片放在同一工具子資料夾;url 使用相對於 dist/index.html 的路徑。url 換成完整 HTTP(S) 網址,點選後會在新分頁開啟。icon 可填 calculator、code、document、grid、badminton;未指定時使用方格圖示。category 自動建立,搜尋涵蓋名稱、分類、說明、來源與標籤。參考 links.cwli.dev 的淺藍、白、青色與淡紫漸層。常用色彩集中在 assets/theme.css,個人站、羽球、FANUC 與加工工具共同載入:
#eef8ff#172033#0ea5e9#0369a1#67e8f9本資料夾已是獨立 Git 儲存庫。本次以繁體中文提交訊息記錄修改;先前版本紀錄完整保留。日後修改完成,可在此資料夾執行:
git status
git add --all
git commit -m "更新個人履歷與作品內容"
git log --oneline -5
git commit 會把版本保存在這台電腦;推送遠端與發佈網站是另外的步驟。本機檔案修改後,先前線上預覽不會自動更新。
程式碼、註解與文件採 UTF-8;本儲存庫也設定 Git 提交與紀錄輸出使用 UTF-8,中文檔名直接顯示。
五個導覽頁面、作品詳情、小工具分類與搜尋、可分享的主題網址(例如 #notes/cam-review-checklist)、搜尋與分類交集、空結果提示、手機選單、鍵盤操作、可列印的履歷版面。
首頁改為個人數位工作室:Support Center 真實畫面手動切換、方向鍵選擇、對應實際工具連結、錯落作品與筆記入口、捲動進場與桌機作品卡輕微傾角。啟用「減少動態效果」時,保留功能並停止漂浮、進場與傾角動畫。
Nine9 Support Center 為目前代表案例,共有 5 項作品入口。專案截圖於 2026-11-18 由正式網站擷取,畫面來源與可確認的參與範圍記錄在 docs/support-center-case.md。首頁預覽是本站儲存的截圖,點選右上角箭頭可開啟實際工具。
網站目前為靜態展示網站,內容以本機檔案維護。瀏覽器搜尋不會將輸入送往伺服器。沒有線上編輯器、帳號系統、雲端筆記或私人後台。先前的 Sites 版本設為僅擁有者可看;這是託管平台的存取設定,不代表本機前端內建私人筆記保護。未來公開前,應把私人草稿放在分離且經身分驗證的儲存系統。
年資、公司經歷與成效數字尚未提供;頁面以待補狀態呈現。既有外部網站僅沿用原連結,沒有把其功能視為已驗證。履歷目前是能力摘要初版,補齊待確認資料後再用於正式投遞。
為遵守本工作區「禁止批量刪除文件或目錄」的規則,封裝流程採新增 staging 目錄並保留,不執行遞迴清理。發佈憑證僅由 stdin 輸入並存於程序記憶體,不寫入專案。