Communitygithub.com

nguyenvuquochung/nguyenvuquochung-portfolio

開始前請先安裝這些擴充功能:

nguyenvuquochung-portfolio 是什麼?

此技能提供了一個完整的部署工作流程,用於將 nguyenvuquochung 的作品集靜態網站從 VS Code 部署到 GitHub,再透過 Cloudflare Pages 託管。它詳細說明了單次設定步驟,包括安裝 VS Code 擴充功能(如 Live Server)、在 GitHub 上建立儲存庫以及初始化本地 Git。核心部署部分展示了如何連接 Cloudflare Pages、配置建置設定(無需建置步驟,輸出目錄為根目錄 /)以及設定自訂網域。日常開發流程非常簡潔:只需執行 git add、git commit 和 git push,Cloudflare Pages 便會自動偵測變更並在約 30 秒內重新部署。此技能支援 Windows、macOS 和 Linux 平台,主要透過 VS Code 終端機操作。專案結構說明了每個 JavaScript 檔案的角色(如 content.js 負責雙語文字、main.js 負責核心引擎),並強調了腳本載入順序的重要性。此外,它還涵蓋了內容更新(編輯 content.js 中的 C 物件、在角色頁面中新增專案卡片、修改 CSS 中的強調色),以及選用的 GitHub 原始內容載入器功能,讓您無需重新部署即可更新內容。最後還包含了常見問題的疑難排解指引。

相容平台✓Claude Code~Codex CLI✓Cursor
npx skills add nguyenvuquochung/nguyenvuquochung-portfolio

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Portfolio 部署工作流程

VS Code → GitHub → Cloudflare Pages


1. 一次性設定

1.1 VS Code 擴充功能

開始前請先安裝這些擴充功能:

  • Live Server (ritwickdey.liveserver) — 無需建置步驟即可在本機預覽網站
  • GitLens (選擇性) — 強化 Git 歷史記錄檢視

1.2 建立 GitHub 儲存庫

  1. 前往 github.com → New repository
  2. 名稱:nguyenvuquochung-portfolio (與資料夾名稱相同,避免混淆)
  3. 可見性:Public (免費使用 Cloudflare Pages 的必要條件)
  4. 不要 加入 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 連接儲存庫

  1. 登入 dash.cloudflare.com
  2. 前往 Workers & Pages → Create application → Pages → Connect to Git
  3. 授權 GitHub 並選取 nguyenvuquochung-portfolio 儲存庫

2.2 建置設定

這是一個靜態網站,無需建置步驟:

設定值
Framework presetNone
Build command(保持空白)
Build output directory/
Root directory(保持空白)

點擊 Save and Deploy。你的網站將在大約 30 秒內於 https://nguyenvuquochung-portfolio.pages.dev 上線。

2.3 透過 Cloudflare DNS 設定自訂網域

  1. 在 Pages 專案中 → Custom domains → Set up a custom domain
  2. 輸入你的網域 (例如 nguyenvuquochung.com)
  3. Cloudflare 會自動新增 DNS 記錄 (指向 nguyenvuquochung-portfolio.pages.dev 的 CNAME)
  4. 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> 標籤以進行電子郵件混淆

相關技能