O Jekyll tem uma funcionalidade integrada de auto-regeneração que reconstrói o seu site quando observa mudanças no código-fonte. Desde a versão 2.4.0 do Jekyll, o comando jekyll serve
tem essa funcionalidade habilitada por padrão e você pode utilizar jekyll build --watch
para habilitá-la manualmente.
No Windows, você precisa instalar uma ferramenta extra, ou gem, para habilitar essa funcionalidade. Simplesmente execute o comando a seguir na linha de comando.
gem install wdm
Gemfile
Como alternativa, se você utiliza um Gemfile
, pode verificar se o Jekyll está sendo executado no Windows e somente nessa ocasião instalar a gem wdm.
gem 'wdm', '~> 0.1.0' if Gem.win_platform?
O Jekyll requer a gem listen como dependência para a auto-regeneração. Algumas versões da listen não funcionam no Windows. Essa página tem mais informações sobre versões que funcionaram no Windows no passado. Você pode verificar na tabela de versões quais versões da listen foram testadas durante a elaboração deste guia.
Se você tentar executar jekyll build --watch
ou jekyll serve
e o diretório de saída já existir, às vezes o Jekyll falha durante a compilação do site. Se você se deparar com esse problema, você pode contorná-lo adicionando --force_polling
ao final do seu comando para o Jekyll. Veja as discussões aqui e aqui para mais informações.
Às vezes, a auto-regeneração do Jekyll não funciona de forma alguma. Essa página sugere que ela não funciona em sistemas de 32 bits e não há solução conhecida. Desde a versão 2.4.0 do Jekyll, se o seu sistema é afetado por esse problema, você precisa manualmente desabilitar a funcionalidade de auto-regeneração quando desejar que o Jekyll sirva seu site executando jekyll serve --no-watch
.
Respire fundo! Você já instalou tudo que precisa para executar o Jekyll no Windows. Há ainda alguns detalhes aos quais você precisa se atentar para se certificar de que seus sites sejam compilados bem e sem complicações. Clique no botão abaixo para continuar.