Portfolio 部署工作流程
VS Code → GitHub → Cloudflare Pages
1. 一次性設定
1.1 VS Code 擴充功能
開始前請先安裝這些擴充功能:
- Live Server (
ritwickdey.liveserver) — 無需建置步驟即可在本機預覽網站 - GitLens (選擇性) — 強化 Git 歷史記錄檢視
1.2 建立 GitHub 儲存庫
- 前往 github.com → New repository
- 名稱:
nguyenvuquochung-portfolio(與資料夾名稱相同,避免混淆) - 可見性:Public (免費使用 Cloudflare Pages 的必要條件)
- 不要 加入 README/gitignore (你已經有本機檔案)
1.3 在本機初始化 Git
開啟 VS Code 終端機 (Ctrl+`` ) 並執行:
git init
git add .
git commit -m "Initial commit"
git branch -M main
git remote add origin https://github.com/YOUR_USERNAME/nguyenvuquochung-portfolio.git
git push -u origin main
專案中已包含 .gitattributes 檔案,內容為 * text=auto eol=lf,這能確保所有平台上都使用一致的 Unix 換行格式。
2. Cloudflare Pages — 首次部署
2.1 連接儲存庫
- 登入 dash.cloudflare.com
- 前往 Workers & Pages → Create application → Pages → Connect to Git
- 授權 GitHub 並選取
nguyenvuquochung-portfolio儲存庫
2.2 建置設定
這是一個靜態網站,無需建置步驟:
| 設定 | 值 |
|---|---|
| Framework preset | None |
| Build command | (保持空白) |
| Build output directory | / |
| Root directory | (保持空白) |
點擊 Save and Deploy。你的網站將在大約 30 秒內於 https://nguyenvuquochung-portfolio.pages.dev 上線。
2.3 透過 Cloudflare DNS 設定自訂網域
- 在 Pages 專案中 → Custom domains → Set up a custom domain
- 輸入你的網域 (例如
nguyenvuquochung.com) - Cloudflare 會自動新增 DNS 記錄 (指向
nguyenvuquochung-portfolio.pages.dev的 CNAME) - SSL 憑證會自動佈建 — 無需額外設定
如果你的網域是在 Cloudflare 之外註冊的: 請先在你的網域註冊商處將名稱伺服器更新為 Cloudflare 的名稱伺服器,然後 DNS 自動設定才會生效。
3. 日常開發流程
每次更新內容或程式碼時:
# 1. 在 VS Code 中儲存你的變更
# 2. 暫存、提交並推送
git add .
git commit -m "更新:描述變更內容"
git push
Cloudflare Pages 會偵測到推送並自動重新部署。約 30 秒後即可上線。
4. 專案結構
nguyenvuquochung-portfolio/
├── index.html ← HTML 骨架 (7 個虛擬頁面,所有版面配置)
├── style.css ← 所有 CSS (變數、動畫、頁面系統)
├── js/
│ ├── content.js ← 雙語文字資料 (const C = {en, vi})
│ ├── about.js ← renderP2() — 關於我頁面渲染器
│ ├── contact.js ← goToPage7 / goToPage1FromP7
│ ├── production.js ← P3_PROJECTS 陣列 + 渲染/導航 (綠色)
│ ├── director.js ← P4_PROJECTS 陣列 + 渲染/導航 (藍色)
│ ├── assistant.js ← P5_PROJECTS 陣列 + 渲染/導航 (紅色)
│ ├── editor.js ← P6_PROJECTS 陣列 + 渲染/導航 (黃色)
│ └── main.js ← 核心引擎:游標、物理、轉場、導航、載入器
├── .gitattributes ← 強制使用 LF 換行
└── SKILL.md ← 本檔案
腳本載入順序
腳本必須按此順序載入 (已在 index.html 中設定):
content.js → about.js → contact.js → production.js → director.js → assistant.js → editor.js → main.js
main.js 必須最後載入,因為它會呼叫所有其他檔案中定義的函式。
5. 更新內容
變更個人簡介 / 引言 / 作品集
編輯 js/content.js — C 物件包含所有雙語文字:
const C = {
en: { sub: "...", about: [...], films: [...], ... },
vi: { sub: "...", about: [...], films: [...], ... }
};
在角色頁面中新增專案卡片
編輯對應的 js/*.js 檔案。例如,為導演專案 (js/director.js):
const P4_PROJECTS = [
{
id: 'my-new-film',
title: 'Tên Phim',
en: 'Film Title',
year: '2025',
desc: 'Short description of the project.',
img: '' // 保留空白或填入網址
},
// ... 現有項目
];
新專案應新增在相關角色陣列 (
js/assistant.js、js/director.js、js/production.js、js/editor.js) 的開頭,以便它們在該頁面上優先顯示。顯示順序應遵循最近新增項目的插入順序,目前最新新增的項目在最上方。
變更強調色
編輯 style.css 中的 :root 區塊:
:root {
--green: #00e676; /* 製作 */
--blue: #1a6fff; /* 導演 */
--red: #ff1a1a; /* 副導演 */
--yellow: #ffe000; /* 剪輯 */
}
6. Cloudflare 內容載入器 (選擇性)
main.js 包含一個 GitHub 原始內容載入器。如果你想在不重新部署的情況下更新內容,請在 GitHub 上託管一個 content.json 檔案,並在 main.js 頂部設定這些常數:
const GITHUB_OWNER = 'your-username';
const GITHUB_REPO = 'nguyenvuquochung-portfolio';
const GITHUB_BRANCH = 'main';
const GITHUB_PATH = 'content.json';
設定完成後,網站將在每次載入時擷取更新後的內容。將其留空則可停用此功能。
7. 疑難排解
| 問題 | 解決方法 |
|---|---|
| 網站顯示舊版本 | 強制重新整理:Ctrl+Shift+R。清除 Cloudflare 快取:Pages → Caching → Purge cache |
| 自訂網域無法運作 | 檢查 Cloudflare DNS 是否已有 CNAME 記錄;等待最多 5 分鐘以讓記錄傳播 |
| JS 錯誤「X is not defined」 | 檢查 index.html 中的腳本載入順序;main.js 必須最後載入 |
| 橫幅圖片在重新整理後重置 | 這是預期行為 — 橫幅僅儲存在記憶體中。使用 GitHub 內容載入器來持久化儲存 |
| Cloudflare 注入 email-decode 腳本 | 這是正常行為;它會自動包裹你的 <script> 標籤以進行電子郵件混淆 |