Você vai precisar instalar algumas coisas antes de começar:

  1. NodeJS
  2. Hexo
1
$ npm install -g hexo

Você pode instalar globalmente com o argumento -g, mas se tiver alguma experiência pode colocar o pacote em seu package.json e depois dar um npm install no diretório do blog.

Criando a sua GitHub page

O GitHub disponibiliza um serviço de hospedagens para sites estáticos aqui: GitHub Pages.

Crie um novo repositório com o nome nesse formato: seuusername.github.io

Atenção: O formato deve seguir esse padrão, caso contrário o github não considerará seu repositório como uma página válida.

Agora, com o repositório criado, é só clonar para a sua máquina.

1
$ git clone /caminho/para/o/seu/repositório

Vamos configurar o Hexo

Dentro do diretório que você acabou de clonar para a sua máquina, dê os seguintes comandos:

1
2
$ hexo init
$ npm install

Vamos abrir o arquivo de configuração _config.yml.
Altere o valor desses quatro atributos básicos:

1
2
3
4
title: O Blog do Breno
subtitle:
author: Breno Henrique
language: pt-BR

Configurando o deploy das postagens

Para fazer com que o deploys do GitHub funcionem, sua seção #Deployment deve-se parecer com isso:

1
2
3
4
deploy:
  type: git
  repo: git@github.com:brenohq/brenohq.github.io.git
  branch: master

Agora é só instalar o deployer:

1
npm install hexo-deployer-git --save

Criando a primeira postagem

Para criar uma postagem é simples:

1
hexo new "Post de Teste"

Pronto, você criou a primeira postagem. Agora vamos editá-la:
Dentro do diretório /source foi criado um arquivo .md com a sua postagem.

1
2
3
4
5
---
title: Post Teste
date: 2016-07-03 13:58:33
tags:
---

Esse é seu post, você pode escrevê-lo como quiser, utilizando diversos recursos disponibilizados na documentação completa do Hexo.

Realizando o primeiro deploy

Com a postagem editada, basta dar os seguintes comandos e seu blog vai estar atualizado.

1
2
$ hexo generate
$ hexo deploy

Pronto, agora seu blog está atualizado e online!

Links Úteis:
GitHub Pages
Documentação do Hexo
Documentação do NodeJS

Sobre o autor:
www.brenohq.com