作品集部署工作流
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 构建设置
这是一个无需构建步骤的静态站点:
| 设置 | 值 |
|---|---|
| 框架预设 | 无 |
| 构建命令 | (留空) |
| 构建输出目录 | / |
| 根目录 | (留空) |
点击 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 "Update: 描述更改内容"
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 数组 + render/nav(绿色)
│ ├── director.js ← P4_PROJECTS 数组 + render/nav(蓝色)
│ ├── assistant.js ← P5_PROJECTS 数组 + render/nav(红色)
│ ├── editor.js ← P6_PROJECTS 数组 + render/nav(黄色)
│ └── 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: '项目的简短描述。',
img: '' // 留空或添加 URL
},
// ... 已有条目
];
新项目应添加到对应角色数组(
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> 标签以实现邮箱混淆 |