This is an old revision of the document!
Polymake jupyter tutorials
Creating a notebook that should end up on the Polymake website:
The goal is to automate the conversion process from ipynb markdown,code and code output to dokuwiki
What is added automatically by dokuwiki: - the table of content based on markdown titles and subtitles (TODO: how extactly)
What the ipynb2dokuwiki converter should optimally do: - use nbconvert preprocessor to run all cells and create the output beforehand? - add preamble - with a link to the ipynb file - a cd command so that the following notebook code also works in the shell?
When multiple people work on one tutorial: - it is easier to solve merge conflicts or comprehend changes when ipynbs are committed with output cells cleared and no base64 attachements yet
before merging to the master - images should be base64 attached (we might want to change this with a seperate folder for each tutorial?)
Embedded images
Code and code output
> application 'polytope'; > # we might need to > # reconfigure("common::svg.rules"); > # one svg output > svg(cube(3)->HASSE_DIAGRAM->VISUAL);
> # multiple svg outputs in a scrollable window > svg(cube(3)->HASSE_DIAGRAM->VISUAL); > svg(cube(3)->HASSE_DIAGRAM->VISUAL);
> # a threejs output > cube(3)->VISUAL;