Communitygithub.com

nguyenvuquochung/nguyenvuquochung-portfolio

Fluxo de trabalho de implantação de portfólio: VS Code → GitHub → Cloudflare Pages.

O que é nguyenvuquochung-portfolio?

Este skill define um fluxo de trabalho completo e detalhado para implantar um site de portfólio estático e bilíngue usando VS Code, GitHub e Cloudflare Pages. Ele é direcionado a desenvolvedores que desejam publicar um site pessoal sem um processo de build complexo. O guia abrange desde a configuração inicial, como instalação de extensões do VS Code e criação do repositório no GitHub, até o deploy contínuo via Cloudflare Pages, com suporte a domínio personalizado e SSL automático. O repositório contém um site HTML/CSS/JS com rolagem horizontal e textos bilíngues (inglês/vietnamita), e o skill explica como modificar conteúdo, adicionar projetos e personalizar cores. Ele também inclui um carregador de conteúdo opcional baseado no GitHub raw, permitindo atualizações sem novo deploy, e uma seção de solução de problemas para erros comuns.

Funciona com✓Claude Code~Codex CLI✓Cursor
npx skills add nguyenvuquochung/nguyenvuquochung-portfolio

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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

  1. Acesse github.com → New repository
  2. Nome: nguyenvuquochung-portfolio (combine com o nome da pasta para evitar confusão)
  3. Visibilidade: Public (necessário para o Cloudflare Pages gratuito)
  4. 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

  1. Faça login em dash.cloudflare.com
  2. Workers & Pages → Create application → Pages → Connect to Git
  3. 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çãoValor
Framework presetNone
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

  1. No projeto Pages → Custom domains → Set up a custom domain
  2. Digite seu domínio (ex.: nguyenvuquochung.com)
  3. Cloudflare adicionará automaticamente os registros DNS (CNAME apontando para nguyenvuquochung-portfolio.pages.dev)
  4. 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

ProblemaSolução
Site mostra versão antigaRecarregue forçadamente: Ctrl+Shift+R. Limpe o cache do Cloudflare: Pages → Caching → Purge cache
Domínio personalizado não funcionaVerifique se o DNS do Cloudflare tem o registro CNAME; aguarde até 5 min para propagação
Erro JS X is not definedVerifique a ordem de carregamento dos scripts em index.html; main.js deve ser o último
Imagem de retrato reinicia ao recarregarEsperado — 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 emailComportamento normal; ele envolve automaticamente sua tag <script> para ofuscação de email

Habilidades Relacionadas