個人サイトのセットアップ
新しいユーザーが https://<ユーザー名>.github.io で自分のポートフォリオを公開できるよう導きます。アーキテクチャは固定ですが、見た目、コピー、チャットボットのペルソナはすべてユーザーごとにカスタマイズされます。
得られるもの
- シングルページ静的サイト、バンドラー不要。GitHub Pages がリポジトリルートの
mainブランチを配信します。 - ヒーローセクション — ユーザーの肖像写真 + 名前 + 一行の所在地 + 一行のキャッチコピー。
- プロジェクトセクション — セクションヘッダーにフェードした縦のタイムライン(仕事はレンチアイコン、学歴は本アイコン、雰囲気/サイドプロジェクトはスパークルアイコン。各停止点は会社、役職、日付、所在地を表示)と、本文にプロジェクトカードのグリッド。両方ともユーザーの履歴書から生成されます。
- タイムライン ↔ カードフィルター — タイムラインの停止点にホバーまたはキーボードフォーカスすると、関連しないプロジェクトカードが非表示になります。クリックでフィルターを固定(もう一度クリックで解除)。連携するカードが1枚以上ある停止点のみインタラクティブになります。その他は非アクティブのままです。
- 折りたたみカード — 各プロジェクトカードはデフォルトでカテゴリ + タイトル + ツールタグのみを表示します。ホバー/フォーカスで要約段落と指標行が表示され、グリッドがスキャンしやすくなります。
- チャットボット(オプション) — 右下に浮かぶ起動ボタンとポップアウトパネル(インラインページセクションではありません)。DeepSeek の OpenAI 互換 API を Cloudflare Worker 経由で使用し、API キーを保持します。ユーザーがボットの名前を選択し、エージェントがマッチする絵文字アバターを提案します。ボットの返信はマークダウンをレンダリングします。2層のレート制限があります。
- コンタクトセクション — メール + ユーザーのソーシャルURL。
前提条件
| 必要なもの | ツール | インストール方法 |
|---|---|---|
| すべて | git | 通常インストール済み |
| すべて | GitHub アカウント + gh CLI | brew install gh その後 gh auth login |
| すべて | python3(ローカルプレビュー用) | 通常インストール済み |
| チャットボット | Cloudflare アカウント(無料枠) | https://dash.cloudflare.com |
| チャットボット | wrangler CLI | npm install -g wrangler その後 wrangler login |
| チャットボット | DeepSeek API キー | https://platform.deepseek.com/ → API keys |
| 肖像写真の色調整 | Node.js | brew install node |
ステップバイステップ
1. ユーザーから入力を収集する
ファイルに触れる前にこれを行ってください。 すべての入力を一度に収集し、後のステップで自動編集できるようにします。複数選択肢には AskUserQuestion を、自由記述には直接プロンプトを使用します。
以下をすべてユーザーから取得します。
| 入力 | 質問方法 | 例 |
|---|---|---|
| GitHub ユーザー名 | 直接 | jane(リポジトリは jane.github.io になります) |
| 表示名 | 直接 | Jane Doe または Jane "JD" Doe |
| 所在地フレーズ | 直接、短く | NYC metropolitan、Remote、Tokyo |
| キャッチコピー | 直接、一文 | I build ML systems and love shipping. |
| 履歴書 | テキストを貼り付け、またはファイルパス | 完全な履歴書 — タイムライン、プロジェクトカード、チャットボットナレッジに使用 |
| 写真 | ディスク上の正方形画像のパス | /Users/jane/Desktop/headshot.jpg。クローン後、リポジトリルートに raw.jpg として配置可能 |
| ソーシャルURL | 直接、各オプション | LinkedIn / GitHub プロフィール / Medium / 個人メール |
| チャットボット? | AskUserQuestion | はい / いいえ |
| チャットボット名(「はい」の場合) | 直接 | Pot、Nova、Echo など |
| ビジュアルスタイル | AskUserQuestion | 「参考にしたいURLを貼る」または「言葉で説明する」 |
チャットボット名を収集した後、テーマに合う絵文字アバターを2~3個提案し、ユーザーに選んでもらいます。例:
| 名前 | 提案するアバター |
|---|---|
| Pot | 🫖(ティーポット)· 🍲 · 🎨 |
| Nova | 🌟 · 💫 · 🌠 |
| Echo | 📣 · 🔊 · 🌀 |
| Ember | 🔥 · 🪵 · ✨ |
| Atlas | 🗺️ · 🧭 · 🌍 |
| Bit | 💾 · 🔢 · 🤖 |
| Sage | 🌿 · 📖 · 🦉 |
明確に合うものがなければ、ニュートラルな 🤖、💬、🪄 を提案します。選択された絵文字と名前を保存し、後でコードに書き込みます。
2. GitHub リポジトリを作成する
gh repo create <ユーザー名>.github.io --public --description "個人ウェブサイト"
GitHub Pages のユーザーサイトは <ユーザー名>.github.io である必要があります。
3. テンプレートをクローンする
git clone https://github.com/donotdonuts/donotdonuts.github.io my-site
cd my-site
rm -rf .git
git init -b main
git remote add origin https://github.com/<ユーザー名>/<ユーザー名>.github.io.git
4. ビジュアルスタイルを選ぶ
テンプレートのデフォルトはクリーム + IBM Plex Mono の外観です。ステップ1でのユーザーの回答に基づいて上書きします。
4a. ユーザーがURLを指定した場合
ページのCSSを取得し、トークンを抽出します。
curl -sL "<url>" -o /tmp/ref.html
grep -oE 'href="[^"]+\.css[^"]*"' /tmp/ref.html | sort -u
curl -sL "<origin>/<css-path>" -o /tmp/ref-1.css
# bodyに実際に適用されているフォント
grep -oE 'body[^{]{0,30}\{[^}]+\}' /tmp/ref-1.css | head -5
# すべてのCSSカスタムプロパティ定義
grep -oE -- '--[a-zA-Z-]+:[^;}]+' /tmp/ref-1.css | sort -u | head -60
以下を探します: 背景の16進数、前景/インクの16進数、境界線の16進数、アクセントの16進数、bodyに適用されている font-family、@font-face URL。
4b. ユーザーが説明文を指定した場合
説明を具体的なトークンに変換します。ヒューリスティック:
| 単語 | 意味 |
|---|---|
| "ミニマル"、"エディトリアル"、"ペーパー" | クリーム/オフホワイト背景、ダークインク、細い区切り線 |
| "ダーク"、"ターミナル"、"IDE" | ほぼ黒背景(#0f1115)、明るいインク、控えめなグレーの境界線 |
| "ウォーム"、"アナログ" | やや黄色みがかったクリーム(#faf5e8)、茶色がかった黒インク |
| "ブルータリスト" | 純白または純黒、2px以上の実線の境界線 |
| "テクニカル"、"データ" | 等幅フォント(IBM Plex Mono、JetBrains Mono)、クールグレー |
| "マガジン"、"エディトリアル" | セリフ体(EB Garamond、Fraunces)、広めの行間 |
| "遊び心" | 彩度の高いアクセント色1つ、他は落ち着いた色 |
4c. 提案して適用
13個のトークンとフォントスタックをまとめます。コードブロックで提案パレットを表示し、ファイル編集前に承認を得てください。
:root {
--bg: <16進数>; /* ページ背景 */
--bg-soft: <16進数>; /* サブパネル — 通常 --bg と --ink を約3%混ぜたもの */
--bg-hover: <16進数>; /* タグ/チップのホバー */
--card-bg: <16進数>; /* 不透明なカード塗りつぶし(ライトテーマの場合は白) */
--ink: <16進数>; /* 主要テキスト */
--ink-soft: <16進数>; /* --ink の約80% */
--ink-mute: <16進数>; /* 約60% */
--ink-faint: <16進数>; /* 約40% */
--border: <16進数>; /* 控えめな区切り線 */
--border-strong: <16進数>; /* 主要な区切り線 */
--up: <16進数>; /* ポジティブな指標(デフォルトは緑系) */
--down: <16進数>; /* ネガティブな指標(デフォルトは赤系) */
--accent-ink: <16進数>; /* リンク */
--font-mono: "<ファミリー>", ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
}
その後:
css/styles.cssを開き、:rootブロックを見つけて値を置き換えます。index.htmlを開き、<head>内の Google Fonts<link>を新しいフォントファミリーとウェイトに更新します。
5. 履歴書と入力からコンテンツを生成する
ステップ1の履歴書とその他の入力を使用して index.html を生成します。
-
<head>—<title>=<表示名> — <履歴書から最初の役職>;<meta name="description">はキャッチコピーから。 -
ヒーロー:
<h1 class="hero-title">← 表示名<p class="hero-location">← 所在地フレーズ<p class="hero-tagline">← キャッチコピー
-
タイムライン — 履歴書を解析して停止点にします。役職ごと、学位ごと、そしてユーザーが表示したい進行中の個人サイドプロジェクトカテゴリごとに1つの
<li class="tl-stop">を配置します。新しいもの → 古いもの(DOMの上から下)の順に並べます。 各停止点に短いdata-experienceスラッグを設定します(例:mars、vibe、coach、gatech)— フィルターが停止点とカードを関連付けるために使用します。関連するプロジェクトカードが1枚以上ある停止点にのみtabindex="0"を追加します(その他は非アクティブのまま)。<li class="tl-stop tl-stop-work" data-experience="<スラッグ>" tabindex="0"> <!-- tl-stop-work | tl-stop-edu | tl-stop-vibe (いずれかを選択) --> <svg class="tl-icon tl-icon-work" aria-hidden="true"> <use href="#icon-wrench"/> <!-- #icon-wrench | #icon-book | #icon-sparkle --> </svg> <div class="tl-info"> <strong>会社 / 学校</strong> <span>役職 / 学位</span> <em>開始 — 終了</em> <i class="tl-loc">都市、州</i> </div> </li>プロジェクトカードが関連付けられていない学歴や過去の役職の停止点には
tabindex="0"を付けないでください —js/main.jsが読み込み時に自動検出し、非インタラクティブのままにします。 -
プロジェクト — 履歴書の注目すべきプロジェクト/実績から生成された約6つの
<article class="project-card">ブロック。各カードは、それが由来する停止点と一致するdata-experienceスラッグを必ず持つ必要があります。そうしないとフィルターに参加しません。<article class="project-card" data-experience="<スラッグ>"> <header class="project-head"> <span class="project-tag">カテゴリ</span> <h3>プロジェクトタイトル</h3> </header> <p>履歴書の箇条書きから抜粋した1~2文の要約。</p> <dl class="project-metrics"> <div><dt>指標</dt><dd class="up">+値</dd></div> <div><dt>指標</dt><dd>値</dd></div> </dl> <ul class="tag-list small"><li>ツール</li><li>ツール</li></ul> </article>指標の色付けには
<dd class="up">/<dd class="down">を使用します。カードはデフォルトで折りたたまれてレンダリングされます — タグ、タイトル、ツールタグのみが表示され、ホバー/フォーカスで要約と指標が表示されます。要約は簡潔に保ってください。ホバー時のご褒美としてのみ存在します。 -
チャットの挨拶 — ボットの最初のメッセージは
index.htmlの#chat-panel内(パネルの<div class="chat-log">内)のインラインHTMLです。これにより、ユーザーが初めてポップアウトを開いたときに即座にレンダリングされます。選択されたボット名とアバター絵文字を使用して書き換えます。形式:<div class="chat-msg chat-msg-bot"> <span class="chat-avatar" aria-label="<ボット名>">絵文字</span> <div class="chat-bubble"> <p>こんにちは、私は <strong><ボット名></strong> — <表示名> のAIアシスタントです。<表示名> の履歴書から学習しました。</p> <p>以下のことについて質問してください:</p> <ul> <li>会社 / 役職</li> <li>手法 / アプローチ</li> <li>プロジェクト / スキル / 学歴</li> </ul> <p>何か知りたいことはありますか?</p> </div> </div> -
コンタクト — メール + 提供された各ソーシャルURLを
.connect-list内の<li>として追加します。提供されていないプラットフォームの行は削除します。
6. 肖像写真を追加する
写真の場所をユーザーに確認します。リポジトリルートに raw.jpg としてコピーし、リサイズします。
cp <ユーザーの写真パス> raw.jpg
mkdir -p assets
sips -Z 720 raw.jpg --out assets/portrait.jpg
写真の背景が新しい --bg と合わない場合は、バンドルされたスクリプトで色を調整します。
cd /tmp && rm -rf img-fix && mkdir img-fix && cd img-fix
npm init -y > /dev/null
npm install [email protected] --silent
node <このスキルのディレクトリ>/scripts/shift-portrait.js \
/path/to/my-site/raw.jpg \
/path/to/my-site/assets/portrait.jpg \
"#<あなたの背景16進数>"
第3引数を省略した場合のデフォルトは #fbf7eb です。raw.jpg は gitignore されています。
7. チャットボットを設定する(ユーザーが「いいえ」と答えた場合はスキップ)
7a. Worker
cd worker
wrangler login
wrangler secret put DEEPSEEK_API_KEY
worker/wrangler.toml:
ALLOWED_ORIGIN = "https://<ユーザー名>.github.io,http://localhost:8000,http://127.0.0.1:8000"
MODEL = "deepseek-chat"
worker/worker.js → SYSTEM_PROMPT — ユーザーの履歴書から書き換えます。セクション構造(About / Current role / Past roles / Education / Tool box)は維持します。また、ボット名とアバターを使用して冒頭のペルソナ文を書き換えます。
const SYSTEM_PROMPT = `あなたは「<ボット名>」<絵文字> — <表示名> の個人ウェブサイトに埋め込まれた、フレンドリーで簡潔なAIアシスタントです。…`;
デプロイ:
wrangler deploy
7b. クライアント
js/config.js:
window.SITE_CONFIG = {
chatWorkerUrl: "https://<worker>.workers.dev",
};
js/chatbot.js — 上部の定数を更新:
const AVATAR = "<絵文字>";
const AVATAR_LABEL = "<ボット名>";
8. プレビューしてプッシュ
python3 -m http.server 8000 # http://localhost:8000
すべてのセクションをクリックして確認します。チャットをテストします。モバイル幅にリサイズします。その後:
git add .
git commit -m "initial: 個人サイト"
git push -u origin main
約60秒以内に https://<ユーザー名>.github.io/ で公開されます。
テンプレートアーキテクチャ(変更しないでください)
セクションレイアウト
すべてのセクションは .section-grid: 280px 1fr を使用します。280px の列は最も長いタイムラインラベルに適合します。すべてのラベルが短い場合は 240px に狭め、長い場合は 320px に広げます。
タイムライン
- Projects の
section-head内にあり、タイトルのすぐ下、opacity: 0.45で配置されます。ホバー、フォーカス、またはアクティブなフィルターにより 0.95 に引き上げられます。 - DOM の順序 = 画面上の上から下の順序。 新しいもの → 古いもの。時間に比例せず、flex
gapで均等に分布します。 - デフォルトで3種類のアイコンがあります:
#icon-wrench(仕事、.tl-stop-work)、#icon-book(教育、.tl-stop-edu)、#icon-sparkle(雰囲気/サイドプロジェクト、.tl-stop-vibe)。3つすべての<symbol>定義は<header>の直後のSVGスプライトにあります。新しいアイコンカテゴリを追加するには:- SVGパスで
<symbol id="icon-foo">を追加 .tl-icon-foo { color: var(--ink-mute); }を追加<svg class="tl-icon tl-icon-foo"><use href="#icon-foo"/></svg>で参照
- SVGパスで
- すべての停止点は
data-experience="<スラッグ>"を持ちます。スラッグが少なくとも1つのプロジェクトカードと一致する停止点にはtabindex="0"も追加され、js/main.jsがフィルターインタラクションを有効にします。
プロジェクトフィルター(クリック + ホバー)
js/main.js によって完全に駆動され、設定は不要です。DOMを読み込み時にスキャンし、該当する場合にのみハンドラーを配線します。
- 読み込み時に、
data-experienceスラッグが少なくとも1つの.project-cardに存在するすべての停止点に.tl-stop-has-projects+role="button"+aria-pressed="false"が追加されます。関連カードのない停止点は非アクティブのままです。 - ホバー/フォーカス インタラクティブな停止点 → 一時フィルター: 一致しないカードは
.is-dimになります(グリッドに.is-filteringが追加され、CSS が暗くしたカードにdisplay: noneを適用 — レイアウトから削除され、単にフェードするわけではありません)。 - クリック(または
Enter/Space)→ ロック: 停止点に.is-lockedが追加され、完全な不透明度、インク色のアイコン、下線付きの会社名になります。同じ停止点をもう一度クリックすると解除され、別の停止点をクリックすると切り替わります。 - ロック中、別の停止点にホバーするとそのカードがプレビューされ、レールからの
mouseleave(またはレールからのfocusout)でプレビューが解除され、ロックされたフィルターに戻ります。
チャットパネル
#chat-panelは固定位置にあり、.chat-launcherがdisplay: noneを切り替えます。.chat-logはflex-direction: column-reverseで、新しいメッセージを一番下に揃え、古いメッセージを上にスクロールさせます。- ユーザーメッセージは
.chat-msg-user、ボットメッセージは.chat-msg-botです。 chatbot.jsはレート制限を適用します: 1分間に12メッセージ、連続して3メッセージまで。違反はトースト通知で示されます。
可変 CSS プロパティ
ページ全体に適用される13のトークン。新しいデザインの場合は、ステップ4のパレット作成+承認ワークフローを通じて進めてください。:root の値を直接編集しないでください。ユーザーがプロジェクトの「スタイル」感覚をあまり持っていない場合は、Playfair + Source Sans 3 の温かみのあるエディトリアルルックで妥協し、その後調整します。