Quando migramos nosso blog do Wordpress para o GitHub Pages, escrevi um email para nossos autores com instruções resumidas para configurar e postar com Octopress/Jekyll. Percebi que dando um tapa nesse email, poderia publicá-lo aqui no blog como um guia rápido e talvez incentivar outros blogueiros a fazer o mesmo.

Por que GitHub Pages?

Corte de custos! Manter o blog no Wordpress requer um hosting, um banco de dados e um domínio. Reduzimos as despesas apenas para o registro de domínio (por enquanto).

Performance! GitHub Pages é estático, e conteúdo estático é servido naturalmente mais rápido.

Desafio! Estavamos “acostumados” ao Wordpress. Aprender Jekyll e a postar “commitando em um projeto” permite que tenhamos novas idéias, ou no pior dos casos, aprendamos novas tecnologias.

Requisitos

Para utilizar o GitHub Pages, crie um repositório com o nome usuariogithub.github.io, incluindo o “github.io”. O GitHub gerencia este repositório e publica o conteúdo estático no endereço http://usuariogithub.github.io

Agora, para gerar o conteúdo estático vamos usar o Octopress.

Instalação

Basta clonar o repositório do Octopress localmente:

1

$ git clone git@github.com:imathis/octopress.git

instalar as gems necessárias e em seguida rodar a rake para configuração:

1

$ rake setup_github_pages

e informar o seu repositório do GitHub Pages:

git@github.com:username/username.github.io.git

Pronto! Os remoting points do projeto serão configurados para seu repositório do GitHub, como segue:

1
2
3
4
5
6

$ git remote -v

octopress git@github.com:imathis/octopress.git (fetch)
octopress git@github.com:imathis/octopress.git (push)
origin     git@github.com:username/username.github.io.git (fetch)
origin     git@github.com:username/username.github.io.git (push)

Postando

Para criar um novo post, basta rodar a rake:

1

$ rake new_post["o titulo do seu post"]

o que vai criar o arquivo source/_posts/2013-09-17-o-titulo-do-seu-post.markdown. Escreva o conteúdo do seu post normalmente em Markdown (recomendo utilizar o Markup Editor) e execute:

1

$ rake generate

para gerar o site estático no diretório _deploy. Caso queira dar um preview no que será publicado, basta rodar:

1

$ rake preview

e acessar no browser http://localhost:4000.

Publicando

Quando terminar seu post, basta rodar:

1

$ rake deploy

para publicar o site no seu repositório do GitHub Pages.

Pronto! Não se esqueça de subir os fontes do site (branch source), commitando suas alterações e executando o classico git push.

Migrando

Caso já tenha um site publicado no Wordpress, você pode seguir este guia para importar todo o conteúdo na estrutura do Jekyll:

How to Migrate from WordPress to Jekyll Running on Github

Referências

• GitHub Pages
• Octopress.org
• Jekyll