Executando localmente seu próprio site al-folio

Este post faz parte de uma série de posts que explicam como configurar seu próprio site baseado no tema al-folio e adicionar suporte a uma segunda língua:

• Executando localmente seu próprio site al-folio
• Tornando seu al-folio em um site com dois idiomas
• Criando páginas de CV traduzidas
• Criando páginas de projetos traduzidas
• Criando postagens de blog traduzidas

Decidi escrever este post porque tive dificuldade em descobrir como executar minha própria página Jekyll localmente, principalmente porque eu não uso regularmente o Jekyll. Espero que este post ajude você a executar seu próprio site al-folio localmente, ou qualquer outro tema baseado em Jekyll que você tenha.

Instalando Ruby e rbenv

Meu código foi executado em um ambiente Linux nativo (Ubuntu 22.04.1 LTS), mas também testei em um ambiente WSL . Primeiro você precisa instalar o suporte à linguagem Ruby. A maneira recomendada pelos criadores do al-folio é usar rbenv. Para aqueles familiarizados com Python, rbenv é semelhante ao pyenv. Para instalar o rbenv, execute os seguintes comandos:

git clone https://github.com/rbenv/rbenv.git ~/.rbenv
cd ~/.rbenv && src/configure && make -C src

Isso fará o download e compilação do repositório rbenv no seu home. NÃO instale via apt, pois ele baixa uma versão mais antiga do pacote e não permite que você instale as versões mais recentes do Ruby. Em seguida, adicione as seguintes linhas ao seu arquivo ~/.bashrc:

# habilita o rbenv
if [ -d "$HOME/.rbenv/" ]; then
    export PATH="$HOME/.rbenv/bin:$PATH"
    eval "$(rbenv init - bash)"
fi

Reinicie seu terminal ou execute . ~/.bashrc para recarregar suas configurações do bash. Isso tornará o comando rbenv disponível no terminal. Para testar se está funcionando corretamente, execute curl -fsSL https://github.com/rbenv/rbenv-installer/raw/main/bin/rbenv-doctor | bash. Ele deve produzir algo semelhante a isso:

Checking for `rbenv' in PATH: /home/gca/.rbenv/bin/rbenv
Checking for rbenv shims in PATH: Not found
Checking `rbenv install' support: /home/gca/.rbenv/plugins/ruby-build/bin/rbenv-install (ruby-build 20220910.1-10-gecb9d22)
Counting installed Ruby versions: 1 versions
Auditing installed plugins: OK

Vai aparecer um erro na linha Checking for rbenv shims in PATH. Não se preocupe, isso vai ser corrigido. Em seguida, você precisa instalar o ruby-build como um plugin do rbenv, para que você possa facilmente baixar e instalar diferentes versões do Ruby. Para isso, execute os seguintes comandos:

mkdir -p "$(rbenv root)"/plugins
git clone https://github.com/rbenv/ruby-build.git "$(rbenv root)"/plugins/ruby-build

Para verificar quais versões do Ruby estão disponíveis para instalação, basta executar rbenv install --list. Você pode instalar qualquer versão que desejar, mas recomendo instalar a versão estável mais recente. No momento é a versão 3.1.2. Para instalá-la, você precisa primeiro instalar a dependência ssl e depois a versão do Ruby.

sudo apt install -y libssl-dev
rbenv install 3.1.2

Instalando as dependências do al-folio

Agora que você tem o Ruby instalado, você pode instalar as dependências do al-folio. Primeiro, clone o repositório al-folio em sua máquina local. Em seguida, entre no diretório do repositório e crie um ambiente Ruby local com a versão do Ruby instalada. Em seguida, instale o pacote bundle, para que ele se encarregue de instalar o restante das dependências. Para fazer tudo isso, execute os seguintes comandos:

git clone ~/git@github.com:alshedivat/al-folio.git
cd ~/al-folio
rbenv local 3.1.2
gem install bundle
bundle install

Também é necessário instalar o pacote jupyter, já que o al-folio suporta jupyter notebooks. Se você não planeja usar notebooks com tanta frequência, pode instalar via pipx. Para instalar o pipx e o jupyter, execute os seguintes comandos:

# também é possível instalar via apt com o comando `sudo apt install -y pipx`
python3 -m pip install --user pipx
pipx install jupyter

Executando o al-folio localmente

Agora você pode executar o site localmente. Tudo o que você precisa fazer é abrir o diretório do al-folio e executar o Jekyll:

bundle exec jekyll serve --lsi

Boa programação!