Skip to content

Migrating tutorials to website todo #57

Open

Description

@jni

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.

Activity

  1. stefanv commented on Jun 2, 2021

    @stefanv
    Member

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

  2. rossbar commented on Jun 2, 2021

    @rossbar
    Contributor

    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!

  3. jni commented on Jun 2, 2021

    @jni
    MemberAuthor

    for those who are not comfortable with sphinx

    🙋‍♂️!

    😝

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions