quarta-feira, 27 de maio de 2020

Como utilizar o GitHub Pages

Como dar vida ao seu repositório no GitHub com GitHub Pages.

Pra mim uma das partes mais interessantes, empolgantes de trabalhar em um projeto é em sua conclusão vê-lo funcionando.
O GitHub Pages se torna assim um local de fácil acesso para publicações e com uma url conhecida, que vincula o desenvolvedor ao produto do seu trabalho, tudo isso sem custo, para projetos open source.

Requisitos:
  1. Um repositório no github
  2. Uma página index.html
  3. Configurar o branch que será utilizado no github pages

Quando iniciei minhas pesquisas para utilizar o github pages, criei o repositório https://github.com/fabioaraujo/github-pages, tendo essa informação, sei que o github publicará meu projeto no endereço https://fabioaraujo.github.io/github-pages/, caso queira utilizar o endereço raiz do seu perfil, o nome do repositório deverá ser igual ao seu domínio, no meu caso seria fabioaraujo.github.io

Inclua um arquivo index.html como abaixo e faça push para o seu repositório no github, caso prefira organizar o código css em seu próprio arquivo basta acessar o repositório mencionado acima.

Entre em "settings" no seu repositório do GitHub e role a tela até encontrar a sessão do GitHub Pages ,
conforme imagem abaixo, selecione o branch utilizado para ser apresentado, por padrão será utilizado o branch gh-pages. Em meu teste precisei selecionar um Jekyll theme, mesmo não utilizando no portal para que o código fosse publicado e a mensagem "Your site is published" aparecesse em verde.

GitHub Pages Settings

Após essas configurações basta acessar o endereço informado e seu portal estará online para visualização.