Guia de Instalação

Pré-requisitos

Sistemas Suportados

Dependências Necessárias

Ruby (>= 2.7)

1
2
3
4
5
6
7
8
9

# Ubuntu/Debian
sudo apt update
sudo apt install ruby-full build-essential zlib1g-dev

# macOS (via Homebrew)
brew install ruby

# Verificar versão
ruby --version

Bundler

1
2

gem install bundler
bundler --version

Git

1
2
3
4
5

# Ubuntu/Debian
sudo apt install git

# macOS
brew install git

Instalação do Projeto

1. Clonar Repositório

1
2

git clone https://github.com/gatilhoroxo/site-attempt.git
cd site-attempt

2. Instalar Dependências

1
2
3
4
5

# Instalar gems do Gemfile
bundle install

# Se houver erro de permissões
bundle install --path vendor/bundle

3. Primeira Execução

1
2
3
4
5
6
7
8

# Build inicial
bundle exec jekyll build

# Servidor de desenvolvimento
bundle exec jekyll serve

# Ou usando Makefile
make dev

Acesse: http://localhost:4000/site-attempt/

Resolução de Problemas Comuns

Erro: “cannot load such file – webrick”

1

bundle add webrick

Erro: “Permission denied - bind(2)”

Porta 4000 em uso:

1

bundle exec jekyll serve --port 4001

Erro: “Bundler::GemNotFound”

1
2

bundle update
bundle install

Configuração Opcional

Editor Config

Instale plugin .editorconfig no seu editor para formatação automática.

Live Reload

1
2

# Já incluído em make dev
bundle exec jekyll serve --livereload