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 レコード (CNAME を
nguyenvuquochung-portfolio.pages.devに向ける) を追加します - 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() — 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 ファイルを編集。例: Director プロジェクト (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: '' // 空のまま、またはURLを追加
},
// ... 既存のエントリ
];
新しいプロジェクトは、該当するロールの配列 (
js/assistant.js、js/director.js、js/production.js、js/editor.js) の先頭に追加してください。これにより、そのページで最初に表示されます。表示順序は、最近追加されたアイテムが先頭になるよう、挿入順に従う必要があります。
アクセントカラーの変更
style.css の :root ブロックを編集:
:root {
--green: #00e676; /* Production */
--blue: #1a6fff; /* Director */
--red: #ff1a1a; /* Assistant Director */
--yellow: #ffe000; /* Editor */
}
6. Cloudflare コンテンツローダー (任意)
main.js には GitHub の生コンテンツローダーが含まれています。再デプロイせずにコンテンツを更新したい場合、content.json を GitHub でホストし、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> タグをラップします |