Skip to main content
Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais recentes, acesse a documentação em inglês. Se houver problemas com a tradução desta página, entre em contato conosco.

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, você receberá uma mensagem de erro com mais informações.

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. Para obter mais informações, consulte os "produtos do GitHub".

Sobre erros de criação do Jekyll

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

  • A pessoa que fez push das alterações não verificou o endereço de e-mail dela. Para obter mais informações, consulte "Verificar o endereço de e-mail".
  • 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, consulte "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, Travis CI não criará o branch gh-pages, a menos que você adicione o branch a uma lista segura. Para obter mais informações, consulte "Personalizar a criação" em Travis CI ou na documentação do seu serviço de CI.

Observação: podem ser necessários até 20 minutos para que as alterações no site sejam publicadas após o push delas no GitHub.

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 informações sobre como solucionar problemas de erros de criação, consulte Solução de problemas de erros de criação do Jekyll para sites do GitHub Pages".

Visualizando as mensagens de erro de criação do Jekyll com GitHub Actions

Por padrão, seu site de GitHub Pages foi criado e implantado com a execução de um fluxo de trabalho de GitHub Actions, a menos que você tenha configurado seu site do GitHub Pages para usar uma ferramenta de CI diferente. Para encontrar possíveis erros de criação, verifique a execução do fluxo de trabalho para o seu site do GitHub Pages, revisando a execução do fluxo de trabalho do seu repositório. Para obter mais informações, consulte "Visualizar histórico de execução de fluxo de trabalho". Para obter mais informações sobre como executar novamente o fluxo de trabalho em caso de erro, consulte "Executar novamente fluxos de trabalho e trabalhos".

Note: GitHub Actions workflow runs for your GitHub Pages sites are in public beta for public repositories and subject to change. GitHub Actions workflow runs are free for public repositories.

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

É possível ver falhas de criação (mas não os avisos de criação) para seu site no GitHub, na guia Settings (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. Para obter mais informações, consulte "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ê cria uma pull request para atualizar a fonte de publicação no GitHub, é possível ver mensagens de erro de criação na guia Checks (Verificações) da pull request. Para obter mais informações, consulte "Sobre verificações de status".

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

Quando você fizer push das alterações na fonte de publicação no GitHub, o GitHub Pages tentará criar seu site. Se a criação falhar, você receberá um e-mail no seu endereço de e-mail principal. Você também receberá e-mails para avisos de criação.

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 exibir mensagens de erro após cada commit.

  1. Se você ainda não tiver, adicione um arquivo chamado Gemfile na raiz da sua 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 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.