Novo blog - Agora usando Hexo com NodeJS e deploy no GitHub Pages

Abrindo o primeiro post do blog venho falar um pouco sobre como este blog funciona e como é o meu processo de publicação, a blog engine utilizada e o host.

Premissas utilizadas para escolher esta blog engine

• Open Source
• Generators para facilitar a minha vida ao criar posts e gerenciá-lo
• Markdown como linguagem de marcação para os posts
• Boa variedade de templates prontos e customizáveis
• Deploy automatizado com um único comando, de preferência ;)
• Hospedagem gratuita

Hospedagem gratuita

Para hospedagem do blog estou utilizando o GitHub Pages. Basta criar um repositório pessoal no GitHub e toda vez que for efetuado um push para o repositório ele irá atualizar automaticamente. Muito utilizado para criar a área de documentação dos projetos no GitHub essa area foi a escolhida para “hospedar” o blog.

Blog Engine

Escolhi o Hexo como blog framework.

O Hexo é um projeto desenvolvido em NodeJS, rodando em todas as plataformas muito facilmente, possuindo uma configuração extremamente simples. Pensei em utilizar diretamente o Jekyll mas o Hexo me chamou bastante atenção e foi uma boa escolha, atendendo a todas as premissas que mencionei e possui boa documentação.

Possui suporte à Markdown e também possui diversos generators.
Senti falta de template melhores, muitos templates ruins e grande parte dos exemplos estão bem pobres, além de muitos deles estarem em japonês o que dificulta o uso de sua documentação. Em pensação, a instalação dos templates é bem simples e posso alterar facilmente se precisar.

Criando o Blog

1
2
3
4
5

npm install hexo -g
hexo init blog
cd blog
npm install
hexo server

Criando uma postagem

1

hexo new Olá Mundo!

Rodando um servidor local para visualizar

1

hexo server

Basta acessar pelo navegador o endereço http://localhost:4000/

Deploy das postagens

Para configurar o deploy basta aplicar as informações no arquivo _config.yml, conforme exemplo abaixo.

1
2
3
4
5
6
7

# Deployment
## Docs: http://hexo.io/docs/deployment.html
deploy:
  type: github
  repo: git@github.com:lazarofl/lazarofl.github.io.git
  branch: master
  message:

O Hexo suporta deploy no:

• GitHub Pages
• Heroku
• Rsync
• OpenShift DIY Cartridge
• Git

Além de possuir Batch Deploy o que irá ajudá-lo caso precise publicar em mais servidores. Veja mais detalhes em Hexo Deployment.

Depois de aplicada as informações no arquivo de configuração basta executar o comando

1

hexo deploy

#####Dicas

• Com o comando hexo generate você pode compilar o blog, copiar a pasta public e subir via FTP para o seu servidor
• Com o comando hexo clean você limpa a base de dados gerada automaticamente, isso resolve problemas de duplicação de postagens que possa ocorrer

Bom pessoal, é isso, agora é só postar conteúdo.
Até mais