Neste artigo, falarei sobre a estrutura do meu blog, um resumo geral de como ele funciona, como faço as publicações, os macetes envolvidos, etc. Recentemente, recebi várias perguntas sobre isso e decidir fazer este artigo para compartilhar isso com você.

Sumário

• Introdução;
• Resumo da estrutura;
• Resumo sobre o Jekyll;
• Como usar o Github Pages;
• Como configurar seu domínio no Github Pages;
• Como automatizar o build;
• Como configurar HTTPS (via cloudflare);
• Referências;
• Conclusão.

Introdução

Você deve ter percebido que estou tentando manter uma frequência de pelo menos uma publicação por semana, veja aqui o artigo da semana passada.

Antes de entrar neste artigo, certifique-se que você já leu o meu outro artigo, [Porque utilizar o Jekyll](https://leonardorifeli.tech/development/2015/05/06/porque-utilizar-o-jekyll.html).

Enfim, vamos direto ao ponto. Falarei sobre a estrutura do meu blog. Um resumo geral de como ele funciona, como faço as publicações, os macetes envolvidos, etc. E também, como você pode fazer algo parecido. Recentemente, recebi várias perguntas sobre isso e decidir fazer este artigo para compartilhar isso com você.

Vou escrevendo este magnífico artigo, enquando escuto o set de Tech House #023 do Mark Jones.

Resumo da estrutura

Nesto ponto, irei dar um breve resumo do que é utilizado no meu blog e nos próximos tópicos, entrarei em mais detalhes.

Basicamente, meu blog é feito em Jekyll com um template adaptado. Atualmente, ele está hospedado no Github Pages e possuí uma [CDN (Content Delivery Network)](https://pt.wikipedia.org/wiki/Content_Delivery_Network) que neste caso, utilizo o Cloud Flare.

Mesmo usando o Github Pages, eu configurei meu domínio leonardorifeli.tech para funcionar com HTTPs (via Cloud Flare). Se você acessar [leonardorifeli.github.io](http://leonardorifeli.github.io/), você será redirecionado para [leonardorifeli.tech (com HTTPS)](https://leonardorifeli.tech/).

E para fazer as publicações? O Jekyll funciona com Markdown, esse foi o ponto principal para a minha adesão ao Jekyll, com isso, eu escrevo os artigos usando Markdown.

No repositório do meu blog existem duas branchs principais, sendo, gh-pages e master. Eu automatizei o build (utilizando o travis), com essa automatização, sempre que é efetuado um push para a branch gh-pages, ele irá executar o bash abaixo e depois que tudo estiver OK, é só fazer um PR (Pull Request) da branch gh-pages para a master e pronto, está no ar.

Salientando que, todos os pushs que eu efetuo, são na branch gh-pages e não (nunca e jamais) na master.

Adicional: Eu utilizo o Jekyll há mais de um ano (você pode conferir mais sobre o Jekyll no meu artigo Porque utilizar o Jekyll).

Resumo sobre o Jekyll

Jekyll é um gerenciador de códigos estáticos. Isso mesmo, ele não faz uso de banco de dados e não requesita um servidor robusto para funciona. Um dos benefécios é poder utilizar o Github Pages para hospedar o site. Ou seja, você pode desenvolver páginas e até mesmo um blog de forma estática, apenas utilizando HTML (e claro, Markdown) que você provavelmente já conhece. Ele é baseado em vários formatos como Markdown (conforme já dito) para formatação de textos e posts e um padrão de template chamado Liquid com um pouco de YAML para os arquivos de configurações.

Você deve ter visto mais no meu artigo sobre, Porque utilizar o Jekyll. Se não, acesse para conhecer mais detalhes sobre este cara. Salientando que, você irá ler a palavra Jekyll demasiadas vezes.

Como usar o Github Pages

Eu expliquei um pouco, no artigo já mencionado, mas, aqui vai um review.

Acesse sua conta no Github, crie um novo repositório com o nome da organização, utilizando o sufixo .github.io. Exemplo: leonardorifeli.github.io.

Em seguido acesse a página do repositório, clique em Settings e depois no box GitHub Pages clique em Automatic page generator, na etapa seguinte clique em Continue to layouts. O próximo passo será selecionar um layout (não se preocupe muito quanto a isso), simplesmente clique em Publish page.

Você poderá encontrar mais detalhes sobre este tópico no site do Github Pages.

Após finalizar você poderá clonar o projeto e substituir os arquivos por algum projeto Jekyll já configurado que você tenha encontrado na internet.

Logo após a configuração, você poderá acessar com nome-repositorio.github.io. Porém, acredito que você já tenha um domínio e queira que seu blog seja acessível por ele, exemplo, seudominio.com. Chega mais que é o próximo tópico.

Alguns sites para você encontrar temas para Jekyll:

• github.com/jekyll/jekyll/wiki/Themes;
• github.com/planetjekyll/awesome-jekyll-themes;
• jekyllthemes.org;
• jekyllthemes.io;
• jekyll.tips;
• drjekyllthemes.github.io.

PS.: você pode criar Github Pages para qualquer repositório. Eu já vi até documentação do projeto, hospedado no Github Pages (pelo repositório do projeto).

Como configurar seu domínio no Github Pages

Esta etapa, eu considero uma das mais tranquilas. Você precisará apenas, configurar algumas entradas DNS no seu domínio e adicionar um arquivo no repositório.

E como fazer isso?

Saliento que, se você for utilizar uma CDN (detalharei nos próximos tópicos), você precisará alterar novamente a zona de DNS do seu domínio, isso impactará apenas em tempo de propagação do DNS.

Vamos ao que interessa, você precisará acessar as configurações das zonas de DNS do seu domínio e configurar algumas entradas, conforme abaixo:

• Entrada do tipo A: 192.30.252.153
• Entrada do tipo A: 192.30.252.154