fastai / fastpages

An easy to use blogging platform, with enhanced support for Jupyter Notebooks.
https://fastpages.fast.ai/
Apache License 2.0
3.53k stars 756 forks source link

Problem rendering notebooks even with gh pages working fine #641

Closed REsteche closed 2 years ago

REsteche commented 2 years ago

Required Prerequisites for filing a bug

You must follow ALL the steps in the [troubleshooting guide]

(https://github.com/fastai/fastpages/blob/master/_fastpages_docs/TROUBLESHOOTING.md). Not doing so may result in automatic closure of the issue.

Required information

  1. Steps to reproduce the problem
  2. A link to the notebook or markdown file where the error is occurring
  3. If the error is happening in GitHub Actions, a link to the specific error along with how you are able to reproduce this error. You must provide this in addition to the link to the notebook or markdown file.
  4. A screenshot / dump of relevant logs or error messages you are receiving from your local development environment. Instructions of running a local development server is provided in the [development guide] > (https://github.com/fastai/fastpages/blob/master/_fastpages_docs/DEVELOPMENT.md).

Proceeding by parts in order to better elaborate the problem that is happening with my repository:

  1. Even adjusting all the front matter according to the tutorial, only the first notebook I added on the _notebooks page appears on my blog, all the others don't appear.

image

I tried to access the actions tab of the repository in search of an error in the construction of the page, however when accessing it apparently everything is being built as expected:

image

  1. If I'm making some weird mistake, my repository can be accessed through the following link:

https://github.com/REsteche/REsteche_blog

and the specific noteeboks page via:

https://github.com/REsteche/REsteche_blog/tree/master/_notebooks

github-actions[bot] commented 2 years ago

Thank you for opening an issue. If this issue is related to a bug, please follow the steps and provide the information outlined in the Troubleshooting Guide. Failure to follow these instructions may result in automatic closing of this issue.

REsteche commented 2 years ago

Once again, I'm grateful in advance for any help; and I apologize if the error is due to some lack of attention or bad behavior on my part.

PS.: Just in order to clarify, I've already checked several other issues related to causes similar to what is happening here and I still haven't been able to get a solution. Some cases that I thought could be causing my problem were:

My first idea was to look for errors related to Front Matter formatting as in:

But even if I copy paste the Front Matter of the tutorial and push it with no changes i still end up with the same problem :(

Also look for errors related to my repository configuration, or from the home page as in:

But again, even when I follow all the setup configuration step by step and get all GI and gh pages green, the posts don't show up on my blog. I really have no idea where the problem came from at this point...

REsteche commented 2 years ago

I have updates to give!

Unfortunately they just make the situation weirder for me 😅

If I copy + paste a page from fastai repo I can make it appear on the screen - however if I change a single letter from Front Matter, lets say in its title, it just disappears from the blog as before.

If I copy the body of one of my repositories and post it with Front Matter from a post from fastai, the post appears on the blog normally:

image

PS.: this was valid for last night only; this morning when i woke up, I checked the blog site and this post was already gone.

but I find the following screen when I click on it :

image

I don't know if it's a problem with my notebooks itself that is causing this behavior... I'm using simple notebooks generating through Jupyter in the anaconda system. (and I'm still super confused)

REsteche commented 2 years ago

Conclusion

Well, after hours of documentation and lines of HTML read, I found that the problem was the format and extension of the images that were inside my notebooks. If eventually someone finds themselves in a similar and apparently inexplicable situation, I can show you what I did to get the blog to work naturally again, just get in touch,