GitHub Pages - " Your site is having problems building: Page build failed."

Viewed 36

I'm trying to troubleshoot a GitHub Pages failure. The Github Actions workflow completes successfully, and I can see that mkdocs has successfully updated the gh-pages branch. I've also confirmed that I can run mkdocs serve locally with a successful build.

After the workflow completes, I can go into the repository settings, into the GitHub Pages tab, and see the "Your site is having problems building: Page build failed." error, but no further context on what is causing it to fail.

Another interesting note, if I create a gh-pages-test branch from the gh-pages branch and then change the source value to the new test branch, I get a successful deployment. I can then switch back to the regular branch and it will also deploy successfully. If I run the GitHub Action workflow again though, the action succeeds but the page build fails.

This was working fine up until a week or two ago, but I'm not seeing any new changes in our code base that would have caused this. Is there any way to get more information on why it is failing?

0 Answers
Related