개인 사이트 설정
새 사용자가 https://<사용자이름>.github.io에 자신의 포트폴리오를 배포하는 과정을 안내합니다. 아키텍처는 고정되어 있지만, 외관, 텍스트, 챗봇 페르소나는 모두 특정 사용자에 맞게 커스터마이징됩니다.
제공되는 기능
- 단일 페이지 정적 사이트, 번들러 없음. GitHub Pages가
main브랜치를 리포지토리 루트에서 제공합니다. - 히어로 섹션 — 초상화 + 이름 + 한 줄 위치 + 한 줄 태그라인.
- 프로젝트 섹션 — 섹션 헤드에 흐릿한 세로 타임라인(작업 항목에는 렌치 아이콘, 교육 항목에는 책 아이콘, 사이드 프로젝트에는 반짝이 아이콘; 각 항목은 회사, 직위, 날짜, 위치를 표시)과 본문에 프로젝트 카드 그리드가 있습니다. 둘 다 사용자 이력서에서 생성됩니다.
- 타임라인 ↔ 카드 필터 — 타임라인 항목에 마우스를 올리거나 키보드 포커스를 주면 관련 없는 프로젝트 카드가 숨겨집니다. 클릭하면 필터가 고정되고(다시 클릭하면 해제)됩니다. 최소 하나의 카드와 연결된 항목만 상호작용 가능하며, 나머지는 비활성 상태로 유지됩니다.
- 접힌 카드 — 각 프로젝트 카드는 기본적으로 카테고리 + 제목 + 도구 태그만 표시합니다. 마우스를 올리거나 포커스하면 요약 단락과 지표 행이 나타나 그리드의 스캔 가능성을 유지합니다.
- 챗봇 (선택 사항) — Cloudflare Worker 뒤에서 DeepSeek의 OpenAI 호환 API를 사용하는 오른쪽 하단 플로팅 런처 + 팝아웃 패널(인라인 페이지 섹션이 아님)입니다. 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 "Personal website"
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-경로>" -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
찾을 항목: 배경 hex, 전경/잉크 hex, 테두리 hex, 강조 색상 hex, body에 적용된 font-family, @font-face URL.
4b. 사용자가 설명을 제공한 경우
설명을 구체적인 토큰으로 변환합니다. 휴리스틱:
| 단어 | 함축 의미 |
|---|---|
| "minimal", "editorial", "paper" | 크림/오프화이트 배경, 진한 잉크, 얇은 구분선 |
| "dark", "terminal", "IDE" | 거의 검은색 배경 (#0f1115), 밝은 잉크, 미묘한 회색 테두리 |
| "warm", "analog" | 약간 노란 크림색 (#faf5e8), 갈색-검은색 잉크 |
| "brutalist" | 순수 흰색 또는 순수 검은색, 2px 이상의 실선 테두리 |
| "techy", "data" | 고정폭(IBM Plex Mono, JetBrains Mono), 차가운 회색 |
| "magazine", "editorial" | 세리프(EB Garamond, Fraunces), 넉넉한 행간 |
| "playful" | 하나의 채도 높은 강조색, 나머지는 차분하게 |
4c. 제안 및 적용
13개의 토큰 + 글꼴 스택을 컴파일합니다. 파일을 편집하기 전에 제안된 팔레트를 코드 블록으로 보여주고 승인을 받으십시오.
:root {
--bg: <hex>; /* 페이지 배경 */
--bg-soft: <hex>; /* 서브 패널 — 일반적으로 --bg를 --ink 쪽으로 ~3% 혼합 */
--bg-hover: <hex>; /* 태그/칩 호버 */
--card-bg: <hex>; /* 불투명 카드 채우기 (라이트 테마의 경우 흰색) */
--ink: <hex>; /* 기본 텍스트 */
--ink-soft: <hex>; /* --ink의 ~80% */
--ink-mute: <hex>; /* ~60% */
--ink-faint: <hex>; /* ~40% */
--border: <hex>; /* 미묘한 구분선 */
--border-strong: <hex>; /* 주요 구분선 */
--up: <hex>; /* 긍정적 지표 (기본적으로 녹색 계열) */
--down: <hex>; /* 부정적 지표 (기본적으로 빨간색 계열) */
--accent-ink: <hex>; /* 링크 */
--font-mono: "<Family>", 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">← 태그라인
-
타임라인 — 이력서를 분석하여 항목으로 만듭니다. 각 직위, 학위, 그리고 사용자가 표시하려는 진행 중인 개인 사이드 프로젝트 카테고리당 하나의
<li class="tl-stop">을 만듭니다. 순서는 현재 → 과거 (DOM에서 위에서 아래로). 각 항목에 짧은data-experience슬러그를 선택합니다(예:mars,vibe,coach,gatech) — 필터가 항목을 카드에 연결하는 데 사용됩니다. 최소 하나의 연결된 프로젝트 카드가 있는 항목에만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내부에 인라인 HTML로 포함됩니다(패널의<div class="chat-log">내부). 따라서 사용자가 팝아웃을 처음 열 때 즉시 렌더링됩니다. 선택한 봇 이름 + 아바타 이모지를 사용하여 다시 작성합니다. 형식:<div class="chat-msg chat-msg-bot"> <span class="chat-avatar" aria-label="<봇 이름>">EMOJI</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 \
"#<your-bg-hex>"
세 번째 인수를 생략하면 기본값은 #fbf7eb입니다. raw.jpg는 gitignored됩니다.
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 — 사용자 이력서에서 다시 작성합니다. 섹션 구조(소개 / 현재 역할 / 이전 역할 / 학력 / 도구 상자)를 유지합니다. 또한 봇 이름 + 아바타를 사용하여 여는 페르소나 문장을 다시 작성합니다:
const SYSTEM_PROMPT = `당신은 "<봇 이름>" <EMOJI>입니다 — <표시 이름>의 개인 웹사이트에 포함된 친절하고 간결한 AI 어시스턴트입니다. …`;
배포:
wrangler deploy
7b. 클라이언트
js/config.js:
window.SITE_CONFIG = {
chatWorkerUrl: "https://<worker>.workers.dev",
};
js/chatbot.js — 상단의 상수를 업데이트합니다:
const AVATAR = "<EMOJI>";
const AVATAR_LABEL = "<봇 이름>";
8. 미리보기 + 푸시
python3 -m http.server 8000 # http://localhost:8000
모든 섹션을 클릭하여 확인합니다. 채팅을 테스트합니다. 모바일 너비로 크기를 조정합니다. 그런 다음:
git add .
git commit -m "initial: personal site"
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을 통해 균등하게 분포됩니다. - 기본적으로 세 가지 아이콘 종류가 있습니다:
#icon-wrench(직장,.tl-stop-work),#icon-book(교육,.tl-stop-edu),#icon-sparkle(분위기/사이드 프로젝트,.tl-stop-vibe). 세<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="<슬러그>"를 전달합니다. 슬러그가 최소 하나의 프로젝트 카드와 일치하는 항목은tabindex="0"도 가져서js/main.js가 필터 상호작용을 가능하게 합니다.
프로젝트 필터 (클릭 + 호버)
전적으로 js/main.js에 의해 구동되며, 구성이 필요 없습니다. DOM을 로드 시 스캔하고 적용되는 곳에만 핸들러를 연결합니다.
- 로드 시,
data-experience슬러그가 최소 하나의.project-card에 있는 모든 항목은.tl-stop-has-projects+role="button"+aria-pressed="false"를 얻습니다. 연결된 카드가 없는 항목은 비활성 상태로 유지됩니다. - 호버 / 포커스 상호작용 가능한 항목 → 임시 필터: 일치하지 않는 카드는
.is-dim이 됩니다(그리드에.is-filtering이 추가되며, CSS는 이를 dim 처리된 카드에display: none으로 변환합니다. 레이아웃에서 제거되고 단순히 희미해지지 않습니다). - 클릭 (또는
Enter/Space) → 잠금: 항목은.is-locked, 완전 불투명도, 잉크 색상 아이콘, 밑줄 친 회사 이름을 얻습니다. 동일한 항목을 다시 클릭하면 해제되고, 다른 항목을 클릭하면 전환됩니다. - 잠겨 있는 동안 다른 항목을 호버하면 해당 카드를 미리보고, 레일에서
mouseleave(또는 레일에서focusout)하면 잠긴 필터로 돌아갑니다.
프로젝트 카드
- 각 카드에는
data-experience속성이 필요합니다. 필터가 작동하려면 이 속성이 있어야 합니다. - 기본적으로 접혀 있습니다: CSS는
.project-card p,.project-card .project-metrics에display: none을 적용하고, 카드 호버/포커스 시 표시합니다. - 지표는 선택 사항이지만 유용합니다. 2~3개의 지표를 목표로 하세요.
- 도구 태그는 항상 표시됩니다.
챗봇 패널
index.html에서#chat-panel은display: none으로 시작합니다.#chat-launcher를 클릭하면is-open클래스가 전환됩니다.- 채팅 기록은
#chat-log<div>입니다. 새 메시지는js/chatbot.js에 의해 추가됩니다. - Worker URL은
js/config.js에 있습니다. 빌드 단계가 없습니다.
반응형
- 최대
48rem: 스택 레이아웃. 프로젝트 카드는 단일 열. 히어로는 세로로 쌓입니다. 48rem이상: 두 열 그리드. 히어로는 텍스트 + 사진 가로 배치.- 타임라인은 모든 뷰포트에서 가로로 유지되지만, 모바일에서는 더 작은 글꼴로 표시됩니다.