Creating a website with Jupyter Book has a different layout than JupyterLab-MyST

[sbonaretti]

Hey guys,

Thanks a lot for creating these fantastic tools! I am in the process of learning some new tools, and I have a quick question (hoping that this is the right place!)

I am creating a website for a package documentation using JupyterLab-MyST in Jupyter Notebook. I used the fantastic callouts that MyST provides and that are super cool! But when I create the website using the JupyterBook built, the callouts change their layout.

I have tried to do the manual installation of NodeJs and create the website from there, but it is a bit too complicated. This website wants to be a collaborative projects, and we need to keep the computational complexity at minimum.

My question is: Is there are way to create the website using JupyterLab-MyST using JupyterBook and keep the same layout?

Thanks a lot for all your hard work!!!
Serena

[choldgraf]

This is because Jupyter Book 1.0 uses a different document engine for MyST Markdown than what JupyterLab uses.

Jupyter Book uses Sphinx along with the MyST Markdown Parser and the Sphinx Book Theme.

JupyterLab MyST uses the new MyST document engine which will one day (soon hopefully) replace Sphinx as the main document engine of Jupyter Book. You can use mystmd on its own right now if you wish!

Some more context is in this blog post about Jupyter Book 2.0 and MyST.

[sbonaretti]

Got it! Thanks @choldgraf !!!

[rowanc1]

For compatibility you can use the "admonition" directive with a class, which takes a custom title in both cases:

https://mystmd.org/guide/admonitions

[sbonaretti]

Fantastic, it works!!! Thanks!!! :)