Communitygithub.com

Flujo de trabajo de despliegue del portafolio

Guía paso a paso para desplegar un sitio estático desde VS Code a Cloudflare Pages usando GitHub.

¿Qué es Flujo de trabajo de despliegue del portafolio?

Este skill proporciona un flujo de trabajo completo para desarrolladores que deseen desplegar un sitio web estático de portafolio utilizando VS Code, GitHub y Cloudflare Pages. Está diseñado específicamente para el portafolio de Nguyễn Vũ Quốc Hưng, un sitio web multilingüe con múltiples secciones interactivas. El skill cubre desde la configuración inicial, incluyendo extensiones de VS Code, inicialización de Git y creación del repositorio en GitHub, hasta el despliegue automatizado en Cloudflare Pages. También explica la estructura del proyecto, cómo actualizar contenido (biografía, proyectos, colores de acento) y ofrece consejos de solución de problemas comunes. Soporta tanto el desarrollo local con Live Server como el despliegue continuo mediante push a GitHub, con la opción de usar un cargador de contenido externo para actualizaciones sin redeploy.

Compatible con✓Claude Code~Codex CLI✓Cursor
npx skills add nguyenvuquochung/nguyenvuquochung-portfolio

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace Flujo de trabajo de despliegue del portafolio?

VS Code → GitHub → Cloudflare Pages


1. Configuración única

1.1 Extensiones de VS Code

Instale estas extensiones antes de comenzar:

  • Live Server (ritwickdey.liveserver) — previsualice el sitio localmente sin paso de compilación
  • GitLens (opcional) — vista mejorada del historial de Git

1.2 Crear repositorio en GitHub

  1. Vaya a github.com → New repository
  2. Nombre: nguyenvuquochung-portfolio (que coincida con el nombre de la carpeta para evitar confusiones)
  3. Visibilidad: Public (requerido para Cloudflare Pages gratuito)
  4. No agregue README/gitignore (ya tiene archivos localmente)

1.3 Inicializar Git localmente

Abra la terminal de VS Code (Ctrl+`` ) y ejecute:

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

Ya existe un archivo .gitattributes con * text=auto eol=lf; esto garantiza saltos de línea Unix consistentes en todas las plataformas.


2. Cloudflare Pages — Primer despliegue

2.1 Conectar repositorio

  1. Inicie sesión en dash.cloudflare.com
  2. Workers & Pages → Create application → Pages → Connect to Git
  3. Autorice GitHub y seleccione el repositorio nguyenvuquochung-portfolio

2.2 Configuración de compilación

Este es un sitio estático sin paso de compilación:

ConfiguraciónValor
Preset de frameworkNone
Comando de compilación(dejar vacío)
Directorio de salida de compilación/
Directorio raíz(dejar vacío)

Haga clic en Save and Deploy. Su sitio estará en vivo en https://nguyenvuquochung-portfolio.pages.dev en aproximadamente 30 segundos.

2.3 Dominio personalizado a través de Cloudflare DNS

  1. En el proyecto de Pages → Custom domains → Set up a custom domain
  2. Ingrese su dominio (ej. nguyenvuquochung.com)
  3. Cloudflare agregará automáticamente los registros DNS (CNAME apuntando a nguyenvuquochung-portfolio.pages.dev)
  4. El certificado SSL se aprovisiona automáticamente — no se necesita configuración

Si su dominio fue registrado fuera de Cloudflare: Primero, actualice los servidores de nombres en su registrador a los servidores de nombres de Cloudflare, luego la configuración automática de DNS funcionará.


3. Flujo de trabajo diario

Cada vez que actualice contenido o código:

# 1. Guarde sus cambios en VS Code
# 2. Prepare, confirme y envíe
git add .
git commit -m "Update: describa qué cambió"
git push

Cloudflare Pages detecta el push y redepliega automáticamente. En vivo en ~30 segundos.


4. Estructura del proyecto

nguyenvuquochung-portfolio/
├── index.html          ← Esqueleto HTML (7 páginas virtuales, todo el layout)
├── style.css           ← Todo el CSS (variables, animaciones, sistema de páginas)
├── js/
│   ├── content.js      ← Datos de texto bilingüe (const C = {en, vi})
│   ├── about.js        ← renderP2() — Renderizador de la página Acerca de mí
│   ├── contact.js      ← goToPage7 / goToPage1FromP7
│   ├── production.js   ← Array P3_PROJECTS + render/nav (verde)
│   ├── director.js     ← Array P4_PROJECTS + render/nav (azul)
│   ├── assistant.js    ← Array P5_PROJECTS + render/nav (rojo)
│   ├── editor.js       ← Array P6_PROJECTS + render/nav (amarillo)
│   └── main.js         ← Motor principal: cursor, física, transiciones, navegación, cargador
├── .gitattributes      ← Forzar saltos de línea LF
└── SKILL.md            ← Este archivo

Orden de carga de scripts

Los scripts deben cargarse en este orden (ya configurado en index.html):

content.js → about.js → contact.js → production.js → director.js → assistant.js → editor.js → main.js

main.js es el último porque llama a funciones definidas en todos los demás archivos.


5. Actualización de contenido

Cambiar biografía / cita / filmografía

Edite js/content.js — el objeto C contiene todo el texto bilingüe:

const C = {
  en: { sub: "...", about: [...], films: [...], ... },
  vi: { sub: "...", about: [...], films: [...], ... }
};

Agregar una tarjeta de proyecto a una página de rol

Edite el archivo js/*.js correspondiente. Ejemplo para un proyecto de Director (js/director.js):

const P4_PROJECTS = [
  {
    id: 'my-new-film',
    title: 'Tên Phim',
    en: 'Film Title',
    year: '2025',
    desc: 'Descripción corta del proyecto.',
    img: ''           // dejar vacío o agregar una URL
  },
  // ... entradas existentes
];

Los nuevos proyectos deben agregarse al principio del array del rol correspondiente (js/assistant.js, js/director.js, js/production.js, js/editor.js) para que aparezcan primero en esa página. El orden de visualización debe seguir el orden de inserción para los elementos agregados recientemente, comenzando con el más reciente actualmente en la parte superior.

Cambiar colores de acento

Edite style.css, bloque :root:

:root {
  --green:  #00e676;   /* Producción */
  --blue:   #1a6fff;   /* Director */
  --red:    #ff1a1a;   /* Asistente de Dirección */
  --yellow: #ffe000;   /* Editor */
}

6. Cargador de contenido de Cloudflare (Opcional)

main.js incluye un cargador de contenido desde GitHub-raw. Si desea actualizar contenido sin redeploy, aloje un content.json en GitHub y configure estas constantes al inicio de main.js:

const GITHUB_OWNER  = 'your-username';
const GITHUB_REPO   = 'nguyenvuquochung-portfolio';
const GITHUB_BRANCH = 'main';
const GITHUB_PATH   = 'content.json';

Cuando esté configurado, el sitio obtendrá el contenido actualizado en cada carga. Déjelo vacío para deshabilitar.


7. Solución de problemas

ProblemaSolución
El sitio muestra una versión antiguaActualización forzada: Ctrl+Shift+R. Purga de caché de Cloudflare: Pages → Caching → Purge cache
El dominio personalizado no funcionaVerifique que Cloudflare DNS tenga el registro CNAME; espere hasta 5 minutos para la propagación
Error JS X is not definedVerifique el orden de carga de scripts en index.html; main.js debe ser el último
La imagen de retrato se reinicia al recargarEsperado — el retrato se almacena solo en memoria. Use el cargador de contenido de GitHub para persistencia
Cloudflare inyecta script de decodificación de correoComportamiento normal; envuelve automáticamente su etiqueta <script> para ofuscación de correo

Skills relacionados