Pular para o conteúdo
Criação de Apps

GitHub Pages: como publicar um site estático grátis

Resposta rápida

Para publicar um site estático no GitHub Pages, crie um repositório, envie os arquivos com uma página index.html, abra as configurações do repositório, ative o Pages escolhendo a branch e a pasta de origem, e aguarde alguns minutos até o endereço ficar disponível. O recurso tem limites e regras, que constam na documentação do GitHub.

Neste artigo
  1. O que é um site estático
  2. Passo a passo
  3. Se a página não abrir
  4. Domínio próprio
  5. Quando buscar outra opção

O que é um site estático

Um site estático é feito de arquivos prontos, como HTML, CSS, imagens e JavaScript, que o navegador apenas exibe. Não há banco de dados nem código rodando no servidor. Serve bem para portfólio, página de apresentação, documentação e landing pages.

O GitHub Pages é um serviço do GitHub que publica esses arquivos a partir de um repositório. As regras, os limites e as condições do recurso podem mudar, então consulte a documentação oficial do GitHub antes de usá-lo em algo importante.

Passo a passo

Os nomes de botões e menus podem variar conforme a versão da interface.

  1. Crie uma conta no GitHub, se ainda não tiver. Se for a sua primeira vez com a plataforma, veja Git e GitHub para iniciantes.
  2. Crie um novo repositório e dê um nome simples, sem espaços.
  3. Envie para ele os arquivos do site. O principal deve se chamar index.html e ficar na raiz do repositório.
  4. Abra a aba de configurações do repositório e procure a seção Pages.
  5. Em origem, escolha a branch principal e a pasta raiz, e salve.
  6. Espere alguns minutos. O endereço do site aparece na própria seção Pages.

Um index.html mínimo já funciona: um título e um parágrafo bastam para testar.

Se a página não abrir

  • Confira se o arquivo se chama index.html, com letras minúsculas.
  • Veja se a branch e a pasta escolhidas na configuração são as corretas.
  • Aguarde um pouco: a primeira publicação pode demorar.
  • Se imagens não aparecem, revise os caminhos nos arquivos, lembrando que maiúsculas e minúsculas contam.
  • Limpe o cache do navegador ou teste em uma janela anônima.

Domínio próprio

Se quiser um endereço como o do seu nome ou negócio, registre um domínio e configure os apontamentos de DNS conforme a documentação do GitHub. Para entender como domínio, hospedagem e DNS se relacionam, veja Domínio, hospedagem e DNS: como um site chega até a sua tela.

Quando buscar outra opção

Se você precisa de formulários que gravam dados, login de usuários ou uma loja com pagamento, será preciso um serviço com processamento no servidor ou integrações externas. Para sites de apresentação, o GitHub Pages costuma ser uma forma simples de começar.

  • GitHub
  • Hospedagem
  • HTML
  • Tutorial

Perguntas frequentes

GitHub Pages serve para loja virtual ou sistemas com banco de dados?

Não. Ele hospeda apenas páginas estáticas, sem código de servidor. Para sistemas com banco de dados, é preciso outro tipo de hospedagem.

Posso usar meu próprio domínio?

Sim, o serviço permite configurar um domínio personalizado. Os passos de DNS dependem de onde o domínio foi registrado e estão na documentação oficial.

Leia também

Criação de Apps

Domínio, hospedagem e DNS: como um site chega até a sua tela

O que são domínio, hospedagem e DNS, como se encaixam e o que fazer para o seu site abrir pelo endereço certo.

· 5 min de leitura
Criação de Apps

Git e GitHub para iniciantes: o que são e como usar

O que cada um faz, os comandos essenciais e o fluxo mais simples para guardar o histórico dos seus códigos.

· 5 min de leitura
Criação de Apps

Subi uma chave de API ou senha no GitHub: o que fazer agora

O passo a passo de emergência para quem publicou um segredo por engano num repositório.

· 5 min de leitura
Criação de Apps

Currículo em HTML e CSS: como montar e salvar em PDF

Para quem programa: monte o currículo em uma página HTML com CSS de impressão, publique o link e gere o PDF para as vagas que pedem arquivo.

· 5 min de leitura

Deixe seu comentário