Configuração do site pessoal
Orientar um novo usuário a publicar seu próprio portfólio em https://<seu-usuario>.github.io. A arquitetura é fixa; a aparência, o conteúdo e a persona do chatbot são personalizados para cada usuário.
O que eles obtêm
- Site estático de página única, sem bundler. O GitHub Pages serve
mainna raiz do repositório. - Hero — retrato + nome + localização em uma linha + slogan em uma linha.
- Seção de projetos com uma linha do tempo vertical esmaecida no cabeçalho da seção (ícones de chave inglesa para trabalho, livro para educação, brilho para projetos paralelos / vibe; cada ponto mostra empresa, cargo, data e localização) e uma grade de cards de projetos no corpo — ambos gerados a partir do currículo do usuário.
- Filtro linha do tempo ↔ cards — ao passar o mouse ou focar com teclado em um ponto da linha do tempo, os cards de projeto não relacionados são ocultados; clique para fixar o filtro (clique novamente para limpar). Apenas pontos que têm pelo menos 1 card associado se tornam interativos; os outros permanecem inertes.
- Cards dobrados — cada card de projeto mostra apenas sua categoria + título + tags de ferramentas por padrão; o parágrafo de resumo e a linha de métricas aparecem ao passar o mouse / focar, mantendo a grade escaneável.
- Chatbot (opcional) — um botão flutuante no canto inferior direito + painel pop-out (não é uma seção inline da página) alimentado pela API compatível com OpenAI da DeepSeek atrás de um Cloudflare Worker que guarda a chave da API. O usuário escolhe o nome do bot; o agente propõe um avatar emoji correspondente. As respostas do bot renderizam markdown. Limite de taxa em duas camadas.
- Seção Conectar — email + URLs sociais do usuário.
Pré-requisitos
| Necessário para | Ferramenta | Instalação |
|---|---|---|
| Tudo | git | geralmente já instalado |
| Tudo | Conta GitHub + CLI gh | brew install gh e gh auth login |
| Tudo | python3 (visualização local) | geralmente já instalado |
| Chatbot | Conta Cloudflare (nível gratuito) | https://dash.cloudflare.com |
| Chatbot | CLI wrangler | npm install -g wrangler e wrangler login |
| Chatbot | Chave da API DeepSeek | https://platform.deepseek.com/ → API keys |
| Ajuste de retrato | Node.js | brew install node |
Passo a passo
1. Coletar entradas do usuário
Faça isso antes de tocar em qualquer arquivo. Reúna tudo de uma vez para que as etapas posteriores sejam edições automatizadas. Use AskUserQuestion para múltipla escolha e prompts diretos para texto livre.
Obtenha cada um destes do usuário:
| Entrada | Como perguntar | Exemplo |
|---|---|---|
| Nome de usuário no GitHub | direto | jane (o repositório será jane.github.io) |
| Nome de exibição | direto | Jane Doe ou Jane "JD" Doe |
| Frase de localização | direto, curto | Região metropolitana de NY, Remoto, Tóquio |
| Slogan | direto, uma frase | Construo sistemas de ML e amo entregar. |
| Currículo | colar texto ou caminho para arquivo | currículo completo — usado para preencher a linha do tempo, cards de projetos, conhecimento do chatbot |
| Foto | caminho para uma imagem quadrada no disco | /Users/jane/Desktop/headshot.jpg. O usuário pode colocá-la na raiz do repositório como raw.jpg após clonar. |
| URLs sociais | direto, cada um opcional | Perfil LinkedIn / GitHub / Medium / email pessoal |
| Chatbot? | AskUserQuestion | sim / não |
| Nome do chatbot (se sim) | direto | Pot, Nova, Echo, etc. |
| Estilo visual | AskUserQuestion | "Cole uma URL de que gosto" OU "Descreva em palavras" |
Após coletar o nome do chatbot, proponha 2–3 avatares emoji que combinem tematicamente e deixe o usuário escolher. Exemplos:
| Nome | Avatares propostos |
|---|---|
| Pot | 🫖 (bule) · 🍲 · 🎨 |
| Nova | 🌟 · 💫 · 🌠 |
| Echo | 📣 · 🔊 · 🌀 |
| Ember | 🔥 · 🪵 · ✨ |
| Atlas | 🗺️ · 🧭 · 🌍 |
| Bit | 💾 · 🔢 · 🤖 |
| Sage | 🌿 · 📖 · 🦉 |
Se nada óbvio se encaixar, ofereça neutros: 🤖, 💬, 🪄. Armazene o emoji + nome escolhidos — você os escreverá no código mais tarde.
2. Criar o repositório no GitHub
gh repo create <usuario>.github.io --public --description "Site pessoal"
Sites de usuário do GitHub Pages DEVEM estar em <usuario>.github.io.
3. Clonar o template
git clone https://github.com/donotdonuts/donotdonuts.github.io meu-site
cd meu-site
rm -rf .git
git init -b main
git remote add origin https://github.com/<usuario>/<usuario>.github.io.git
4. Escolher um estilo visual
O template padrão tem uma estética creme + IBM Plex Mono. Sobrescreva com base na resposta do usuário da Etapa 1.
4a. Se o usuário forneceu uma URL
Extraia o CSS da página e extraia tokens:
curl -sL "<url>" -o /tmp/ref.html
grep -oE 'href="[^"]+\.css[^"]*"' /tmp/ref.html | sort -u
curl -sL "<origin>/<caminho-css>" -o /tmp/ref-1.css
# fonte realmente aplicada ao body
grep -oE 'body[^{]{0,30}\{[^}]+\}' /tmp/ref-1.css | head -5
# todas as definições de propriedades personalizadas CSS
grep -oE -- '--[a-zA-Z-]+:[^;}]+' /tmp/ref-1.css | sort -u | head -60
Procure por: hex do fundo, hex do texto principal, hex da borda, hex de destaque, font-family aplicada ao body, URLs @font-face.
4b. Se o usuário forneceu uma descrição
Traduza a descrição em tokens concretos. Heurísticas:
| Palavras | Implicação |
|---|---|
| "minimalista", "editorial", "papel" | Fundo creme / off-white, tinta escura, divisores finos |
| "escuro", "terminal", "IDE" | Fundo quase preto (#0f1115), tinta clara, bordas cinza sutis |
| "quente", "analógico" | Creme levemente amarelado (#faf5e8), tinta marrom-escura |
| "brutalista" | Branco puro ou preto puro, bordas sólidas de 2px+ |
| "tech", "dados" | Monoespaçada (IBM Plex Mono, JetBrains Mono), cinzas frios |
| "revista", "editorial" | Serifada (EB Garamond, Fraunces), entrelinhas generosas |
| "divertido" | Um destaque saturado, o resto neutro |
4c. Propor + aplicar
Compile 13 tokens + uma pilha de fontes. Mostre a paleta proposta como um bloco de código e obtenha aprovação antes de editar arquivos.
:root {
--bg: <hex>; /* fundo da página */
--bg-soft: <hex>; /* sub-painéis — geralmente --bg misturado ~3% com --ink */
--bg-hover: <hex>; /* hover de tag/chip */
--card-bg: <hex>; /* preenchimento opaco do card (branco se tema claro) */
--ink: <hex>; /* texto primário */
--ink-soft: <hex>; /* ~80% de --ink */
--ink-mute: <hex>; /* ~60% */
--ink-faint: <hex>; /* ~40% */
--border: <hex>; /* divisores sutis */
--border-strong: <hex>; /* divisores estruturais */
--up: <hex>; /* métricas positivas (esverdeado por padrão) */
--down: <hex>; /* métricas negativas (avermelhado por padrão) */
--accent-ink: <hex>; /* links */
--font-mono: "<Família>", ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
}
Em seguida:
- Abra
css/styles.css, encontre o bloco:root, substitua os valores. - Abra
index.html, atualize o<link>do Google Fonts no<head>com a nova família de fontes + pesos.
5. Gerar conteúdo a partir do currículo + entradas
Use o currículo + outras entradas da Etapa 1 para preencher index.html:
-
<head>—<title>=<Nome de Exibição> — <primeiro-cargo-do-currículo>;<meta name="description">a partir do slogan. -
Hero:
<h1 class="hero-title">← nome de exibição<p class="hero-location">← frase de localização<p class="hero-tagline">← slogan
-
Linha do tempo — analise o currículo em pontos. Um
<li class="tl-stop">por cargo, por diploma, E por categoria de projeto paralelo contínuo que o usuário queira destacar. Ordem presente → mais antigo (de cima para baixo no DOM). Escolha um slug curtodata-experiencepara cada um (ex.:marte,vibe,coach,gatech) — é o que o filtro usa para associar pontos a cards. Adicionetabindex="0"apenas em pontos que tenham ≥1 card de projeto associado (outros permanecem inertes).<li class="tl-stop tl-stop-work" data-experience="<slug>" tabindex="0"> <!-- tl-stop-work | tl-stop-edu | tl-stop-vibe (escolha um) --> <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>Empresa / Escola</strong> <span>Cargo / Diploma</span> <em>Início — Fim</em> <i class="tl-loc">Cidade, Estado</i> </div> </li>Remova
tabindex="0"de pontos de educação / cargos antigos que não tenham cards de projeto associados —js/main.jsdetecta isso automaticamente no carregamento e os deixa não interativos. -
Projetos — ~seis blocos
<article class="project-card">, gerados a partir de projetos/realizações notáveis no currículo. Cada card DEVE carregar um slugdata-experiencecorrespondente ao ponto de origem, ou não participará do filtro:<article class="project-card" data-experience="<slug>"> <header class="project-head"> <span class="project-tag">Categoria</span> <h3>Título do Projeto</h3> </header> <p>Resumo de 1–2 frases extraído do tópico do currículo.</p> <dl class="project-metrics"> <div><dt>Métrica</dt><dd class="up">+valor</dd></div> <div><dt>Métrica</dt><dd>valor</dd></div> </dl> <ul class="tag-list small"><li>Ferramenta</li><li>Ferramenta</li></ul> </article>Use
<dd class="up">/<dd class="down">para colorir métricas. Os cards são renderizados dobrados por padrão — apenas a tag, título e tags de ferramentas são visíveis até que o hover / foco dentro revele o resumo + métricas. Mantenha os resumos concisos; eles só existem para recompensar um hover. -
Saudação do chat — a mensagem de abertura do bot é HTML inline dentro de
#chat-panelemindex.html(dentro do<div class="chat-log">do painel), para que seja renderizada instantaneamente quando o usuário abrir o pop-out pela primeira vez. Reescreva usando o nome do bot escolhido + avatar emoji. Formato:<div class="chat-msg chat-msg-bot"> <span class="chat-avatar" aria-label="<Nome do Bot>">EMOJI</span> <div class="chat-bubble"> <p>Olá, sou <strong><Nome do Bot></strong> — assistente de IA de <Nome de Exibição>, <verbado> a partir <do/dele/dela> currículo.</p> <p>Pergunte sobre:</p> <ul> <li>Empresas / cargos</li> <li>Métodos / abordagens</li> <li>Projetos / habilidades / educação</li> </ul> <p>O que gostaria de saber?</p> </div> </div> -
Conectar — email + cada URL social fornecida como um
<li>em.connect-list. Exclua linhas para qualquer plataforma não fornecida.
6. Adicionar o retrato
Pergunte onde está a foto. Copie para a raiz do repositório como raw.jpg, então redimensione:
cp <caminho-foto-usuario> raw.jpg
mkdir -p assets
sips -Z 720 raw.jpg --out assets/portrait.jpg
Se o fundo da foto não combinar com o novo --bg, mude com o script incluído:
cd /tmp && rm -rf img-fix && mkdir img-fix && cd img-fix
npm init -y > /dev/null
npm install [email protected] --silent
node <caminho-desta-skill>/scripts/shift-portrait.js \
/caminho/para/meu-site/raw.jpg \
/caminho/para/meu-site/assets/portrait.jpg \
"#<seu-hex-bg>"
Padrão é #fbf7eb se o terceiro argumento for omitido. raw.jpg está no .gitignore.
7. Configurar o chatbot (pule se o usuário disse não)
7a. Worker
cd worker
wrangler login
wrangler secret put DEEPSEEK_API_KEY
worker/wrangler.toml:
ALLOWED_ORIGIN = "https://<usuario>.github.io,http://localhost:8000,http://127.0.0.1:8000"
MODEL = "deepseek-chat"
worker/worker.js → SYSTEM_PROMPT — reescreva a partir do currículo do usuário. Mantenha a estrutura de seções (Sobre / Cargo atual / Cargos anteriores / Educação / Caixa de ferramentas). Também reescreva a frase de persona de abertura usando o nome + avatar do bot:
const SYSTEM_PROMPT = `Você é "<Nome do Bot>" <EMOJI> — um assistente de IA amigável e conciso incorporado no site pessoal de <Nome de Exibição>. ...`;
Implante:
wrangler deploy
7b. Cliente
js/config.js:
window.SITE_CONFIG = {
chatWorkerUrl: "https://<worker>.workers.dev",
};
js/chatbot.js — atualize as constantes no topo:
const AVATAR = "<EMOJI>";
const AVATAR_LABEL = "<Nome do Bot>";
8. Visualizar + enviar
python3 -m http.server 8000 # http://localhost:8000
Navegue por todas as seções. Teste o chat. Redimensione para largura de celular. Então:
git add .
git commit -m "inicial: site pessoal"
git push -u origin main
Publicado em https://<usuario>.github.io/ em aproximadamente 60 segundos.
Arquitetura do template (não altere)
Layout de seções
Cada seção usa .section-grid: 280px 1fr. A coluna de 280px cabe o rótulo mais longo da linha do tempo. Aperte para 240px se todos os rótulos forem curtos, alargue para 320px se longos.
Linha do tempo
- Vive dentro do
section-headda seção Projetos, logo abaixo do título, emopacity: 0.45. Hover, foco ou um filtro ativo eleva para 0.95. - Ordem no DOM = ordem visual de cima para baixo. Presente → mais antigo. NÃO proporcional ao tempo — distribuído uniformemente via flex
gap. - Três tipos de ícone prontos:
#icon-wrench(trabalho,.tl-stop-work),#icon-book(educação,.tl-stop-edu),#icon-sparkle(vibe / projeto paralelo,.tl-stop-vibe). Todas as três definições<symbol>estão no sprite SVG logo após<header>. Para adicionar uma nova categoria de ícone:- Adicione um
<symbol id="icon-foo">com seu caminho SVG - Adicione
.tl-icon-foo { color: var(--ink-mute); } - Referencie com
<svg class="tl-icon tl-icon-foo"><use href="#icon-foo"/></svg>
- Adicione um
- Cada ponto carrega
data-experience="<slug>"; pontos cujo slug corresponda a pelo menos um card de projeto também recebemtabindex="0"para quejs/main.jspossa torná-los interativos para filtro.
Filtro de projetos (clique + hover)
Conduzido inteiramente por js/main.js, zero configuração — ele escaneia o DOM no carregamento e conecta handlers apenas onde se aplicam.
- No carregamento, cada ponto cujo slug
data-experienceesteja presente em pelo menos um.project-cardrecebe.tl-stop-has-projects+role="button"+aria-pressed="false". Pontos sem cards associados permanecem inertes. - Hover / foco em um ponto interativo → filtro temporário: cards não correspondentes recebem
.is-dim(a grade adiciona.is-filtering, que o CSS traduz emdisplay: nonenos cards escurecidos — eles são removidos do layout, não apenas esmaecidos). - Clique (ou
Enter/Space) → trava: o ponto recebe.is-locked, opacidade total, ícone colorido com a tinta, nome da empresa sublinhado. Clique no mesmo ponto novamente para limpar; clique em outro para trocar. - Enquanto travado, passar o mouse em um ponto diferente pré-visualiza seus cards;
mouseleavena barra (oufocusoutdela) restaura o filtro travado.
Cards de projeto
- Cada
.project-cardleva umdata-experienceque vincula a um ponto da linha do tempo. Agora também levadata-toolscom uma lista separada por vírgulas de ferramentas (ex.:data-tools="Python,PyTorch,Spark") para opções futuras de filtro por ferramenta. Ojs/main.jsainda não usa isso, mas o dado está no DOM. - Largura fixa de
220px(maisgap: 24px), altura dinâmica por conteúdo. Quebram para 1 coluna em mobile. - Tags de ferramentas em
.tag-list.smallsão agrupadas juntas por padrão; um hover/foco dentro do card revela o resumo e as métricas.
Chatbot
- Painel pop-out fixo no canto inferior direito com um botão de alternância. O painel é
<div id="chat-panel">, inicialmente oculto (display: none), alternado viajs/chatbot.js. chatWorkerUrlemjs/config.jsaponta para o Worker Cloudflare implantado. O Worker retorna marcação de streaming (SSE-like).- A primeira mensagem visível no
<div class="chat-log">é a saudação inline; após o usuário enviar uma mensagem, as respostas são anexadas via JavaScript. Cada mensagem consiste em umspan.chat-avatar+div.chat-bubble. - O bot não precisa de entrada além das mensagens; o usuário também pode clicar em perguntas sugeridas.
- O tema de cores do painel de chat corresponde a
--bg/--ink/--accent-inkda página — não há CSS separado para o chatbot.
Constantes e configuração
| Arquivo | O que ajustar |
|---|---|
css/styles.css, bloco :root | 13 tokens CSS + pilha de fontes |
index.html <title> + <meta> | Título da página e descrição |
index.html Hero | Nome, localização, slogan |
index.html <ul class="connect-list"> | Email + URLs sociais |
index.html <div class="chat-log"> | Saudação inline do bot (emoji + nome) |
index.html <div class="project-card"> | Conteúdo do projeto (3–6 cards) |
index.html <li class="tl-stop"> | Pontos da linha do tempo (todos os cargos/diplomas) |
js/chatbot.js | AVATAR + AVATAR_LABEL |
js/config.js | SITE_CONFIG.chatWorkerUrl |
worker/worker.js | SYSTEM_PROMPT |
worker/wrangler.toml | ALLOWED_ORIGIN (adicionar o domínio do usuário) |