I followed the steps in this video MakeCode for micro:bit - Creating Tutorials to create a tutorial. When I clicked RUN on the Tutorial Tool, I got this error message - “Oops, an error occurred as we were loading the tutorial”.
My internet connection was okay. I’ve tried to open using an incognito window and also tried to open using another browser. And I’ve also tried signing out from GitHub.
What could be the problem? How to check whether a tutorial is “valid”?
Appreciate some pointers to move forward. Thanks in advance.
Hmm, could you post the markdown/text of your tutorial? Our error messages unfortunately aren’t great, but usually this means something in the tutorial was formatted in a way that we couldn’t gracefully handle and the project crashes/errors out instead.
I managed to get the shared link to work after I corrected a formatting error. My mistake there.
The preview is still not working though. Still getting the same error message - “Please check your internet connection and check the tutorial is valid.”
Oh! Your tutorial loads for me! Try it in an incognito browser window, or refresh your entire page and load the tutorial again? Sometimes the embedded editor can get into a bad state–basically the same as if the page crashed.
@jwunderl is anyone else having problems loading tutorials in micro:bit 4.0.9? Kid Spark Education is putting our entire curriculum in the MakeCode tutorials, and I’d like to feel confident that it’s stable.
I’ve been having lots of issues with tutorials today. Even the default example in the tutorial tool will not load, but it does load for the other targets.
Also is there a way to use images in tutorials that are stored in the github repo of the tutorial author?
/docs/static in the documentation is for pxt-microbit/docs/static
Other authors have used their own web server outside of the github tutorial repo as a workaround, but it would be nice is the images could be stored in the same repo as the tutorial md file.
I haven’t personally attempted using an image in an external tutorial in a while so I can’t confirm immediately, but if loading in an image from external site currently works then they can just be stored in the repo itself; all the files on github get stored under githubusercontent e.g. https://raw.githubusercontent.com/microsoft/pxt-microbit/master/docs/static/v2/back.jpg
and going to the link (it has a different one by default that redirects, either should be fine: https://github.com/microsoft/pxt-microbit/blob/master/docs/static/v2/back.jpg?raw=true)
Hm, we haven’t had many reports of tutorial instability (the same tutorial sometimes loading and not loading), if you have specific tutorials where you’ve been seeing this behavior it would be great if you could link the markdown files. Additionally, if you have what browser it was being loaded on that would be super helpful!
@shakao it’s mainly been around loading the tutorial. Once it loads, I usually don’t have any problems.
I noticed a new problem tonight that sometimes my embedded text for ||advanced:Advanced|| and ||serial:Serial|| don’t show in the correct color. Yet, they show correctly in the side-panel preview.
Do you have a link to the tutorial files where you’re seeing the issue? We can take a look! “Advanced” won’t be colored correctly since it’s an expanding drawer and not a “real” toolbox category–this is probably a feature we should add, I’ll make a note of it.
@shakao There doesn’t seem to be any consistency to the loading problems…sometimes they load, somethings they don’t. But it could also be local cache and some of the revision changes during the beta updates (see post 8364).
Now that 2021 is released, the only load problem has been the tutorial without the code snippets discussed above.
We haven’t pushed these to classrooms yet, so it’s only been internal testing. We also plan to submit these for approval in the event you want to approve them now
I am using version 4.0.11 of microbit makecode and version 7.0.8 of makecode. I am getting that ‘oops’ error message when trying to run the sample program in the tutorial builder. This is my first time working with it.