Fluxo de Trabalho de Implantação de Portfólio
VS Code → GitHub → Cloudflare Pages
1. Configuração Única
1.1 Extensões do VS Code
Instale estas extensões antes de começar:
- Live Server (
ritwickdey.liveserver) — visualize o site localmente sem etapa de build - GitLens (opcional) — visualização aprimorada do histórico do Git
1.2 Criar Repositório no GitHub
- Acesse github.com → New repository
- Nome:
nguyenvuquochung-portfolio(combine com o nome da pasta para evitar confusão) - Visibilidade: Public (necessário para o Cloudflare Pages gratuito)
- Não adicione README/gitignore (você já tem arquivos localmente)
1.3 Inicializar Git Localmente
Abra o terminal do VS Code (Ctrl+`` ) e execute:
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
Um arquivo .gitattributes com * text=auto eol=lf já está presente — isso garante finais de linha Unix consistentes em todas as plataformas.
2. Cloudflare Pages — Primeiro Deploy
2.1 Conectar Repositório
- Faça login em dash.cloudflare.com
- Workers & Pages → Create application → Pages → Connect to Git
- Autorize o GitHub e selecione o repositório
nguyenvuquochung-portfolio
2.2 Configurações de Build
Este é um site estático sem etapa de build:
| Configuração | Valor |
|---|---|
| Framework preset | None |
| Build command | (deixe vazio) |
| Build output directory | / |
| Root directory | (deixe vazio) |
Clique em Save and Deploy. Seu site estará disponível em https://nguyenvuquochung-portfolio.pages.dev em cerca de 30 segundos.
2.3 Domínio Personalizado via Cloudflare DNS
- No projeto Pages → Custom domains → Set up a custom domain
- Digite seu domínio (ex.:
nguyenvuquochung.com) - Cloudflare adicionará automaticamente os registros DNS (CNAME apontando para
nguyenvuquochung-portfolio.pages.dev) - O certificado SSL é provisionado automaticamente — nenhuma configuração necessária
Se seu domínio foi registrado fora da Cloudflare: Atualize os nameservers no seu registrador para os nameservers da Cloudflare primeiro; então a configuração automática de DNS funcionará.
3. Fluxo de Trabalho Diário
Sempre que você atualizar conteúdo ou código:
# 1. Salve suas alterações no VS Code
# 2. Prepare, commite e envie
git add .
git commit -m "Update: descreva o que mudou"
git push
O Cloudflare Pages detecta o push e faz o redeploy automaticamente. Funciona em cerca de 30 segundos.
4. Estrutura do Projeto
nguyenvuquochung-portfolio/
├── index.html ← Esqueleto HTML (7 páginas virtuais, todo o layout)
├── style.css ← Todo o CSS (variáveis, animações, sistema de páginas)
├── js/
│ ├── content.js ← Dados de texto bilíngues (const C = {en, vi})
│ ├── about.js ← renderP2() — renderizador da página Sobre Mim
│ ├── contact.js ← goToPage7 / goToPage1FromP7
│ ├── production.js ← Array P3_PROJECTS + render/navegação (verde)
│ ├── director.js ← Array P4_PROJECTS + render/navegação (azul)
│ ├── assistant.js ← Array P5_PROJECTS + render/navegação (vermelho)
│ ├── editor.js ← Array P6_PROJECTS + render/navegação (amarelo)
│ └── main.js ← Mecanismo principal: cursor, física, transições, navegação, loader
├── .gitattributes ← Força finais de linha LF
└── SKILL.md ← Este arquivo
Ordem de Carregamento dos Scripts
Os scripts devem ser carregados nesta ordem (já definido em index.html):
content.js → about.js → contact.js → production.js → director.js → assistant.js → editor.js → main.js
main.js é o último porque chama funções definidas em todos os outros arquivos.
5. Atualizando Conteúdo
Alterar biografia / citação / filmografia
Edite js/content.js — o objeto C contém todo o texto bilíngue:
const C = {
en: { sub: "...", about: [...], films: [...], ... },
vi: { sub: "...", about: [...], films: [...], ... }
};
Adicionar um cartão de projeto a uma página de função
Edite o arquivo js/*.js relevante. Exemplo para um projeto de Diretor (js/director.js):
const P4_PROJECTS = [
{
id: 'my-new-film',
title: 'Tên Phim',
en: 'Film Title',
year: '2025',
desc: 'Descrição curta do projeto.',
img: '' // deixe vazio ou adicione uma URL
},
// ... entradas existentes
];
Novos projetos devem ser adicionados no topo do array de função relevante (
js/assistant.js,js/director.js,js/production.js,js/editor.js) para que apareçam primeiro naquela página. A ordem de exibição deve seguir a ordem de inserção dos itens adicionados recentemente, começando com o mais recente adicionado atualmente no topo.
Alterar cores de destaque
Edite style.css, bloco :root:
:root {
--green: #00e676; /* Produção */
--blue: #1a6fff; /* Diretor */
--red: #ff1a1a; /* Assistente de Direção */
--yellow: #ffe000; /* Editor */
}
6. Carregador de Conteúdo do Cloudflare (Opcional)
main.js inclui um carregador de conteúdo raw do GitHub. Se você quiser atualizar o conteúdo sem fazer novo deploy, hospede um content.json no GitHub e configure estas constantes no topo de main.js:
const GITHUB_OWNER = 'your-username';
const GITHUB_REPO = 'nguyenvuquochung-portfolio';
const GITHUB_BRANCH = 'main';
const GITHUB_PATH = 'content.json';
Quando definido, o site buscará o conteúdo atualizado a cada carregamento. Deixe vazio para desabilitar.
7. Solução de Problemas
| Problema | Solução |
|---|---|
| Site mostra versão antiga | Recarregue forçadamente: Ctrl+Shift+R. Limpe o cache do Cloudflare: Pages → Caching → Purge cache |
| Domínio personalizado não funciona | Verifique se o DNS do Cloudflare tem o registro CNAME; aguarde até 5 min para propagação |
Erro JS X is not defined | Verifique a ordem de carregamento dos scripts em index.html; main.js deve ser o último |
| Imagem de retrato reinicia ao recarregar | Esperado — o retrato é armazenado apenas na memória. Use o carregador de conteúdo do GitHub para persistência |
| Cloudflare injeta script de decodificação de email | Comportamento normal; ele envolve automaticamente sua tag <script> para ofuscação de email |