個人網站設定
引導新使用者建立他們自己的作品集,網址為 https://<他們的使用者名稱>.github.io。架構是固定的;外觀、文案和聊天機器人角色會根據特定使用者進行客製化。
他們會得到什麼
- 單頁靜態網站,無需打包工具。GitHub Pages 從
main分支提供服務,儲存庫根目錄即為網站根目錄。 - 英雄區 — 他們的頭像 + 姓名 + 一行位置 + 一行標語。
- 專案區,包含部分標題區的淡出垂直時間軸 (扳手圖示代表工作、書本圖示代表教育、火花圖示代表氛圍/ side-project;每個節點顯示公司、角色、日期、地點) 和主要區域的專案卡片網格 — 兩者皆從使用者的履歷生成。
- 時間軸 ↔ 卡片篩選 — 懸停或鍵盤聚焦時間軸節點可隱藏不相關的專案卡片;點擊可固定篩選 (再次點擊清除)。只有擁有 ≥1 張關聯卡片的節點才會變為可互動;其他節點保持靜態。
- 可摺疊卡片 — 預設情況下,每張專案卡片只顯示其類別 + 標題 + 工具標籤;摘要段落和指標行在懸停/聚焦時顯示,保持網格易於掃視。
- 聊天機器人 (可選) — 浮動的右下角啟動按鈕 + 彈出面板 (非行內頁面區塊),後端由 DeepSeek 的 OpenAI 相容 API 支援,背後有一個 Cloudflare Worker 持有 API 金鑰。使用者選擇機器人名稱;代理程式提議相符的表情符號頭像。機器人回覆會渲染 Markdown。雙層速率限制。
- 聯絡區 — 電子郵件 + 使用者的社交連結。
先決條件
| 需要於 | 工具 | 安裝方式 |
|---|---|---|
| 所有功能 | git | 通常已安裝 |
| 所有功能 | GitHub 帳戶 + gh CLI | brew install gh 然後 gh auth login |
| 所有功能 | python3 (本機預覽) | 通常已安裝 |
| 聊天機器人 | Cloudflare 帳戶 (免費方案) | https://dash.cloudflare.com |
| 聊天機器人 | wrangler CLI | npm install -g wrangler 然後 wrangler login |
| 聊天機器人 | DeepSeek API 金鑰 | https://platform.deepseek.com/ → API keys |
| 頭像調整 | Node.js | brew install node |
逐步說明
1. 收集使用者的輸入
在觸碰任何檔案之前執行此步驟。 一次收集所有資訊,以便後續步驟可以自動化編輯。對於多選題使用 AskUserQuestion,對於自由文字使用直接提示。
從使用者取得以下每個項目:
| 輸入 | 如何詢問 | 範例 |
|---|---|---|
| GitHub 使用者名稱 | 直接提示 | jane (儲存庫將是 jane.github.io) |
| 顯示名稱 | 直接提示 | Jane Doe 或 Jane "JD" Doe |
| 位置短語 | 直接提示,簡短 | NYC metropolitan, Remote, Tokyo |
| 標語 | 直接提示,一句話 | I build ML systems and love shipping. |
| 履歷 | 貼上文字或檔案路徑 | 完整的履歷 — 用於填充時間軸、專案卡片、聊天機器人知識 |
| 照片 | 磁碟上的正方形圖片路徑 | /Users/jane/Desktop/headshot.jpg。使用者可以在 clone 後將其放在儲存庫根目錄,命名為 raw.jpg。 |
| 社交連結 | 直接提示,每個皆為選填 | LinkedIn / GitHub 個人檔案 / Medium / 個人電子郵件 |
| 聊天機器人? | AskUserQuestion | 是 / 否 |
| 聊天機器人名稱 (如果是) | 直接提示 | Pot, Nova, Echo 等 |
| 視覺風格 | AskUserQuestion | "貼上我喜歡的 URL" 或 "用文字描述" |
收集聊天機器人名稱後,提議 2-3 個主題匹配的表情符號頭像,讓使用者選擇。範例:
| 名稱 | 提議的頭像 |
|---|---|
| Pot | 🫖 (茶壺) · 🍲 · 🎨 |
| Nova | 🌟 · 💫 · 🌠 |
| Echo | 📣 · 🔊 · 🌀 |
| Ember | 🔥 · 🪵 · ✨ |
| Atlas | 🗺️ · 🧭 · 🌍 |
| Bit | 💾 · 🔢 · 🤖 |
| Sage | 🌿 · 📖 · 🦉 |
如果沒有明顯適合的,提供中性選項:🤖, 💬, 🪄。儲存所選的表情符號 + 名稱 — 稍後你會將它們寫入程式碼。
2. 建立 GitHub 儲存庫
gh repo create <username>.github.io --public --description "Personal website"
GitHub Pages 使用者網站必須位於 <username>.github.io。
3. 複製模板
git clone https://github.com/donotdonuts/donotdonuts.github.io my-site
cd my-site
rm -rf .git
git init -b main
git remote add origin https://github.com/<username>/<username>.github.io.git
4. 選擇視覺風格
模板預設為奶油色 + IBM Plex Mono 美學。根據使用者在步驟 1 的回答覆寫它。
4a. 如果使用者提供了 URL
抓取頁面的 CSS 並提取 token:
curl -sL "<url>" -o /tmp/ref.html
grep -oE 'href="[^"]+\.css[^"]*"' /tmp/ref.html | sort -u
curl -sL "<origin>/<css-path>" -o /tmp/ref-1.css
# 實際應用於 body 的字型
grep -oE 'body[^{]{0,30}\{[^}]+\}' /tmp/ref-1.css | head -5
# 所有 CSS 自訂屬性定義
grep -oE -- '--[a-zA-Z-]+:[^;}]+' /tmp/ref-1.css | sort -u | head -60
尋找:背景十六進位色、前景/墨色十六進位色、邊框十六進位色、強調色十六進位色、應用於 body 的 font-family、@font-face URL。
4b. 如果使用者提供了描述
將描述轉換為具體的 token。啟發式規則:
| 詞語 | 含義 |
|---|---|
| "minimal", "editorial", "paper" | 奶油色 / 米白色背景,深色墨色,細分隔線 |
| "dark", "terminal", "IDE" | 近黑色背景 (#0f1115),淺色墨色,微妙的灰色邊框 |
| "warm", "analog" | 略帶黃色的奶油色 (#faf5e8),棕黑色墨色 |
| "brutalist" | 純白或純黑,2px+ 實心邊框 |
| "techy", "data" | 等寬字型 (IBM Plex Mono, JetBrains Mono),冷灰色 |
| "magazine", "editorial" | 襯線字型 (EB Garamond, Fraunces),寬鬆行距 |
| "playful" | 一種飽和的強調色,其餘柔和 |
4c. 提議 + 套用
編譯 13 個 token + 一個字型堆疊。在編輯檔案之前,將提議的色板顯示為程式碼區塊並取得批准。
:root {
--bg: <hex>; /* 頁面背景 */
--bg-soft: <hex>; /* 子面板 — 通常是 --bg 混合約 3% 的 --ink */
--bg-hover: <hex>; /* 標籤/晶片懸停 */
--card-bg: <hex>; /* 不透明卡片填充 (淺色主題則為白色) */
--ink: <hex>; /* 主要文字 */
--ink-soft: <hex>; /* 約 80% 的 --ink */
--ink-mute: <hex>; /* 約 60% */
--ink-faint: <hex>; /* 約 40% */
--border: <hex>; /* 微妙分隔線 */
--border-strong: <hex>; /* 承重分隔線 */
--up: <hex>; /* 正面指標 (預設為偏綠色) */
--down: <hex>; /* 負面指標 (預設為偏紅色) */
--accent-ink: <hex>; /* 連結 */
--font-mono: "<Family>", ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
}
然後:
- 開啟
css/styles.css,找到:root區塊,替換數值。 - 開啟
index.html,更新<head>中的 Google Fonts<link>,使用新的字型系列 + 字重。
5. 從履歷 + 輸入生成內容
使用步驟 1 的履歷和其他輸入來填充 index.html:
-
<head>—<title>=<顯示名稱> — <履歷中的第一個角色>;<meta name="description">來自標語。 -
英雄區:
<h1 class="hero-title">← 顯示名稱<p class="hero-location">← 位置短語<p class="hero-tagline">← 標語
-
時間軸 — 將履歷解析為節點。每個角色、每個學位以及每個使用者想要展示的正在進行的個人 side-project 類別各一個
<li class="tl-stop">。順序為現在 → 最早 (DOM 中由上到下)。 為每個節點選擇一個簡短的data-experienceslug (例如mars,vibe,coach,gatech) — 這是篩選器用來連結節點和卡片的。僅在擁有 ≥1 張關聯專案卡片的節點上添加tabindex="0"(其他節點保持靜態)。<li class="tl-stop tl-stop-work" data-experience="<slug>" tabindex="0"> <!-- tl-stop-work | tl-stop-edu | tl-stop-vibe (選擇一個) --> <svg class="tl-icon tl-icon-work" aria-hidden="true"> <use href="#icon-wrench"/> <!-- #icon-wrench | #icon-book | #icon-sparkle --> </svg> <div class="tl-info"> <strong>公司 / 學校</strong> <span>角色 / 學位</span> <em>開始 — 結束</em> <i class="tl-loc">城市, 州</i> </div> </li>在沒有關聯專案卡片的教育/舊角色節點上去掉
tabindex="0"—js/main.js會在載入時自動偵測這些節點並讓它們保持非互動。 -
專案 — 約六個
<article class="project-card">區塊,從履歷中顯著的專案/成就生成。每張卡片必須攜帶一個data-experienceslug,與其來源的節點匹配,否則它將不參與篩選:<article class="project-card" data-experience="<slug>"> <header class="project-head"> <span class="project-tag">類別</span> <h3>專案標題</h3> </header> <p>1–2 句摘要,取自履歷要點。</p> <dl class="project-metrics"> <div><dt>指標</dt><dd class="up">+數值</dd></div> <div><dt>指標</dt><dd>數值</dd></div> </dl> <ul class="tag-list small"><li>工具</li><li>工具</li></ul> </article>使用
<dd class="up">/<dd class="down">為指標上色。卡片預設渲染為摺疊狀態 — 僅標籤、標題和工具標籤可見,直到懸停 / focus-within 揭示摘要 + 指標。保持摘要簡潔;它們存在的唯一目的是獎勵懸停行為。 -
聊天問候語 — 機器人的開場訊息是
index.html中#chat-panel內的行內 HTML (在面板的<div class="chat-log">內部),這樣當使用者首次開啟彈出視窗時它會立即渲染。使用所選的機器人名稱 + 頭像表情符號重新編寫。格式:<div class="chat-msg chat-msg-bot"> <span class="chat-avatar" aria-label="<機器人名稱>">表情符號</span> <div class="chat-bubble"> <p>嗨,我是 <strong><機器人名稱></strong> — <顯示名稱> 的 AI 助手,從他/她的履歷中 <動詞變化> 而來。</p> <p>你可以問我關於:</p> <ul> <li>公司 / 角色</li> <li>方法 / 途徑</li> <li>專案 / 技能 / 學歷</li> </ul> <p>你想了解什麼?</p> </div> </div> -
聯絡區 — 電子郵件 + 每個提供的社交連結作為
.connect-list中的<li>。刪除任何未提供平台的行。
6. 添加頭像
詢問他們的照片在哪裡。將其複製到儲存庫根目錄,命名為 raw.jpg,然後調整大小:
cp <使用者照片路徑> raw.jpg
mkdir -p assets
sips -Z 720 raw.jpg --out assets/portrait.jpg
如果照片的背景與新的 --bg 不匹配,使用捆綁的腳本進行調整:
cd /tmp && rm -rf img-fix && mkdir img-fix && cd img-fix
npm init -y > /dev/null
npm install [email protected] --silent
node <此技能目錄>/scripts/shift-portrait.js \
/path/to/my-site/raw.jpg \
/path/to/my-site/assets/portrait.jpg \
"#<你的背景十六進位色>"
如果省略第三個參數,預設為 #fbf7eb。raw.jpg 已被 .gitignore 忽略。
7. 設定聊天機器人 (如果使用者說不則跳過)
7a. Worker
cd worker
wrangler login
wrangler secret put DEEPSEEK_API_KEY
worker/wrangler.toml:
ALLOWED_ORIGIN = "https://<username>.github.io,http://localhost:8000,http://127.0.0.1:8000"
MODEL = "deepseek-chat"
worker/worker.js → SYSTEM_PROMPT — 從使用者的履歷重新編寫。保持段落結構 (關於 / 目前角色 / 過去角色 / 學歷 / 工具箱)。也使用機器人的名稱 + 頭像重新編寫開場角色句子:
const SYSTEM_PROMPT = `You are "<機器人名稱>" <表情符號> — a friendly, concise AI assistant embedded on <顯示名稱>'s personal website. …`;
部署:
wrangler deploy
7b. 客戶端
js/config.js:
window.SITE_CONFIG = {
chatWorkerUrl: "https://<worker>.workers.dev",
};
js/chatbot.js — 更新頂部的常數:
const AVATAR = "<表情符號>";
const AVATAR_LABEL = "<機器人名稱>";
8. 預覽 + 推送
python3 -m http.server 8000 # http://localhost:8000
點擊每個部分進行檢查。測試聊天功能。調整為行動裝置寬度。然後:
git add .
git commit -m "initial: personal site"
git push -u origin main
網站位於 https://<username>.github.io/,約 60 秒內上線。
模板架構 (請勿更改)
區塊佈局
每個區塊都使用 .section-grid: 280px 1fr。280px 欄位容納最長的時間軸標籤。如果所有標籤都很短,則縮小為 240px;如果較長,則放大為 320px。
時間軸
- 位於專案「section-head」內,就在標題下方,
opacity: 0.45。懸停、聚焦或啟用篩選時會提高到 0.95。 - DOM 順序 = 視覺由上到下順序。 現在 → 最早。不是按時間比例 — 透過 flex
gap均勻分佈。 - 開箱即用三種圖示類型:
#icon-wrench(工作,.tl-stop-work)、#icon-book(教育,.tl-stop-edu)、#icon-sparkle(氛圍 / side-project,.tl-stop-vibe)。所有三個<symbol>定義都位於<header>之後的 SVG sprite 中。要新增圖示類別:- 使用你的 SVG 路徑新增一個
<symbol id="icon-foo"> - 新增
.tl-icon-foo { color: var(--ink-mute); } - 使用
<svg class="tl-icon tl-icon-foo"><use href="#icon-foo"/></svg>引用
- 使用你的 SVG 路徑新增一個
- 每個節點都帶有
data-experience="<slug>";其 slug 與至少一張專案卡片匹配的節點也會獲得tabindex="0",以便js/main.js可以讓它們成為篩選互動式節點。
專案篩選 (點擊 + 懸停)
完全由 js/main.js 驅動,無需配置 — 它在載入時掃描 DOM,僅在適用的地方連接處理常式。
- 載入時,其
data-experienceslug 存在於至少一個.project-card上的每個節點都會獲得.tl-stop-has-projects+role="button"+aria-pressed="false"。沒有關聯卡片的節點保持靜態。 - 懸停 / 聚焦 一個互動節點 → 臨時篩選:不匹配的卡片變成
.is-dim(網格添加.is-filtering,CSS 將其轉換為對變暗的卡片使用display: none— 它們會從佈局中移除,而不僅僅是淡出)。 - 點擊 (或
Enter/Space) → 鎖定:節點獲得.is-locked,不透明度全滿,墨色圖示,底線公司名稱。再次點擊同一個節點可清除;點擊另一個可切換。 - 鎖定時,懸停不同的節點會預覽其卡片;從軌道上
mouseleave(或focusout離開它) 會恢復到鎖定的節點。懸停時不會清除鎖定。