Would need help to set up a mystmd project

[parmentelat]

Hiya blokes

I am a teacher and have many courses written in Jupyter notebooks and markdown, and for that reason I ended up using mystmd to produce course materials

I know how to publish on GH Pages (see below for details); I am currently trying to host the same content on vercel, as per mystmd’s documentation here

Deploying your MyST Site - MyST Markdown

mystmd is not among the supported frameworks; fair enough !
however I have tried to manually fill the various build settings
the build seems to trigger allright
but I am consistently ending up with a 404 page that I don’t know how to solve..

I could use some help to get this right thanks in advance

---

here are my current build settings

---

for reference:

here is the toy project currently published on GH Pages, and that I use as a test for this move:

the GH repo is here GitHub - flotpython/jupyterlab-examples

and the resulting site on Pages is here

introduction - jlab-examples

the recipe to publish this onto GH pages is

.github/workflows/myst-to-pages.yml

[system]

There’s another community post with 404 debugging tips that might be helpful. Please give these solutions a try and let us know how it goes.

Debugging 404 Errors

Sometimes things don’t go as expected when deploying a website. If you see a 404 on your site, that means the page or resource couldn’t be found. There are many possible causes, and the absence of something can be tricky debug if you don’t know where to look. Here are some things you can do to find the cause and fix it. Debugging Tips Check the error code If you see a mostly white screen with 404: NOT_FOUND along with a Code and and ID then you can click the blue info box below the error deta…

A human should be around soon to offer more advice. But you can also get helpful information quickly by asking v0.