Communitygithub.com

nguyenvuquochung/nguyenvuquochung-portfolio

このスキルは、ポートフォリオサイトをVS CodeからGitHub、Cloudflare Pagesにデプロイするためのワークフローを提供します。

nguyenvuquochung-portfolio とは?

このスキルは、個人ポートフォリオサイト「nguyenvuquochung-portfolio」を開発・デプロイするための完全なワークフローを提供します。VS Code、GitHub、Cloudflare Pages の3つのサービスを連携し、静的サイトの公開を効率化します。主な機能として、ローカルでの初期設定(拡張機能インストール、Git 初期化)、Cloudflare Pages による自動デプロイ(カスタムドメイン設定を含む)、日常的な更新フロー(git add/commit/push で自動再デプロイ)をカバーします。プロジェクト構造は HTML/CSS/JavaScript で構成されており、コンテンツ(自己紹介、プロジェクト一覧など)は各 JS ファイルで管理され、簡単に編集できます。また、オプションの GitHub コンテンツローダーを使用すれば、コードのデプロイなしでコンテンツを更新することも可能です。

対応✓Claude Code~Codex CLI✓Cursor
npx skills add nguyenvuquochung/nguyenvuquochung-portfolio

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

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 レコード (CNAME を nguyenvuquochung-portfolio.pages.dev に向ける) を追加します
  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() — 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 definedindex.html のスクリプト読み込み順序を確認; main.js は最後でなければならない
肖像画がリロードでリセットされる想定内 — 肖像画はメモリにのみ保存されます。永続化には GitHub コンテンツローダーを使用してください
Cloudflare が email-decode スクリプトを挿入正常な動作です。メール難読化のために自動的に <script> タグをラップします

関連スキル