NASA-NAVO / navo-workshop

Tutorial notebooks for how to use PyVO to access NASA and other data in Python.
https://NASA-NAVO.github.io/navo-workshop
BSD 3-Clause "New" or "Revised" License
41 stars 26 forks source link

Tell users how to handle notebooks in MyST-Markdown format #143

Closed stargaser closed 11 months ago

stargaser commented 11 months ago

Our notebooks are now in MyST-Markdown format which is likely to be new to many of our users. We should add a section to 00_SETUP.md (and perhaps also to README.md) giving instructions to users on how to open these files in Jupyterlab or in Notebook.

We should be sure to include that the jupytext package must be installed before Jupyterlab is started.

In Jupyterlab, they can right-click on a notebook in the file browser and open with Notebook or Jupytext Notebook.

To make a double-click work, in Jupyterlab they can go to Settings -> Settings Editor and then select Document Manager. On that page under Default Viewers, they can add a newKey of "markdown" and a New Value of "Jupytext Notebook". We should include an image or maybe even a short video showing the setting.