capixaba.dev

Preparando o ambiente no Fedora para trabalhar com o Jekyll usando o asdf

Pra quem ainda não conhece, o Jekyll é uma ferramenta escrita em Ruby para geração de sites e blogs estáticos. Ele faz o build do HTML basedo em templates do Liquid e em arquivos markdown. Nesse post, veremos como preparar o ambiente na distribução Linux Fedora para começar trabalhar com Jekyll.

Primeiro passo

Será necessário instalar algumas dependências de ferramentas de desenvolvimento. O gerenciador de pacotes do Fedora (DNF) possui um recurso que agrupa diversas dependências comuns de desenvolvimento, para instalar basta rodar o seguinte comando:

sudo dnf groupinstall "Development Tools"
sudo dnf groupinstall "Development Tools"

Pelo fato do Jekyll ter sido desenvolvido com a linguagem Ruby, precisaremos instalar o Ruby na máquina para conseguirmos executar o Jekyll e desenvolver nossos sites. Para que a instalação do Ruby ocorra com sucesso precisamos de mais duas dependẽncias de desenvolvimento:

sudo dnf install openssl-devel readline-devel
sudo dnf install openssl-devel readline-devel

asdf

asdf é uma ferramenta de linha de comando que permite o gerenciamento de várias versões de runtime de diversas linguagens de programação. Essa ferramenta irá nos ajudar instalar e gerenciar as versões do Ruby.

Instalação

A instalação é bem simples, basicamente um git clone:

git clone https://github.com/asdf-vm/asdf.git ~/.asdf
cd ~/.asdf
git checkout "$(git describe --abbrev=0 --tags)"
git clone https://github.com/asdf-vm/asdf.git ~/.asdf
cd ~/.asdf
git checkout "$(git describe --abbrev=0 --tags)"

Em seguida precisamos adicionar duas instruções no nosso ~/.bashrc para que o asdf seja carregado na inicialização do nosso shell:

. $HOME/.asdf/asdf.sh
. $HOME/.asdf/completions/asdf.bash
. $HOME/.asdf/asdf.sh
. $HOME/.asdf/completions/asdf.bash

Ruby

Feito tudo isso, partimos para uma das últimas etapas da preparação do nosso ambiente, que é a instalação do Ruby e finalmente a instalação do Jekyll.

Para gerenciarmos as versões do Ruby através do asdf, precisamos adicionar um plugin no asdf que ficará responsável pela linguagem.

Instalando o plugin do ruby no asdf:

asdf plugin-add ruby
asdf plugin-add ruby

Agora, podemos instalar uma versão do Ruby utilizando o asdf, executando o seguinte comando:

asdf install ruby 2.7.2
asdf install ruby 2.7.2

Obs.: como dito anteriormente, com o asdf é possível gerenciar diversas versões de runtime, nesse exemplo foi instalada a versão 2.7.2 do Ruby. O Jekyll tem como requisito uma versão maior ou igual a versão 2.4.0 do Ruby.

Tendo uma versão do Ruby instalada, precisamos "setar" ela no ambiente para começar usar. É possivel também definir em qual escopo ela será setada, no exemplo abaixo configuramos de forma global:

asdf global ruby 2.7.2
asdf global ruby 2.7.2

Nesse momento, já podemos verificar a versão do Ruby:

ruby -v
ruby -v

Jekyll

E, finalmente, instalar o Jekyll e também o Bundler:

gem install jekyll bundler
gem install jekyll bundler

Extra

Para validar as nossas instalações, vamos criar um novo projeto usando o Jekyll e executar.

Crie um novo projeto com o comando jekyll new <NOME_DO_PROJETO>, pro exemplo:

jekyll new meusite
jekyll new meusite

Acesse o diretório do projeto:

cd meusite
cd meusite

Execute o servidor de desenvolvimento:

bundle exec jekyll serve
bundle exec jekyll serve

Esse comando executará um servidor de desenvolvimento que ficará acessível em: http://localhost:4000

Espero que esse tutorial tenha sido útil para facilitar a sua preparação do ambiente para trabalhar com o Jekyll. Obrigado e até a próxima.

Links