Jupyter notebook tutorial making a site code#
With this outline, we move on to write our tutorial using Markdown while interlining code snippets in between-Jupyter has native support for Markdown snippets. These are the clearly-defined steps for our example: With the story at hand, we can embark into the tutorial writing. find out who John is, how he gets his artworks mixed up, sort through the mess to find actual art) John is a math artist who creates artwork out of scatter plots)ĭefine the steps of your story exploration (e.g. List your objectives (e.g., fetch data from Contentful, render plain text, render HTML, show some graphs)ĭescribe the resources required for each your objectives (e.g., a Contentful space, simple textual data, an image, labeled Cartesian coordinates)įind a theme that can link everything together (e.g. So, here’s a list of steps necessary to devising your own interactive tutorial: I've already given you a glimpse into the story of our mad math artist John Doe, a creator of graph art who has been sloppy in how he’s saved and catalogued everything.īut the interesting part is the process of coming up with a compelling story to guide you through a tutorial. Normally, another content type like Artwork, should be defined and used to group Scatter Data entries. With the Scatter Data content type, for which each entry is a point in an X/Y cartesian axis, we can define the works of art for John. With the Person content type, we can define the biography of an artist, which we would use for displaying content from simple text to a generated HTML view of their bio. Within the example space in Contentful, I then create two content types: Person and Scatter Data that would be used in the building of a solution to his problems: The story begins with an artist named John Doe, who has some math-based art, and we as art enthusiasts want to take a look at his art. With this objective in mind, I set up an example space in Contentful to facilitate my storytelling for the tutorial. All this was doable by Jupyter, and I only had to do some additional coding to use the templating engine we wanted for each of our languages–this extra bit of code is included in the tutorials. Setting up a story for the Jupyter notebook tutorialįor our case, we want to be able to write and run snippets for a tutorial, have some Markdown to explain each step, and then display rendered HTML and graphs. BinderHub allows us to configure our repository with a Dockerfile, which specifies all the dependencies for every language we require, while also enabling deployment using MyBinder, a BinderHub cloud solution for users to consume the tutorial. Fortunately, a project called BinderHub, a Docker-based JupyterHub executing environment (a Jupyter notebook multi-user interface), solves that. One tool definitely came to my mind for achieving creating interactive tutorials - Jupyter Notebooks, an interactive coding platform mainly for Python but with support for other language engines, which supports data visualizations and in-browser code editing and execution.Ī main challenge is hosting the Jupyter notebook so users are able to modify and run existing code.
0 kommentar(er)
