personal-site

Louis Li|工程實踐與技術筆記

這是放在你電腦裡的完整網站專案,位置是 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:

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: '個人工具'
  }
],

配色設定

參考 links.cwli.dev 的淺藍、白、青色與淡紫漸層。常用色彩集中在 assets/theme.css,個人站、羽球、FANUC 與加工工具共同載入:

Git 版本管理(繁體中文)

本資料夾已是獨立 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。首頁預覽是本站儲存的截圖,點選右上角箭頭可開啟實際工具。

下一步優先順序

  1. 補上實際工作經歷、任職日期、學歷與證照,整理可投遞的履歷。
  2. 選三個代表案例,提供自己的角色、畫面、決策過程與可核對的結果。
  3. 將最常查用的技術逐篇寫成文章,記錄前提、方法、驗證、限制與來源。
  4. 依需求建立真正的私人儲存與登入權限,承載未公開工作筆記。

內容與儲存範圍

網站目前為靜態展示網站,內容以本機檔案維護。瀏覽器搜尋不會將輸入送往伺服器。沒有線上編輯器、帳號系統、雲端筆記或私人後台。先前的 Sites 版本設為僅擁有者可看;這是託管平台的存取設定,不代表本機前端內建私人筆記保護。未來公開前,應把私人草稿放在分離且經身分驗證的儲存系統。

年資、公司經歷與成效數字尚未提供;頁面以待補狀態呈現。既有外部網站僅沿用原連結,沒有把其功能視為已驗證。履歷目前是能力摘要初版,補齊待確認資料後再用於正式投遞。

封裝說明

為遵守本工作區「禁止批量刪除文件或目錄」的規則,封裝流程採新增 staging 目錄並保留,不執行遞迴清理。發佈憑證僅由 stdin 輸入並存於程序記憶體,不寫入專案。