¿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
- Vaya a github.com → New repository
- Nombre:
nguyenvuquochung-portfolio(que coincida con el nombre de la carpeta para evitar confusiones) - Visibilidad: Public (requerido para Cloudflare Pages gratuito)
- 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
- Inicie sesión en dash.cloudflare.com
- Workers & Pages → Create application → Pages → Connect to Git
- 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ón | Valor |
|---|---|
| Preset de framework | None |
| 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
- En el proyecto de Pages → Custom domains → Set up a custom domain
- Ingrese su dominio (ej.
nguyenvuquochung.com) - Cloudflare agregará automáticamente los registros DNS (CNAME apuntando a
nguyenvuquochung-portfolio.pages.dev) - 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
| Problema | Solución |
|---|---|
| El sitio muestra una versión antigua | Actualización forzada: Ctrl+Shift+R. Purga de caché de Cloudflare: Pages → Caching → Purge cache |
| El dominio personalizado no funciona | Verifique que Cloudflare DNS tenga el registro CNAME; espere hasta 5 minutos para la propagación |
Error JS X is not defined | Verifique el orden de carga de scripts en index.html; main.js debe ser el último |
| La imagen de retrato se reinicia al recargar | Esperado — el retrato se almacena solo en memoria. Use el cargador de contenido de GitHub para persistencia |
| Cloudflare inyecta script de decodificación de correo | Comportamiento normal; envuelve automáticamente su etiqueta <script> para ofuscación de correo |