포트폴리오 배포 워크플로우은(는) 무엇을 하나요?
VS Code → GitHub → Cloudflare Pages
1. 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 레코드(CNAME이
nguyenvuquochung-portfolio.pages.dev를 가리킴)를 자동으로 추가합니다. - 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() — About Me 페이지 렌더러
│ ├── 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: '프로젝트에 대한 간단한 설명.',
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-raw 콘텐츠 로더가 포함되어 있습니다. 재배포 없이 콘텐츠를 업데이트하려면 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가 이메일 디코드 스크립트를 삽입함 | 정상 동작입니다. 이메일 난독화를 위해 자동으로 <script> 태그를 래핑합니다 |