Communitygithub.com

nguyenvuquochung/nguyenvuquochung-portfolio

将静态作品集网站从 VS Code 部署到 Cloudflare Pages 的完整工作流程指南。

nguyenvuquochung-portfolio 是什么?

该技能提供了一个端到端的工作流程指南,用于将静态单页作品集网站(nguyenvuquochung-portfolio)从本地 VS Code 开发环境部署到 Cloudflare Pages。它涵盖了从一键设置、Git 初始化到 Cloudflare Pages 连接和自定义域名配置的所有步骤。每天只需执行 `git add`、`git commit` 和 `git push` 即可自动触发重新部署,约 30 秒内上线。技能适用于所有基于 Git 的静态站点,并支持通过 GitHub 原始内容加载器实现无需重新部署的内容更新。

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

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

作品集部署工作流

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 构建设置

这是一个无需构建步骤的静态站点:

设置值
框架预设无
构建命令(留空)
构建输出目录/
根目录(留空)

点击 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 "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> 标签以实现邮箱混淆

相关技能