Getting Started

As aforementioned, MaTiSSe.py is a command line tool that parses markdown (extended) sources and generates HTML presentation. How to write your markdown sources is documented in the MaTiSSe.py flavored markdown syntax section. Here some quick examples on using MaTiSSe.py are reported.

The basic usage is:

MaTiSse.py -i your_presentation.md

This command will generate a new directory (be careful: some sub-directories are re-initialized any time a compilation is performed) into which the html presentation is created. After the compilation the output path contains the file index.html that is your main presentation file. To visualize the presentation open this file your preferred browser:

chromium index.html

Note that MaTiSSe.py is tested with google Chrome browser (indeed with Chromium), but all other recent browser supporting html/css and javascripts should work.

Creating a skeleton/sample as starting point

For new users and for initializing a new presentation with a builtin-theme MaTiSSe.py can create a minimal working presentation that can be used as a skeleton/sample.

To create a new sample type

MaTiSSe.py --sample my_new_talk.md

This will create (in the current directory) a new file named my_new_talk.md and a directory name my_new_talk where the html presentation is ready to be visualized. Note that the --sample arguments need the extension.

The new created sample can be used by new users as starting point. The sample initialization can be conveniently coupled with the --theme switch in order to start a new presentation rendered with a builtin-theme. To list the available builtin-themes type

MaTiSSe.py --print-themes

This should print something like

Builtin themes
  cnr-insean

The builtin-themes collection will grow soon.

To create a new sample with a specific theme type

MaTiSSe.py --sample my_new_talk.md --theme cnr-insean

This will create also a directory named cnr-insean where the theme files are place.

For more details see

Quick and Dirty Examples	Running MaTiSSe.py	MaTiSSe.py markdown with steroids	Theming
Lightning examples	Command line options	MaTiSSe.py flavored markdown syntax	Theming: defining the presentation theme