Jekyll – Um gerador de sites estáticos em Ruby

O Jekyll é um gerador de sites estáticos em Ruby, originalmente criado por Tom Preston-Werner (também conhecido como mojombo) do Github, e foi pensado para ser usado em blogs, mas pode ser configurado para gerar qualquer tipo de site estático. (Observação: O Jekyll foi criado há mais ou menos um ano - Tom escreveu um artigo sobre ele em Novembro do ano passado, peço desculpas a quem já o conhece, mas só o descobri recentemente!)

Como ele gera a estrutura do site de maneira estática, você pode hospedá-lo em qualquer lugar onde possa servir HTML estático, usando seu servidor web predileto, (por exemplo, Apache). Como Tom descreve no seu artigo, a idéia veio porque ele queria "blogar como um hacker". O Jekyll permite que você escreva usando seu editor de texto predileto e publique através da linha de comando. Ao utilizar ferramentas bem conhecidas reduzimos os problemas de adaptação que temos no processo de escrever um blog, permitindo que nos concentremos em escrever, e mesmo um servidor web fraco pode aguentar muitos acessos quando está servindo apenas páginas estáticas.

Por padrão, o Jekyll usa uma variação própria de templates Liquid, e usa o pygments para fazer syntax highlighting, e você pode utilizar textile ou markdown para o conteúdo. Cada template de artigo do Jekyll precisa ter um header contendo alguns metadados sobre ele, como o layout utilizado, seu título e algumas informações customizadas que você pode querer adicionar, como por exemplo tags.

Gerar seu site é fácil: basta executar o comando jekyll no diretório onde estão seus templates para ele transformá-lo num website completo, pronto para ser publicado. Existe um servidor do Jekyll que você pode usar para fazer testes, basta passar --auto como argumento para que ele gere novamente o site quando você fizer mudanças.

jekyll --server --auto

O Github Pages é uma opção legal para publicar seus sites criados com o Jekyll. Na verdade, cada página do Github é processada pelo Jekyll quando você atualiza as páginas do seu repositório.

O jeito mais fácil para utilizá-lo é instalando a gem (que está no disponível no Gemcutter), e dando uma olhada no wiki no Github, onde você também encontrará a documentação.

sudo gem install jekyll

Como era de se esperar, o blog pessoal do Tom Preson-Werner's roda com Jekyll. Seu código-fonte está disponível no Github.

Este artigo foi publicado originalmente em inglês em 25 de November de 2009 às 10:00 na categoria Bibliotecas. Você pode deixar um comentário ou um trackback do seu próprio site.