skimage-tutorials icon indicating copy to clipboard operation
skimage-tutorials copied to clipboard

Migrating tutorials to website todo

Open jni opened this issue 3 years ago • 3 comments

We now have the tutorials up at

https://scikit-image.org/skimage-tutorials/

To do:

  • [ ] use myst or a plain .py format supported by jupytext rather than nb as source. This just involves conversion of source files using nbconvert. Jupyter book should take care of the rest (But, see reference).
  • [ ] add more tutorials to the full list. This is done by moving them from lectures/not_yet_booked/ to lectures, updating _toc.yml, and ensuring that they build (no errors).
  • [ ] Rename the repo to just tutorials so that the URL is scikit-image.org/tutorials
  • [ ] (bigger) integrate with main site: look/theme, links from top navigation bar, etc.

jni avatar Jun 02 '21 00:06 jni

Very nice! @rossbar what pipeline did you use for NumPy / networkx?

stefanv avatar Jun 02 '21 01:06 stefanv

what pipeline did you use for NumPy / networkx?

The tutorials sites for both NumPy and NetworkX use sphinx + the myst_nb extension directly rather than Jupyterbook. AIUI, jupyterbook is just a thin wrapper around the other executablebook tools (executablebooks/meta#285), giving a more user-friendly way of defining the _toc and _config for those who are not comfortable with sphinx. myst-nb + jupytext (for converting to myst text-based notebook format) should provide everything you need, but Jupyterbook is fine too - whether you prefer sphinx-style or jb-style config/organization is an individual preference!

rossbar avatar Jun 02 '21 08:06 rossbar

for those who are not comfortable with sphinx

🙋‍♂️!

😝

jni avatar Jun 02 '21 08:06 jni