Como Instalar o Gerador de Sites Estáticos Jekyll no Ubuntu 22.04

Jekyll é um gerador de arquivos estáticos gratuito e de código aberto escrito em Ruby. É um sistema de gerenciamento de conteúdo simples e fácil de usar, utilizado para criar um site em minutos. Ele pega texto escrito na sua linguagem de marcação favorita e usa layouts para criar um site estático. Você pode usar os recursos integrados do Jekyll para ajustar a aparência do site, URLs, os dados exibidos na página e muito mais. Ele oferece uma tonelada de recursos, como links permanentes, categorias, páginas, postagens, layouts personalizados e muitos mais.

Neste tutorial, vamos mostrar como instalar o Jekyll CMS no Ubuntu 22.04.

Pré-requisitos

Um servidor rodando Ubuntu 22.04.
Uma senha de root configurada no seu servidor.

Começando

Antes de começar, é recomendado atualizar seu sistema com a versão estável mais recente. Você pode atualizá-lo com o seguinte comando:

apt update -y  
apt upgrade -y

Uma vez que seu sistema esteja atualizado, instale outras dependências necessárias executando o seguinte comando:

apt install make build-essential curl git tree -y

Uma vez que todas as dependências estejam instaladas, você pode prosseguir para o próximo passo.

Instalar Ruby

Jekyll é escrito em Ruby, então você precisará instalá-lo em seu sistema. Por padrão, o pacote Ruby está incluído no repositório padrão do Ubuntu.

Execute o seguinte comando para instalar o Ruby:

apt install ruby ruby-dev -y

Uma vez que a instalação esteja completa, você precisará informar ao gerenciador de pacotes gem do Ruby para colocar os gems na pasta home do nosso usuário.

Você pode fazer isso editando o arquivo ~/.bashrc:

nano ~/.bashrc

Adicione as seguintes linhas ao final do arquivo:

export GEM_HOME=$HOME/gems
export PATH=$HOME/gems/bin:$PATH

Salve e feche o arquivo, então ative a variável de ambiente com o seguinte comando:

source ~/.bashrc

Em seguida, você pode instalar o Jekyll e o bundler usando o comando gem conforme mostrado abaixo:

gem install jekyll bundler

Uma vez que a instalação esteja completa, você pode prosseguir para o próximo passo.

Criar um Novo Site com Jekyll

Neste ponto, o Jekyll está instalado em seu sistema. Agora, execute o seguinte comando para criar um novo site chamado jekyll.example.com:

jekyll new jekyll.example.com

Uma vez que o site é criado, você deve obter a seguinte saída:

  Bundler: Using jekyll 4.2.2
  Bundler: Fetching jekyll-seo-tag 2.8.0
  Bundler: Fetching jekyll-feed 0.16.0
  Bundler: Installing jekyll-feed 0.16.0
  Bundler: Installing jekyll-seo-tag 2.8.0
  Bundler: Fetching minima 2.5.1
  Bundler: Installing minima 2.5.1
  Bundler: Bundle complete! 7 Gemfile dependencies, 31 gems now installed.
  Bundler: Use `bundle info [gemname]` to see where a bundled gem is installed.Don't run Bundler as root. Bundler can ask for sudo if it is needed, and
  Bundler: installing your bundle as root will break this application for all non-root
  Bundler: users on this machine.
Novo site jekyll instalado em /root/jekyll.example.com.

Em seguida, você lista todos os arquivos e diretórios criados pelo Jekyll com o seguinte comando:

tree jekyll.example.com

Você deve obter a seguinte saída:

jekyll.example.com
??? 404.html
??? about.markdown
??? _config.yml
??? Gemfile
??? Gemfile.lock
??? index.markdown
??? _posts
    ??? 2022-09-25-welcome-to-jekyll.markdown

1 directory, 7 files

Iniciar o Servidor Jekyll

Primeiro, navegue até o diretório do site e adicione a dependência webrick usando o seguinte comando:

cd jekyll.example.com  
bundle add webrick

Em seguida, inicie o servidor web Jekyll executando o seguinte comando:

jekyll serve --host=0.0.0.0

Uma vez que o servidor inicie com sucesso, você deve obter a seguinte saída:

Configuration file: /root/jekyll.example.com/_config.yml
            Source: /root/jekyll.example.com
       Destination: /root/jekyll.example.com/_site
 Incremental build: disabled. Enable with --incremental
      Generating... 
       Jekyll Feed: Generating feed for posts
                    done in 0.375 seconds.
 Auto-regeneration: enabled for '/root/jekyll.example.com'
    Server address: http://0.0.0.0:4000/
  Server running... press ctrl-c to stop.

Acessar o Site Jekyll

Neste ponto, o Jekyll está iniciado e ouvindo na porta 4000. Agora, abra seu navegador e digite a URL http://your-server-ip:4000. Você será redirecionado para a página padrão do Jekyll:

Jekyll

Conclusão

No guia acima, você aprendeu como instalar o Jekyll no Ubuntu 22.04. Agora você pode explorar o Jekyll e criar seu próprio site usando o conteúdo gerado automaticamente.