
Minilição · Português
Como publicar seu site pelo GitHub
Publique a página fornecida a partir de um repositório de prática no GitHub e confirme que uma edição posterior chega ao site público.
Para quem é esta lição?
Para quem quer colocar um site no ar e atualizá-lo com confiança. Os arquivos do site já são fornecidos; você pode usar GitHub Desktop e um assistente de programação sem escrever comandos Git.
Antes de começar
Você precisa das suas contas GitHub e Netlify e do GitHub Desktop ou acesso equivalente. Use um repositório e um projeto de hospedagem separados para prática. A página P1 fornecida funciona mesmo sem a aula de site pessoal. As respostas resolvidas são exemplos ilustrativos, não testes realizados na sua conta. Troque as observações de exemplo pelos seus resultados ou indique a etapa que continua bloqueada.
Tempo estimado: 21–33 min
Estimativas com os arquivos iniciais e as contas e ferramentas necessárias já prontas. Configuração, filas de publicação e esperas de e-mail ou DNS exigem tempo adicional. As estimativas não incluem instalar o GitHub Desktop, acessar contas e esperar filas de compilação. O uso da hospedagem depende da conta.
O que você vai aprender
- Conecte um repositório de prática à hospedagem.
- Publique uma alteração visível e verifique o resultado público.
- Localize a etapa que falhou quando a página pública estiver desatualizada.
Etapa 1
Prepare uma página que consiga reconhecer
Use o site P1 pronto em vez de montar primeiro um site.
Abra os arquivos da oficina e salve index.html, style.css, netlify.toml e .gitignore na mesma pasta de projeto. Abra index.html no computador para ver a página P1 e peça ao assistente para colocar esses arquivos na raiz de um repositório de teste separado.
A página deve mostrar Portfolio version P1 de forma visível. Escolha um repositório e um projeto de hospedagem para prática, verificando que nenhum deles é outro site que já está em produção.
Um exemplo concreto
Use uma única pasta de prática contendo index.html, style.css, netlify.toml e .gitignore. O marcador Portfolio version P1 na página inicial permite reconhecer essa primeira versão depois.
Use o site P1 e os arquivos de publicação fornecidos. Ajude-me a colocá-los na raiz de um repositório de prática separado usando GitHub Desktop, verificar se há arquivos privados nas alterações e conectar o repositório ao meu próprio projeto de prática no Netlify. Pergunte antes de publicar. Explique como confirmar P1 na página pública e depois ajude-me a publicar uma pequena edição P2 sem alterar um site de produção existente.Arquivos desta etapa
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Coloque seu site no ar pelo GitHub
Ao publicar, você copia uma versão dos seus arquivos para um serviço de hospedagem, onde outras pessoas podem acessá-los.
Sua página local, o repositório GitHub e a implantação na hospedagem são três lugares separados. Salvar localmente não atualiza automaticamente a página pública. Um commit registra uma versão; uma hospedagem conectada pode implantá-la.
Use um projeto novo de prática nesta lição. Garanta que a pasta contém a página inicial e a folha de estilos reais, não uma pasta superior com uma coleção de arquivos sem relação.
Para verificar visualmente a versão, acrescente o parágrafo “Portfolio version P1” antes do primeiro commit. Na tarefa final, mude para P2 junto com sua alteração relevante de conteúdo. O marcador ajuda a comparar arquivo local, commit remoto e página implantada sem adivinhar qual cópia está aberta.
Exemplo resolvido
Alex acrescenta a frase visível “Portfolio version P1”. Essa frase e o ID do commit permitem distinguir uma implantação bem-sucedida de um navegador que ainda mostra a versão antiga.
Extra implementation exercise
Você salvou P1 localmente, mas a página hospedada ainda diz P0. Quais duas etapas de publicação podem estar faltando?
Mostrar uma solução comentada
Confira primeiro o repositório e depois o registro de implantação. Atualizar o navegador não publica uma mudança que nunca chegou à hospedagem.
- Verifica se a alteração foi registrada em commit e enviada.
- Verifica se uma implantação bem-sucedida usou esse commit.
Erro comum
Tratar um salvamento local como prova de uma nova implantação.
Etapa 2
Revise e envie a alteração ao GitHub
Verifique a lista de arquivos antes de publicá-la.
No GitHub Desktop, revise os arquivos alterados com seu assistente. Faça um commit dos arquivos de site pretendidos e envie a branch de prática com push quando estiver pronto. Mantenha arquivos de ambiente e segredos de conta fora do repositório.
Abra o repositório no GitHub e confirme que a página inicial pretendida está na raiz. Se aparecer um arquivo privado nas alterações, remova-o antes de enviar qualquer coisa.
Um exemplo concreto
Confira a lista de arquivos alterados antes de enviá-los. index.html e style.css pertencem à página pública; um arquivo privado .env, não. Depois do push, confira os arquivos remotos em vez de presumir que salvar localmente já chegou ao GitHub.
Experimente
Materiais para começar
Sem um site pronto? Baixe e extraia o pacote. Coloque index.html e style.css ao lado de netlify.toml no repositório de prática. A marca P1 já aparece. A publicação real requer suas contas do GitHub e de hospedagem.
Arquivos desta etapa
Quais arquivos você enviou e consegue encontrar a página inicial pretendida no repositório remoto de prática?
Converse com o tutor sobre sua resposta
Mostrar uma solução comentada
Registro de exemplo: O GitHub Desktop mostrou index.html, style.css, netlify.toml e .gitignore. Fiz commit e push desses arquivos. Na lista do GitHub, index.html está na raiz; não há .env nem arquivo privado da conta.
- Lista os arquivos públicos esperados e verifica que arquivos privados foram excluídos.
- Confirma que a página inicial está na raiz de publicação do repositório remoto.
Arquivos desta etapa
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Coloque os arquivos certos no repositório
Registre um conjunto pequeno de arquivos públicos do site e examine-o antes de enviar.
Caminho guiado: crie um repositório de prática no GitHub e use File → Clone repository no GitHub Desktop para cloná-lo em uma nova pasta local. Acrescente primeiro o .gitignore fornecido à pasta clonada. Depois copie apenas os arquivos públicos do site, com index.html na raiz, e examine as mudanças antes de prepará-las e registrá-las em commit.
No GitHub Desktop, examine Changes e as diferenças, escreva um resumo, faça o commit na branch pretendida e escolha Push origin. Se aparecer Publish branch, publique a branch no remoto. O exemplo de linha de comando é uma alternativa para um clone já inicializado. Uma regra de exclusão Git não remove um segredo já registrado. Se expuser uma chave real, revogue-a e corrija o repositório; excluir o arquivo atual não basta.
Exemplo resolvido
A lista de comandos prepara arquivos específicos do site, não todos os arquivos do computador. Depois mostra a alteração preparada para você verificar o conteúdo do commit.
git add index.html style.css netlify.toml .gitignore
git diff --cached
git commit -m "Add personal website"Extra implementation exercise
As diferenças preparadas incluem .env com uma chave de serviço. O que fazer antes de enviar?
Mostrar uma solução comentada
Retire o arquivo da área de preparação, mantenha-o fora do controle de versão e examine as diferenças novamente. Se a chave chegou a um remoto ou a outras pessoas, revogue-a em vez de supor que uma regra de exclusão a tornou privada.
Antes de enviar, examine as diferenças preparadas novamente. Se o repositório já tinha commits, examine o histórico e o remoto em busca da credencial sem copiar o valor para um relatório. Faça a rotação de qualquer chave real exposta; acrescentar .gitignore não apaga uma exposição anterior.
- Retira o arquivo secreto das alterações preparadas.
- Verifica se a credencial já foi exposta e faz a rotação quando necessário.
Erro comum
Enviar uma pasta inteira de desenvolvimento sem revisar o conteúdo.
Etapa 3
Conecte o repositório à hospedagem
Faça o provedor publicar a pasta que contém a página inicial.
Crie ou escolha seu projeto de prática separado no Netlify e conecte o repositório e a branch pretendidos. Para este site simples fornecido, use a configuração de publicação incluída; não é necessária uma compilação de framework.
Espere o provedor informar que a implantação foi concluída. Abra a URL pública numa janela privada e procure P1; uma indicação de sucesso no painel, por si só, não confirma a página correta.
Um exemplo concreto
Página local: P1. GitHub: P1. A hospedagem informa que publicou, mas a URL pública mostra 404. O próximo passo é verificar se o serviço está publicando a pasta que realmente contém index.html.
Experimente
Materiais para começar
Sem um site pronto? Baixe e extraia o pacote. Coloque index.html e style.css ao lado de netlify.toml no repositório de prática. A marca P1 já aparece. A publicação real requer suas contas do GitHub e de hospedagem.
Arquivos desta etapa
A URL pública sem sessão iniciada mostra sua página P1? Se não, o que você realmente vê?
Converse com o tutor sobre sua resposta
Mostrar uma solução comentada
Registro de exemplo: Abri a URL pública da hospedagem de prática em uma janela privada e vi Portfolio version P1. Em um caso de falha, “404 na URL pública; P1 local ainda abre” me levaria à pasta publicada e à página inicial na raiz, não às cores da página.
- Relata a página ou o erro realmente mostrado na URL pública sem login.
- Usa o marcador P1 para distinguir a página esperada de outra publicação.
Arquivos desta etapa
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Conecte a hospedagem e escolha a pasta de publicação
A hospedagem precisa saber qual repositório usar e qual pasta contém os arquivos públicos.
Na sua conta Netlify, crie um projeto a partir do repositório de prática e escolha a branch de produção pretendida. Autorize apenas o acesso necessário. Para HTML simples, deixe o comando de compilação vazio e publique a raiz do repositório.
O netlify.toml fornecido torna a raiz explícita. Um projeto com framework usaria a saída de compilação do próprio framework; não copie esta configuração para outro projeto sem conferir a estrutura.
Confira a árvore de pastas antes de configurar: raiz do repositório → index.html e style.css. Para este caminho de HTML simples, publish='.' combina com nenhum comando de compilação. A pasta-fonte de um framework não é automaticamente sua saída publicável; as instruções de compilação determinam essa saída.
Exemplo resolvido
Se a raiz contém index.html, publicar “.” serve esse arquivo como página inicial. Publicar uma pasta sem a página inicial compilada pode produzir uma implantação cuja raiz retorna 404.
[build]
publish = "."Extra implementation exercise
A implantação tem sucesso, mas a página inicial retorna 404. Qual arquivo e configuração você deve comparar?
Mostrar uma solução comentada
Confirme que o diretório selecionado contém index.html. Um envio bem-sucedido não prova que a pasta certa foi enviada.
- Encontra index.html no repositório ou na saída real da compilação.
- Compara essa localização com o diretório de publicação.
Erro comum
Informar um comando de compilação de framework para um site HTML que não precisa compilar.
Etapa 4
Investigue uma página pública desatualizada
Compare o repositório, o registro da hospedagem e o resultado no navegador.
Faça uma pequena edição de conteúdo e identifique a página como P2 com seu assistente. Salve, faça commit e push e depois examine a implantação correspondente na hospedagem. Guarde o registro P1 anterior para comparação.
Verifique qual versão está no GitHub, qual foi implantada pelo provedor e o que a URL pública solicitada mostra. Atualizar o navegador não envia uma edição que ainda não recebeu push.
Um exemplo concreto
GitHub P2 → hospedagem P1 → público P1 aponta para a etapa de publicação. GitHub P2 → hospedagem P2 → público P1 exige conferir a URL solicitada e a resposta entregue. A mesma aparência de página antiga pode ter causas diferentes.
Experimente
Materiais para começar
Sem um site pronto? Baixe e extraia o pacote. Coloque index.html e style.css ao lado de netlify.toml no repositório de prática. A marca P1 já aparece. A publicação real requer suas contas do GitHub e de hospedagem.
Arquivos desta etapa
Que versão o repositório, a hospedagem e a página pública mostram agora? Onde começa a divergência?
Converse com o tutor sobre sua resposta
Mostrar uma solução comentada
Diagnóstico de exemplo: O GitHub contém P2, a última publicação bem-sucedida da hospedagem ainda identifica o commit P1 e a página pública mostra P1. A primeira divergência é GitHub → hospedagem. Vou conferir o branch selecionado e o registro da publicação antes de tratar isso como problema de cache do navegador.
- Registra separadamente as versões observadas no GitHub, na publicação da hospedagem e na página pública.
- Localiza a primeira divergência e escolhe uma verificação nessa etapa.
Arquivos desta etapa
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Relacione a página no ar ao commit
Verifique a versão implantada e a experiência do visitante, não apenas um indicador verde.
Abra a URL pública da hospedagem em uma janela privada. Confirme que a página inicial e os estilos carregam sem sua sessão de proprietário. Clique nos links internos e confira o marcador P1.
Compare o commit registrado pela hospedagem com o último commit pretendido do repositório. Uma página desatualizada pode vir de implantação antiga, branch inesperada ou cache. Use as observações para escolher a próxima verificação.
Exemplo resolvido
Um registro útil contém commit, URL da implantação e marcador visível. Se a implantação lista o commit P1, mas a página contém P0, examine a URL solicitada e a resposta antes de mudar configurações aleatórias de compilação.
Extra implementation exercise
O repositório contém P2, mas o registro da implantação indica P1. Isso é principalmente um problema de atualizar o navegador?
Mostrar uma solução comentada
Não. Investigue por que a hospedagem não implantou o commit P2. Só diagnostique o cache do navegador depois de confirmar que a versão pretendida está realmente implantada.
- Identifica que P2 não foi implantado.
- Verifica a branch selecionada e o resultado da última compilação.
Erro comum
Verificar apenas o painel sem abrir a página como visitante.
Etapa 5
Publique e verifique P2
Conclua com uma atualização pública real que você consiga identificar.
Publique a alteração P2 pelo mesmo percurso de prática. Abra o endereço final sem sessão iniciada e experimente o link ou conteúdo afetado. Guarde as identificações de alteração e implantação de P1 e P2 fornecidas pelas ferramentas.
Verifique a identificação e a funcionalidade realmente alterada, não apenas um ícone verde de implantação. Indique qualquer etapa que não conseguiu concluir.
Um exemplo concreto
Uma entrega útil de P2 reúne três elementos: a alteração correspondente no repositório, o registro da hospedagem e a frase nova visível. Um ícone verde sem o conteúdo público esperado deixa a última etapa sem verificação.
Experimente
Materiais para começar
Sem um site pronto? Baixe e extraia o pacote. Coloque index.html e style.css ao lado de netlify.toml no repositório de prática. A marca P1 já aparece. A publicação real requer suas contas do GitHub e de hospedagem. Os arquivos e conteúdos de teste estão incluídos. A verificação real exige sua própria conta, caixa de entrada ou domínio conforme os pré-requisitos. É possível inspecionar localmente; marque etapas reais não executadas como não testadas.
Arquivos desta etapa
Apresente seu resultado P2 e as verificações que mostram que a edição pretendida chegou à página pública.
O que entregar A URL pública de prática, os registros de versão P1/P2 e as verificações reais da página sem sessão iniciada.
Converse com o tutor sobre sua resposta
Mostrar uma solução comentada
Entrega de exemplo: A URL de prática mostra Portfolio version P2 sem login. A alteração no repositório e a publicação bem-sucedida identificam o mesmo commit P2. A frase revisada aparece e Contact continua chegando à seção de contato. Guardei o registro P1 para identificar a versão anterior que funcionava.
- Relaciona o resultado público P2 à alteração e à publicação correspondentes.
- Relata uma verificação no navegador do conteúdo ou da ação realmente alterados.
Arquivos desta etapa
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Sua tarefa: publicar uma segunda versão
Mostre que o fluxo de publicação funciona novamente depois da primeira versão bem-sucedida.
Faça uma mudança visível relevante, como acrescentar a descrição de um projeto. Registre em commit e envie pelo seu próprio repositório. Espere a implantação correspondente e depois verifique a página pública.
Guarde os dois registros de versão. Você usará a ligação entre commits e implantações ao aprender prévias e reversões.
Exemplo resolvido
Seu registro de antes e depois deve dizer o que mudou e identificar os dois commits. Só a URL pública não identifica qual versão alguém viu.
O roteiro completo de referência está em reference/assignment-walkthrough.txt. Compare as etapas com seu resultado; preencha o registro de teste com observações do seu próprio projeto.
Extra implementation exercise
Publique P2 e forneça evidências de que a hospedagem serve o commit pretendido.
- Altere um elemento visível, atualize o marcador de P1 para P2 e examine as diferenças.
- Faça o commit e envie; encontre a implantação correspondente.
- Teste a URL pública e registre o novo marcador.
Mostrar uma solução comentada
Antes do primeiro commit, coloque 'Portfolio version P1' em um parágrafo visível. Salve, examine as diferenças em Changes no GitHub Desktop, registre apenas index.html/style.css/netlify.toml/.gitignore e envie a branch pretendida. Na visualização de arquivos do GitHub, confirme que os quatro arquivos estão na raiz.
Registre o ID do commit como P1. No Netlify, selecione o mesmo repositório e branch, deixe a compilação vazia e use publish='.'. Relacione o commit da implantação bem-sucedida a P1, abra a URL pública desconectado e leia o marcador. Mude para P2, repita commit, envio e implantação e guarde os dois registros.
Um diagnóstico útil é: repositório=P2, implantação=P1, marcador público=P1 → investigar branch, compilação e estado da implantação. Outro caso é implantação=P2, marcador=P1 → primeiro examinar o host solicitado, a resposta e o cache. Não publique um segredo para testar se o Git consegue escondê-lo; examine as diferenças preparadas e qualquer histórico antes de enviar.
- O conteúdo público corresponde à alteração P2 e ao commit registrado.
- Página inicial, CSS e navegação funcionam sem acesso de proprietário.
Erro comum
Afirmar sucesso da implantação com uma captura da página local.
Esta lição foi útil?
Deixe uma curtida ou compartilhe com alguém que possa aproveitar.
Continue aprendendo
- Como criar seu primeiro site pessoal
- Como conectar um domínio próprio ao seu site
- Como configurar e-mail no seu próprio domínio
- Como tornar seu site utilizável em celulares
- Como acelerar o carregamento das imagens do seu site
- Como receber os comentários do seu site na sua caixa de entrada
- Como adicionar assinaturas por e-mail ao seu site
- Como enviar e-mails automáticos pelo seu site
- Como salvar envios de formulário em um banco de dados
- Como permitir que as pessoas entrem no seu site
- Como manter uma página privada
- Como permitir que usuários editem as informações do perfil
- Como permitir que usuários enviem imagens
- Como manter chaves de API fora do frontend
- Como mostrar dados de uma API externa no seu site
- Como adicionar um chatbot de IA ao seu site
- Como fazer um chatbot responder com base no seu conteúdo
- Como adicionar um blog ao seu site
- Como adicionar busca ao seu site
- Como adicionar outro idioma ao seu site
- Como ajudar o Google a encontrar seu site
- Como corrigir a prévia do seu site ao compartilhar um link
- Como medir visitas e ações úteis no seu site
- Como permitir que visitantes agendem um horário
- Como aceitar um pagamento no seu site
- Como visualizar mudanças do site antes de publicar
- Como desfazer uma implantação com falha do seu site
- Como fazer backup e restaurar os dados do seu site
- Como encontrar e corrigir erros no seu site no ar