migration to myst / JB2

• migration to myst / JB2
  • execution of code cells
    • ipywidgets
  • nbautoeval (won't work in a static site anyway, unless re-written to use browser-embedded python)
  • static stuff
  • slug-ed URLs
  • corrections
  • custom themes
  • favicons
  • badges
  • styling
  • itables

mostly all repos have moved to jb2 as of now

<style> .todo { background-color: #ffdddd; border-left: 6px solid #f44336; margin-bottom: 15px; padding: 10px 15px; } </style>

course	orga	tool	comment	URL	self hosted
intro	ue12-p25	astro + starlight	done	https://intro.info-mines.paris/
numerique	ue12-p25	jb2	done	https://numerique.info-mines.paris/
numerique-exos	flotpython	jb2	done	https://numerique-exos.info-mines.paris/
slides	flotpython	jb2	done no PDF	https://python.info-mines.paris/
python-exos	flotpython	jb2	done	https://python-exos.info-mines.paris/	yes
git	ue12-p25	jb2	done	https://git.info-mines.paris/
frontend	ue22-p25	jb2	done	https://frontend.info-mines.paris/	yes
backend	ue22-p25	jb2	done	https://backend.info-mines.paris/
backend-fastapi-notes	ue22-p25	next + codehike	done	https://backend-fastapi-notes.info-mines.paris/
backend-flask-chatapp	ue22-p25	next + codehike	done	https://backend-flask-chatapp.info-mines.paris/
jupyterlab-examples	flotpython	jb2	done	https://jupyterlab-examples.info-mines.paris/	yes
MOOC (course)	flotpython	jb2	done	https://mooc-python.info-mines.paris/	yes

let's summarize the pain points

execution of code cells

• we now know how to embed a jupyterlite instance in the page; not clear however how to take advantage of that

• issue to open about thebe buttons that behave real odd

ipywidgets

related to the above; with a jlite kernel on board one can produce interactive widgets; but that seems to exclude a build-time execution ?

nbautoeval (won't work in a static site anyway, unless re-written to use browser-embedded python)

• interactive visualizations (this being said it was already not working under jb1)

static stuff

this is a problem for - at least - embedded HTML pages like folium-generated maps; see

jupyter-book/mystmd#189 (comment)

other relevant entries

• jupyter-book/mystmd#1921
  and more specifically jupyter-book/mystmd#1921 (comment)
• jupyter-book/mystmd#1196
• jupyter-book/mystmd#2597

slug-ed URLs

corrections

• there remains an issue with hidden content being searchable; see
  
• currently the trick for teachers to display corrections is relying on tampermonkey on an individual basis
  using our custom theme could be the way to go do make it more widely available

custom themes

for a new scheme to expose built-in themes as GH releases

• 
• 

favicons

used a workaround which is to use .ico files instead of .svg

badges

are evaluated at build-time, not at read time

styling

we have a common style_jb2.css that takes care of most details; might need some further adjustments one day but good enough for now

• styling
  • lists
  • cells
    • outline output cells
    • outline input cells (blue is like untyped admonitions...)
  • outline inline code
  • pandas dataframes
    • are not centered; not exactly serious either
    • hovering used to outline the whole row, now just the first cell in the row

itables

not quite sure where we are there, we may need to add a recipe notebook in here to assess the situation