jupyter-book: Mysterious 404 error with github pages
Good morning!
I’m encountering a bizarre 404 error when trying to host a jupyter-book with gh-pages. I’m a jekyll newbie, but have really enjoyed the jupyter-book tool!
-
(I believe) I’ve disabled the problematic
jekyll-scholarplugin & related -
gh-pages assures me that
Your site is published at https://chanzuckerberg.github.io/image-analysis-course/with no reported errors -
As expected, the site is redirecting from
https://chanzuckerberg.github.io/index.htmltohttps://chanzuckerberg.github.io/image-analysis-workshop/intro/about -
The html for
intro/about.htmlis being built correctly: https://github.com/chanzuckerberg/image-analysis-course/blob/master/_build/intro/about.html
Have you encountered this before? Would super appreciate being pointed in the right direction. Hopefully it’s user error (easiest to fix!).
About this issue
- Original URL
- State: closed
- Created 5 years ago
- Comments: 17 (8 by maintainers)
Hey @choldgraf –
Thanks for your patience, we were off using jupyter-book in a workshop! It went swimmingly, and folks super appreciated the documentation format & binder integration.
I took a look through the docs, and they’re generally great. I noticed a few things you might consider:
1 - It wasn’t clear to me that the
--demobook wasn’t compatible with ghpages, and it was tricky to figure out which / how to remove packages to fix it.2 - As someone who’s never used jekyll before, it wasn’t clear to me what the relationship was between
_siteand_build(and that I needed to manually find and remove the demo content from_siteto work).3 - I think you’ve got a couple of dead links on this page (starting with
See the guide...)I had deleted the entire repo locally, so I just re-cloned from master, rebuilt, and pushed again with
ghp-importand now it’s working fine! It’s possible I hadn’t pushed the latest build previously. Thanks for your help though!