Como Instalar Corretamente o Ruby, Bundler e Jekyll no Ubuntu Linux

Jekyll é um gerador de site estático simples.


Como Instalar Corretamente o Ruby, Bundler e Jekyll no Ubuntu Linux

Introdução

Jekyll é um gerador de site estático simples, com conhecimento de blog , para sites pessoais, de projetos ou de organização. Escrito em Ruby e foi criado por Tom Preston-Werner , co-fundador do GitHub , ele é distribuído sob a licença MIT de código aberto .

Jekyll é o mecanismo por trás das páginas do GitHub , um recurso do GitHub que permite aos usuários hospedar sites com base em seus repositórios do GitHub gratuitamente.

Instalando o RVM, Ruby e o Gem

Para instalar o Jekyll primeiramente você precisará do Ruby instalado no seu sistema, exemplo, no Ubuntu, Debian, Mint e similares, você pode usar o gerenciador de pacotes de acordo como há na documentação oficial do Ruby, inclusive para outras distribuições: https://www.ruby-lang.org/pt/documentation/installation/.

Lembrando, que da forma apresentada na documentação, ele instalará diversos pacotes extras, incluindo o rubygems-integration para o comando gem que é um gerenciador de pacotes para aplicativos escritos em Ruby(o RubyGems) e servirá também para instalarmos o Bundler, que é um gerenciador de dependências.

No entanto, o procedimento da documentação é informado para casos gerais, mas ele também sugere casos específicos: “…ou ferramentas de terceiros (rbenv e RVM).” via https://www.ruby-lang.org/pt/downloads/ . Ou seja, tanto o rbenv quanto o RVM, são formas mais adequadas para evitar “dores de cabeça” relacionadas a problemas de permissão, além de evitar problemas na configuração. As configurações do Jekyll “tem sido similar a Bolsa de Valores, mudam constantemente” , por se tratar de um aplicativo moderno e ainda está em desenvolvimento, logo, mudanças estão à todo vapor =) .

Para que as coisas fiquem mais simples para todo mundo, nesse tutorial vamos utilizar o RVM(Ruby Version Manager).

Esse procedimento é descrito em: https://rvm.io/rvm/install


  1. Primeiramente certifique-se de remover tudo que pode já estar instalado no seu sistema:

    Aplicativos que não estiverem instalados o APT irá informar que o mesmo não existe, bem como, diretórios que não existirem o rm lhe avisará da não existência, logo, não entre em pânico :O .

sudo apt remove ruby bundler jekyll --purge
rm -rf ~/.gem ~/.ruby ~/.rvm
sudo apt clean && sudo apt autoremove && sudo apt autoclean

Após isso é interessante também você ter certeza que seu sistema está atualizado com apt update && apt upgrade.

Dica extra: Você pode criar um único comando para atualizar seu sistema sempre que precisar:

echo 'alias atualizar="sudo apt update && sudo apt uograde -y && sudo apt autoremove && sudo apt autoclean && sudo apt clean"' >> ~/.bashrc
source ~/.bashrc
atualizar

  1. Agora vamos importar a chave gpg

    Lembre sempre de pegar a chave no endereço oficial(https://rvm.io/rvm/install), pois versões mais recentes podem ter a chave modificada.

gpg --keyserver hkp://pool.sks-keyservers.net --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3 7D2BAF1CF37B13E2069D6956105BD0E739499BDB

  1. E então, vamos instalar o RVM junto com o Ruby

    Install RVM stable with ruby: , segundo procedimento das linhas de código.

curl -sSL https://get.rvm.io | bash -s stable --ruby

Durante a instalação ele irá rodar o comando: sudo apt --quiet --yes update , logo, será necessário você informar sua senha de sudo. Agora é necessário esperar, pois essa parte pode demorar um pouco (ele vai instalar dependências e compilar o Ruby).


  1. Agora, adicione o RVM ao $PATH para seu usuário, adicionando a linha: source $HOME/.rvm/scripts/rvm ao seu ~/.bashrc e releia o mesmo, se quiser basta usar os dois comandos abaixo:
echo 'source $HOME/.rvm/scripts/rvm' >> ~/.bashrc
source ~/.bashrc

Depois disso, verifique se está tudo certo, consultando a versão d RVM: rvm --version . Para ver a versão dos pacotes existentes do Ruby, rode: rvm list known e para ver a versão do RubyGems, rode: gem --version.

Se tudo retornou corretamente, então estamos no caminho certo. Agora vamos ao Bundler e finalmente ao Jekyll que é nossa meta aqui.

Instalando o Bundler e o Jekyll

Bom, a partir de agora ficará tudo mais fácil. Agora vamos visitar o site do Jekyll: https://jekyllrb.com/ e já na página inicial ele já mostra o procedimento para instalar o Jekyll:

Observação, se não fizéssemos o procedimento acima com o RVM, nessa parte você iria precisa usar o sudo gem, e isso daria ainda mais dor de cabeça na hora de instalar o Jekyll via gem, então NÃO USE o sudo .

gem install bundler jekyll

Agora vamos criar um site básico e já entrar no diretório do nosso site:

jekyll new meu-site
# Aguarde ele criar todos os arquivos do site
cd meu-site

Agora vamos ver o nosso site funcionando no navegador, para isso rode o comando:

Note que o nome do aplicativo é Bundler, mas o comando é somente bundle sem a letra r no final e tudo em minúsculo.

bundle exec jekyll serve

Para ver seu site funcionando, basta ir ao endereço: http://localhost:4000 . Vai ter o tema básico do Jekyll e uma postagem também simples de Welcome to Jekyll!

Para tirar o site do ar, basta retornar ao terminal e pressionar Ctrl+C . Pode ser que ele acuse o erro de não ter encontrado o arquivo favicon.ico , mas é porque esse é um exemplo simples e ele não criou/gerou esse ícone para esse site/blog simples.

No próximo módulo vamos alterar o tema do Jekyll para o blog que criamos com Bootstrap no vídeo anterior, e dessa forma saberemos sempre como implementar nossos próprios temas HTML ou de terceiros ao Jekyll . E posteriormente como hospedar gratuitamente nosso site/blog em plataformas específicas como Gitlab, Github, Netlify e entre outras, bem como usar um domínio próprio para nosso endereço, como criar facilmente posts, estrutura do Jekyll e diversas outras dicas.

Se ainda não viu os vídeos anteriores, clique nos links abaixo:

Assista ao vídeo

Assista ao vídeo de configuração do Jekyll

Download dos arquivos:


jekyll bundler ruby desenvolvimentoweb html css javascript


Compartilhe


Nosso canal no Youtube

Inscreva-se


Marcos Oliveira

Marcos Oliveira

Desenvolvedor de software
https://github.com/terroo


Crie Aplicativos Gráficos para Linux e Windows com C++

Aprenda C++ Moderno e crie Games, Programas CLI, GUI e TUI de forma fácil.

Saiba Mais

Receba as novidades no seu e-mail!

Após cadastro e confirmação do e-mail, enviaremos semanalmente resumos e também sempre que houver novidades por aqui para que você mantenha-se atualizado!