Olá pessoal, refiz meu site utilizando-me do Jekyll e GitHub Pages.

Como tive trabalho de refazer, percebi que muito dos comandos tinha esquecido, então vamos escrever manual simples para próxia vez. Inicialmente, escolhi um tema no site Jekyll Themes. Jekyll é pacote que permite você escrever em texto, usando Markdow em grande maioria, e convertendo-o para uma página estática de web. Conhecimentos de HTML, Ruby e algumas vezes Python, permitem explorar ainda mais a facilidade de escrever em texto e com 2 comandos simples transformar seu trabalho em um site da web. A maior parte dos bugs que ocorreram comigo apareceram porque utilizava Ruby como superusuário, o root, do meu computador.

  • Nunca utilize Ruby ou outro pacote para compilar no Jekyll como superusuário!

Outro detalhe é o uso de aplicações baseadas em Java. Para isto, alguns temas do Jekyll utiliza-se to Node.js. A instalação para sistemas OSX, da Apple, ou W10, da Microsoft, é extremamente straightforward. Enquanto que para Ubuntu, tive algumas dores de cabeça na hora de compilar, mas por minha culpa de não perceber que j a estava instalado. Próximo requisito é a linguagem de programação Ruby, que provavelmente já está instalada no OSX se o usuário instalou Homebrew. Problema com homebrew e Ruby no windows ou Linux é que em geral você pode instalar direto como superusuário, como dito anteriormente. Encontrei este manual em passo-a-passo para criação de ambiente Ruby no seu usuário pessoal e a configuração deste como Ruby global para uso.

Outro possível requisito é o Bundle, que gerencia as aplicações Ruby. Se você configurou Ruby como dito anteriormente, a instalação do bundle é simples:

gem install bundler

Caso esteja utilizando-se de tema pré-definido, fica simples agora. Edita-se os arquivos de Markdown, e configura o arquibo _config.yml. O site estático está pronto. Agora, para publicação, segue-se os passos do GitHub Pages.

E voilà, temos nosso site! ⤧  Next post Na reta final do doutorado