Skip to main content

Sobre erros de criação do Jekyll para sites do GitHub Pages

Se o Jekyll encontrar um erro ao criar seu site do GitHub Pages localmente ou no GitHub AE, você receberá uma mensagem de erro com mais informações.

O GitHub Pages está disponível em repositórios internos e privados com o GitHub AE. GitHub Pages está disponível em repositórios públicos com GitHub Free e GitHub Free para organizações, e em repositórios públicos e privados com GitHub Pro, GitHub Team, GitHub Enterprise Cloud e GitHub Enterprise Server.

Sobre erros de criação do Jekyll

Às vezes, GitHub Pages não tentará criar seu site depois que você efetuar push das alterações à fonte de publicação do seu site.

  • Você está fazendo push com uma chave de implantação. Se desejar automatizar pushes para o repositório do seu site, você poderá configurar um usuário de máquina. Para obter mais informações, confira "Como gerenciar chaves de implantação".
  • Você está usando um serviço de CI que não está configurado para criar sua fonte de publicação. Por exemplo, o Travis CI não compilará o branch gh-pages a menos que você adicione o branch a uma lista segura. Para obter mais informações, confira "Como personalizar o build" no Travis CI ou na documentação do serviço de CI.

Observação: poderá levar até dez minutos para que as alterações no seu site sejam publicadas depois que você efetuar push das alterações para o GitHub AE.

Se o Jekyll não tentar criar seu site e encontrar um erro, você receberá uma mensagem de erro de criação. Existem dois tipos principais de mensagens de erro de compilação do Jekyll.

  • Uma mensagem "Page build warning" significa que sua criação foi concluída com êxito, mas talvez você precise fazer alterações para evitar problemas futuros.
  • Uma mensagem "Page build failed" significa que sua criação falhou ao ser concluída. Se for possível para o Jekyll detectar um motivo para a falha, você verá uma mensagem de erro descritiva.

Para obter mais informações sobre como solucionar problemas de erros de build, confira "Solução de problemas de erros de build do Jekyll em sites do GitHub Pages".

Visualizando as falhas de criação de seu repositório em GitHub AE

Você pode ver falhas de build (mas não avisos de build) para seu site no GitHub AE na guia Configurações do repositório do site.

Visualizando as mensagens de erro de criação do Jekyll localmente

É recomendável testar o site no local, o que permite ver mensagens de erro de criação na linha de comando e solucionar qualquer falha de criação antes de fazer push das alterações no GitHub AE. Para obter mais informações, confira "Como testar seu site do GitHub Pages localmente com o Jekyll".

Visualizando mensagens de erro de criação do Jekyll no seu pull request

Quando você criar uma solicitação de pull para atualizar sua fonte de publicação em GitHub AE, você poderá ver mensagens de erro de build na guia Verificações da solicitação de pull. Para obter mais informações, confira "Sobre as verificações de status".

Visualizando os erros de criação do Jekyll por e-mail

Quando você efetuar push das alterações para sua fonte de publicação em GitHub AE, GitHub Pages tentará criar seu site. Se a criação falhar, você receberá um e-mail no seu endereço de e-mail principal.

You will only receive an email if outbound email support is enabled on your enterprise. For more information, contact your site administrator.

Visualizando as mensagens de erro do Jekyll no seu pull request com um serviço de CI de terceiros

Você pode configurar um serviço de terceiros, como o Travis CI, para ver as mensagens de erro após cada commit.

  1. Caso ainda não tenha feito isso, adicione um arquivo chamado Gemfile na raiz da fonte de publicação, com o seguinte conteúdo:

    source `https://rubygems.org`
    gem `github-pages`
    
  2. Configure o repositório do site para o serviço de teste de sua escolha. Por exemplo, para usar o Travis CI, adicione um arquivo chamado .travis.yml na raiz da fonte de publicação, com o seguinte conteúdo:

    language: ruby
    rvm:
      - 2.3
    script: "bundle exec jekyll build"
    
  3. Talvez você precise ativar o repositório com o serviço de teste de terceiros. Para obter mais informações, consulte a documentação do seu serviço de teste.