Configuración del sitio personal
Guía a un nuevo usuario para lanzar su propio portafolio en https://<su-nombre-de-usuario>.github.io. La arquitectura es fija; la apariencia, el contenido y la personalidad del chatbot se personalizan para cada usuario.
Qué obtiene
- Sitio estático de una sola página, sin empaquetador. GitHub Pages sirve
maindesde la raíz del repositorio. - Hero — su retrato + nombre + ubicación en una línea + eslogan en una línea.
- Sección de proyectos con una línea de tiempo vertical atenuada en el encabezado de la sección (iconos de llave inglesa para trabajo, libro para educación, destellos para proyectos paralelos / vibra; cada punto muestra empresa, rol, fecha, ubicación) y una cuadrícula de tarjetas de proyecto en el cuerpo, ambas generadas a partir del currículum del usuario.
- Filtro de línea de tiempo ↔ tarjetas — al pasar el ratón o enfocar con teclado un punto de la línea de tiempo se ocultan las tarjetas de proyecto no relacionadas; al hacer clic se fija el filtro (otro clic lo limpia). Solo los puntos que tienen al menos una tarjeta asociada se vuelven interactivos; los demás permanecen inertes.
- Tarjetas plegables — cada tarjeta de proyecto muestra solo su categoría + título + etiquetas de herramientas por defecto; el párrafo de resumen y la fila de métricas aparecen al pasar el ratón / enfocar, manteniendo la cuadrícula escaneable.
- Chatbot (opcional) — un lanzador flotante en la esquina inferior derecha + un panel emergente (no una sección en línea de la página) respaldado por la API compatible con OpenAI de DeepSeek detrás de un Cloudflare Worker que contiene la clave API. El usuario elige el nombre del bot; el agente propone un avatar emoji acorde. Las respuestas del bot renderizan markdown. Límite de tasa de dos capas.
- Sección de contacto — correo electrónico + las URLs sociales del usuario.
Requisitos previos
| Necesario para | Herramienta | Instalación |
|---|---|---|
| Todo | git | normalmente ya instalado |
| Todo | Cuenta de GitHub + CLI gh | brew install gh luego gh auth login |
| Todo | python3 (vista previa local) | normalmente ya instalado |
| Chatbot | Cuenta de Cloudflare (nivel gratuito) | https://dash.cloudflare.com |
| Chatbot | CLI wrangler | npm install -g wrangler luego wrangler login |
| Chatbot | Clave API de DeepSeek | https://platform.deepseek.com/ → API keys |
| Cambio de retrato | Node.js | brew install node |
Paso a paso
1. Recopilar entradas del usuario
Haga esto antes de tocar cualquier archivo. Recopile todo de una vez para que los pasos posteriores sean ediciones automatizadas. Combine AskUserQuestion para opciones múltiples y mensajes directos para texto libre.
Obtenga cada uno de estos del usuario:
| Entrada | Cómo preguntar | Ejemplo |
|---|---|---|
| Nombre de usuario de GitHub | directo | jane (el repositorio será jane.github.io) |
| Nombre para mostrar | directo | Jane Doe o Jane "JD" Doe |
| Frase de ubicación | directo, corto | Área metropolitana de NY, Remoto, Tokio |
| Eslogan | directo, una oración | Construyo sistemas de ML y me encanta enviar productos. |
| Currículum | pegar texto o ruta a un archivo | currículum completo: se usa para poblar la línea de tiempo, las tarjetas de proyecto y el conocimiento del chatbot |
| Foto | ruta a una imagen cuadrada en disco | /Users/jane/Desktop/headshot.jpg. El usuario puede colocarla en la raíz del repositorio como raw.jpg después de clonar. |
| URLs sociales | directo, cada una opcional | Perfil de LinkedIn / GitHub / Medium / correo personal |
| ¿Chatbot? | AskUserQuestion | sí / no |
| Nombre del chatbot (si sí) | directo | Pot, Nova, Echo, etc. |
| Estilo visual | AskUserQuestion | "Pegue una URL que me guste" O "Descríbalo con palabras" |
Después de recopilar el nombre del chatbot, proponga 2 o 3 avatares emoji que combinen temáticamente y deje que el usuario elija. Ejemplos:
| Nombre | Avatares propuestos |
|---|---|
| Pot | 🫖 (tetera) · 🍲 · 🎨 |
| Nova | 🌟 · 💫 · 🌠 |
| Echo | 📣 · 🔊 · 🌀 |
| Ember | 🔥 · 🪵 · ✨ |
| Atlas | 🗺️ · 🧭 · 🌍 |
| Bit | 💾 · 🔢 · 🤖 |
| Sage | 🌿 · 📖 · 🦉 |
Si nada obvio encaja, ofrezca neutros: 🤖, 💬, 🪄. Guarde el emoji elegido + el nombre; los escribirá en el código más tarde.
2. Crear el repositorio de GitHub
gh repo create <nombre-de-usuario>.github.io --public --description "Sitio web personal"
Los sitios de usuario de GitHub Pages DEBEN estar en <nombre-de-usuario>.github.io.
3. Clonar la plantilla
git clone https://github.com/donotdonuts/donotdonuts.github.io mi-sitio
cd mi-sitio
rm -rf .git
git init -b main
git remote add origin https://github.com/<nombre-de-usuario>/<nombre-de-usuario>.github.io.git
4. Elegir un estilo visual
La plantilla usa por defecto una estética crema + IBM Plex Mono. Sobrescríbala según la respuesta del usuario del Paso 1.
4a. Si el usuario proporcionó una URL
Extraiga el CSS de la página y extraiga los tokens:
curl -sL "<url>" -o /tmp/ref.html
grep -oE 'href="[^"]+\.css[^"]*"' /tmp/ref.html | sort -u
curl -sL "<origen>/<ruta-css>" -o /tmp/ref-1.css
# fuente realmente aplicada al body
grep -oE 'body[^{]{0,30}\{[^}]+\}' /tmp/ref-1.css | head -5
# todas las definiciones de propiedades personalizadas CSS
grep -oE -- '--[a-zA-Z-]+:[^;}]+' /tmp/ref-1.css | sort -u | head -60
Busque: hex de fondo, hex de primer plano/tinta, hex de borde, hex de acento, font-family aplicada al body, URLs de @font-face.
4b. Si el usuario proporcionó una descripción
Traduzca la descripción a tokens concretos. Heurísticas:
| Palabras | Implicación |
|---|---|
| "mínimo", "editorial", "papel" | Fondo crema / blanco roto, tinta oscura, divisores finos |
| "oscuro", "terminal", "IDE" | Fondo casi negro (#0f1115), tinta clara, bordes grises sutiles |
| "cálido", "analógico" | Crema ligeramente amarillento (#faf5e8), tinta marrón-negro |
| "brutalista" | Blanco puro o negro puro, bordes sólidos de 2px+ |
| "tecnológico", "datos" | Monoespaciada (IBM Plex Mono, JetBrains Mono), grises fríos |
| "revista", "editorial" | Serif (EB Garamond, Fraunces), interlineado generoso |
| "divertido" | Un acento saturado, por lo demás apagado |
4c. Proponer + aplicar
Compile 13 tokens + una pila de fuentes. Muestre la paleta propuesta como un bloque de código y obtenga aprobación antes de editar archivos.
:root {
--bg: <hex>; /* fondo de página */
--bg-soft: <hex>; /* subpaneles — normalmente --bg mezclado ~3% hacia --ink */
--bg-hover: <hex>; /* hover de etiqueta/chip */
--card-bg: <hex>; /* relleno de tarjeta opaco (blanco si tema claro) */
--ink: <hex>; /* texto principal */
--ink-soft: <hex>; /* ~80% de --ink */
--ink-mute: <hex>; /* ~60% */
--ink-faint: <hex>; /* ~40% */
--border: <hex>; /* divisores sutiles */
--border-strong: <hex>; /* divisores importantes */
--up: <hex>; /* métricas positivas (verdoso por defecto) */
--down: <hex>; /* métricas negativas (rojizo por defecto) */
--accent-ink: <hex>; /* enlaces */
--font-mono: "<Familia>", ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
}
Luego:
- Abra
css/styles.css, encuentre el bloque:root, reemplace los valores. - Abra
index.html, actualice el enlace<link>de Google Fonts en<head>con la nueva familia de fuentes + pesos.
5. Generar contenido a partir del currículum y las entradas
Use el currículum y otras entradas del Paso 1 para poblar index.html:
-
<head>—<title>=<Nombre para mostrar> — <primer-rol-del-currículum>;<meta name="description">a partir del eslogan. -
Hero:
<h1 class="hero-title">← nombre para mostrar<p class="hero-location">← frase de ubicación<p class="hero-tagline">← eslogan
-
Línea de tiempo — analice el currículum en puntos. Un
<li class="tl-stop">por rol, por título, Y por cada categoría de proyecto paralelo personal en curso que el usuario quiera mostrar. Orden presente → más antiguo (de arriba a abajo en el DOM). Elija un slug cortodata-experiencepara cada uno (por ejemplo,mars,vibe,coach,gatech) — es lo que el filtro usa para vincular puntos con tarjetas. Agreguetabindex="0"solo en puntos que tengan ≥1 tarjeta de proyecto vinculada (los demás permanecen inertes).<li class="tl-stop tl-stop-trabajo" data-experience="<slug>" tabindex="0"> <!-- tl-stop-trabajo | tl-stop-edu | tl-stop-vibe (elegir uno) --> <svg class="tl-icon tl-icon-trabajo" aria-hidden="true"> <use href="#icon-wrench"/> <!-- #icon-wrench | #icon-book | #icon-sparkle --> </svg> <div class="tl-info"> <strong>Empresa / Universidad</strong> <span>Rol / Título</span> <em>Inicio — Fin</em> <i class="tl-loc">Ciudad, Estado</i> </div> </li>Elimine
tabindex="0"en puntos de educación / roles antiguos que no tengan tarjetas de proyecto vinculadas —js/main.jslos detecta automáticamente al cargar y los deja no interactivos. -
Proyectos — ~seis bloques
<article class="project-card">, generados a partir de proyectos/logros notables en el currículum. Cada tarjeta DEBE llevar un slugdata-experienceque coincida con el punto del que proviene, o no participará en el filtro:<article class="project-card" data-experience="<slug>"> <header class="project-head"> <span class="project-tag">Categoría</span> <h3>Título del proyecto</h3> </header> <p>Resumen de 1 a 2 oraciones extraído de la viñeta del currículum.</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>Herramienta</li><li>Herramienta</li></ul> </article>Use
<dd class="up">/<dd class="down">para colorear las métricas. Las tarjetas se renderizan plegadas por defecto — solo la etiqueta, el título y las etiquetas de herramientas son visibles hasta que el hover / focus-within revela el resumen + las métricas. Mantenga los resúmenes concisos; solo existen para recompensar un hover. -
Saludo del chat — el mensaje de apertura del bot es HTML en línea dentro de
#chat-panelenindex.html(dentro del<div class="chat-log">del panel), por lo que se renderiza instantáneamente cuando el usuario abre el panel emergente por primera vez. Reescríbalo usando el nombre del bot elegido + el emoji avatar. Formato:<div class="chat-msg chat-msg-bot"> <span class="chat-avatar" aria-label="<Nombre del bot>">EMOJI</span> <div class="chat-bubble"> <p>Hola, soy <strong><Nombre del bot></strong> — el asistente de IA de <Nombre para mostrar>, <verbo> a partir de <su/su(s)> currículum.</p> <p>Pregúntame sobre:</p> <ul> <li>Empresas / roles</li> <li>Métodos / enfoques</li> <li>Proyectos / habilidades / educación</li> </ul> <p>¿Qué te gustaría saber?</p> </div> </div> -
Conectar — correo electrónico + cada URL social proporcionada como un
<li>en.connect-list. Elimine las filas de cualquier plataforma no proporcionada.
6. Agregar el retrato
Pregunte dónde está su foto. Cópiela a la raíz del repositorio como raw.jpg, luego cambie el tamaño:
cp <ruta-foto-usuario> raw.jpg
mkdir -p assets
sips -Z 720 raw.jpg --out assets/portrait.jpg
Si el fondo de la foto no coincide con el nuevo --bg, cámbielo con el script incluido:
cd /tmp && rm -rf img-fix && mkdir img-fix && cd img-fix
npm init -y > /dev/null
npm install [email protected] --silent
node <ruta-de-este-skill>/scripts/shift-portrait.js \
/ruta/a/mi-sitio/raw.jpg \
/ruta/a/mi-sitio/assets/portrait.jpg \
"#<su-hex-de-fondo>"
Por defecto usa #fbf7eb si se omite el tercer argumento. raw.jpg está en .gitignore.
7. Configurar el chatbot (omitir si el usuario dijo que no)
7a. Worker
cd worker
wrangler login
wrangler secret put DEEPSEEK_API_KEY
worker/wrangler.toml:
ALLOWED_ORIGIN = "https://<nombre-de-usuario>.github.io,http://localhost:8000,http://127.0.0.1:8000"
MODEL = "deepseek-chat"
worker/worker.js → SYSTEM_PROMPT — reescríbalo a partir del currículum del usuario. Mantenga la estructura de secciones (Acerca de / Rol actual / Roles anteriores / Educación / Caja de herramientas). También reescriba la oración de presentación del bot usando el nombre + avatar:
const SYSTEM_PROMPT = `Eres "<Nombre del bot>" <EMOJI> — un asistente de IA amigable y conciso integrado en el sitio web personal de <Nombre para mostrar>. …`;
Despliegue:
wrangler deploy
7b. Cliente
js/config.js:
window.SITE_CONFIG = {
chatWorkerUrl: "https://<worker>.workers.dev",
};
js/chatbot.js — actualice las constantes al inicio:
const AVATAR = "<EMOJI>";
const AVATAR_LABEL = "<Nombre del bot>";
8. Vista previa + subir
python3 -m http.server 8000 # http://localhost:8000
Revise cada sección. Pruebe el chat. Cambie el tamaño a ancho móvil. Luego:
git add .
git commit -m "inicial: sitio personal"
git push -u origin main
En vivo en https://<nombre-de-usuario>.github.io/ en aproximadamente 60 segundos.
Arquitectura de la plantilla (no cambiar)
Diseño de secciones
Cada sección usa .section-grid: 280px 1fr. La columna de 280px se ajusta a la etiqueta de línea de tiempo más larga. Ajústela a 240px si todas las etiquetas son cortas, amplíe a 320px si son largas.
Línea de tiempo
- Vive dentro del
section-headde Proyectos, justo debajo del título, conopacity: 0.45. Al pasar el ratón, enfocar o con un filtro activo, se eleva a 0.95. - Orden del DOM = orden visual de arriba a abajo. Presente → más antiguo. NO proporcional al tiempo — distribuido uniformemente mediante flex
gap. - Tres tipos de iconos listos para usar:
#icon-wrench(trabajo,.tl-stop-work),#icon-book(educación,.tl-stop-edu),#icon-sparkle(vibra / proyecto paralelo,.tl-stop-vibe). Las tres definiciones<symbol>viven en el sprite SVG justo después de<header>. Para agregar una nueva categoría de icono:- Agregue un
<symbol id="icon-foo">con su ruta SVG - Agregue
.tl-icon-foo { color: var(--ink-mute); } - Haga referencia con
<svg class="tl-icon tl-icon-foo"><use href="#icon-foo"/></svg>
- Agregue un
- Cada punto lleva
data-experience="<slug>"; los puntos cuyo slug coincide con al menos una tarjeta de proyecto también obtienentabindex="0"para quejs/main.jspueda hacerlos interactivos para el filtro.
Filtro de proyectos (clic + hover)
Impulsado enteramente por js/main.js, sin configuración — escanea el DOM al cargar y conecta manejadores solo donde se aplican.
- Al cargar, cada punto cuyo slug
data-experienceesté presente en al menos una.project-cardobtiene.tl-stop-has-projects+role="button"+aria-pressed="false". Los puntos sin tarjetas vinculadas permanecen inertes. - Hover / focus en un punto interactivo → filtro temporal: las tarjetas no coincidentes se convierten en
.is-dim(la cuadrícula agrega.is-filtering, que CSS traduce endisplay: noneen las tarjetas atenuadas — se eliminan del diseño, no solo se atenúan). - Clic (o
Enter/Space) → bloqueo: el punto obtiene.is-locked, opacidad completa, icono coloreado con tinta, nombre de la empresa subrayado. Haga clic en el mismo punto nuevamente para limpiar; haga clic en otro para cambiar. - Mientras está bloqueado, al pasar el ratón por un punto diferente se previsualizan sus tarjetas;
mouseleaveen el carril (ofocusoutfuera de él) vuelve al punto bloqueado.