Hyde para Jekyll: o guia prático que eu gostaria de ter encontrado quando comecei
Hyde é um dos temas mais usados para Jekyll, e a razão é simples: ele é leve, não tenta fazer mil coisas ao mesmo tempo e funciona. A maioria dos tutoriais que você vê na internet começa explicando quem era Robert Louis Stevenson e qual a diferença entre Henry Jekyll e Edward Hyde. Isso é interessante para uma aula de literatura, mas não ajuda ninguém a montar um site. O que importa é que Hyde é um tema Jekyll com layout limpo, suporte a listas de posts e páginas estáticas, e vem com algumas opções de cor pré-configuradas.
Instalação básica do hyde jekyll and hyde
A instalação começa com o Jekyll instalado no seu sistema. Se você está no macOS, `brew install jekyll` resolve. No Linux, depende da distro, mas geralmente `sudo apt-get install jekyll` funciona, desde que você tenha as dependências de Ruby configuradas corretamente. O Ruby precisa estar na versão 2.5 ou superior, senão você vai levar erros estranhos que não dizem nada útil. Criamos o projeto assim:
jekyll new meu-site Depois entramos na pasta e configuramos o Hyde como tema. A forma mais direta é editar o Gemfile e adicionar a linha:
gem "jekyll Hyde" No _config.yml, você define o tema:
theme: jekyll-hyde Rode bundle install e então jekyll serve. O site roda em localhost:4000. Se der erro de bundler, verifique se o Ruby está atualizado. Esse é o erro mais comum e demorei cinco horas para perceber que era apenas isso.
O que o Hyde realmente oferece
O Hyde tem dois layouts principais: o padrão com a barra lateral à esquerda e uma variação chamada "Rind", que coloca a barra lateral à direita. A configuração fica no _config.yml: Hyde: rind
👉 Clique no botão abaixo para saber mais sobre o assunto!
O tema vem com algumas cores predefinidas que você altera colocando um parâmetro no config. As opções são: black, blue, cyan, green, orange, pink, purple, red e yellow. Nada revolucionário, mas cobre o básico. O Hyde também inclui suporte a BaseURL, que é essencial se o seu site não ficar na raiz do domínio. Sem configurar isso corretamente, todos os links e assets quebram. Coloque no config:
baseurl: "/meu-projeto" Esqueci de colocar essa configuração na primeira vez que deployei e passei duas horas tentando descobrir por que as folhas de estilo não carregavam. A resposta era simplesmente esse campo vazio no config.
Personalização avançada sem perder a cabeça
Se você quer mudar algo além das cores, o Hyde não impõe muita coisa. O CSS fica em _sass/hyde/ e é possível sobrescrever diretamente no seu próprio arquivo CSS. Mas aqui vai algo que ninguém sempre explica direito: o Hyde usa PostCSS em algumas versões mais recentes com variáveis CSS customizadas. Se você tentar compilar com SASS convencional, pode receber erros sobre variáveis que não existem. A solução é usar a versão correta do pacote ou fazer override pelo styles.css do seu projeto. Um problema específico que encontrei: ao usar o Hyde com conteúdo em português e caracteres acentuados nos títulos dos posts, o Slug gerado automaticamente ficava estranho em algumas configurações de build. A solução foi adicionar ao _config.yml:
encoding: utf-8 E garantir que o arquivo do post também estivesse salvo em UTF-8. Simples, mas fácil de passar batido.
hyde jekyll and hyde: casos práticos de uso
Hyde funciona bem para blogs simples, portfólios e documentações técnicas. Ele não é ideal se você precisa de múltiplas colunas complexas, grids dinâmicos ou interatividade pesada. Para isso, existem temas mais robustos como PaperMod ou TeXt. O Hyde brilha quando você quer algo que funcione sem configuração excessiva e que gere páginas estáticas rapidamente. Um ponto importante: o Hyde não vem com sistema de comentários integrado. Você precisa adicionar algo como Disqus, Utterances ou Giscus manualmente. A integração com Giscus, por exemplo, leva cerca de dez minutos e não requer configuração de backend. Basta colar o snippet no layout adequado.
Deploy e limitações reais
Para deploy, GitHub Pages é a opção mais óbvia. O Hyde é compatível com GitHub Pages out of the box. O processo leva em média três minutos: subir o repositório, ativar Pages nas configurações e esperar a compilação. Se o build falhar, o log do GitHub Actions mostra o erro. Na minha experiência, erros de build com Hyde acontecem quase sempre por causa de plugins mal configurados ou versions incompatíveis do Jekyll no repositório. As limitações do Hyde são claras: ele não tem suporte nativo a i18n multilíngue avançado, não possui sistema de busca integrado e a personalização visual vai até certo ponto sem escrever CSS próprio. Se o seu projeto precisa de tudo isso, considere alternar para outro tema ou fazer um fork e modificar. O código do Hyde é aberto no GitHub e relativamente fácil de alterar.
O repositório oficial é Hyde/hyde no GitHub. O download é feito via Gem ou clonando o repositório, dependendo do método de instalação que você escolher. A documentação está no README do projeto, mas é curta. Se tiver dúvidas específicas, os issues do repositório costumam ter respostas de quem já passou pelo mesmo problema. No geral, Hyde é uma escolha sólida se você valoriza simplicidade. Não é o tema mais bonito que existe, mas é confiável e raramente causa dor de cabeça depois de configurado corretamente na primeira vez. E isso já é mais do que a maioria dos temas consegue oferecer.
