Polymake jupyter tutorials

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)

Markdown cells will be converted with pypandoc. Code source and output in text format are put in a code frame. Output svgs are extracted
Extracts all attached media from and replaces the links

Use nbconvert preprocessor to run all cells and create the output beforehand? Add preamble with a link to the ipynb file. Add 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, however, images should be base64 attached (we might want to change this with a seperate folder for each tutorial?). This can be easily done with drag&drop.

roblems with pypandoc, which converts ipynb markdown to dokuwiki markdown: 1. enumerations? 2.

After conversion the caption “Polymake logo” will be displayed as a tooltip in dokuwiki.

> application 'polytope';
> # we might need to 
> # reconfigure("common::svg.rules");
> # one svg output
> svg(cube(3)->HASSE_DIAGRAM->VISUAL);
> print "SVG output above";

SVG output above
> # 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;