Criando páginas web no GitHub:Pages

O GitHub:Pages permite criar páginas estáticas e dinâmicas e até domínio com próprio.


Este é um pequeno e simples tutorial para a utilização de domínios personalizados registrados no registro.br com github:pages para seu projeto ou página pessoal.

O tutorial explica como configurar no registro.br, mas você pode configurar com a registradora do seu domínio.

O que é o GitHub:Pages

GitHub Pages é um sistema de hospedagem grátis e de fácil uso para algum projeto ou página pessoal com um repositório no GitHub.

É possível criar páginas personalizadas para seus projetos ou utilizar temas oferecidos pelo próprio GitHub. Você pode criar sites estáticos com apenas a força de seus conhecimentos em HTML e CSS ou até blogs com conteúdos dinâmicos utilizando o Jekyll.

Não vou abordar aqui como criar passo a passo cada tipo de site mas você pode encontrar como nessa página.

Criando o site para o seu projeto

Para criar um site para o seu projeto, faça um clone dele para sua máquina:

$ git clone https://github.com/voce/seu_projeto.git

Após isso, crie um branch orfão com o nome de gh-pages e remova todos os arquivos do seu projeto nesse branch, utilizando os seguintes comandos:

$ git checkout --orphan gh-pages
$ git rm -rf .

Construa o site do seu projeto nesse branch. Um comentário útil é que este branch só aparecerá no comando git branch após o seu primeiro commit.

Dê um push desse novo branch para o repositório do projeto:

$ git push origin gh-pages

Caso você queira saber como criar seu próprio site ou um site utilizando Jekyll, confira a documentação fornecida pelo GitHub.

Configurando um domínio próprio para o seu projeto no GitHub

Caso você não queira um domínio personalizado para o site do seu projeto, já é possível acessá-lo pelo link: https://voce.github.com/site_do_projeto.

No nosso caso vamos utilizar um domínio próprio para o projeto, registrado no registro.br.

Para isso crie um arquivo chamado CNAME nesse mesmo branch e coloque dentro dele o nome do domínio personalizado que você desejar. Faça o commit e dê outro push no repositório:

$ echo "seuprojeto.com.br" > CNAME

Ok. Pela parte do GitHub já está tudo pronto. Agora falta apenas as configurações de DNS noregistro.br.

No registro.br

Faça o login no site do registro.br e clique no domínio registrado para seu projeto.

  1. Marque a opção Utilizar os servidores do Registro.br
  2. Clique em Salvar & Editar DNS
  3. 2. Clique em Modo Avançado
  4. Agora clique em +Record para setar o DNS do seu projeto no github.

Edição de Zona

  1. Deixe o campo de subdomínios vazio.
  2. No campo Tipo selecione A.
  3. No campo Dados coloque o seguinte endereço: 204.232.175.78
  4. Clique em +Record para abrir um novo cadastro.

Agora precisamos colocar o subdomínio www para funcionar também.

  1. No campo subdomínio coloque www.
  2. No campo Tipo escolha CNAME
  3. No campo Dados coloque o endereço utilizado no arquivo CNAME de seu projeto:seuprojeto.com.br.
  4. Clique em Salvar.

Pronto!

Observações

O tempo para que as alterações de DNS sejam visíveis para toda a internet é de até 24 horas, segundo o próprio registro.br

As alterações feitas no branch gh-pages do GitHub podem demorar até 10 minutos para que tenham efeito, segundo o próprio GitHub.

Atenção

Acesse a página de ajuda do GitHubPages para mais informações sobre a criação de sites diferenciados para seu projeto, com templates, páginas de erro, redirecionamento, entre outras coisas.

Tags: css, dominio, página web, Git, site, html, GitHub, registro.br, Desenvolvimento
Via github.com

Total de comentários: 1
avatar
0 Spam
1
Olá, muito obrigada pela publicação! GitHub é demais!
Você já fez alguma publicação ou pretende fazer sobre páginas dinâmicas no GitHub?
Obrigada
avatar