Usage

MaTiSSe.py is NOT WYSISWYG rather it is a command line tool.

For printing the main help message jut type:

MaTiSSe.py -h

This will echo:

usage: MaTiSSe.py [-h] [-v] [-i INPUT] [-o OUTPUT] [-hs STYLE.CSS]
                  [--toc-at-sec-beginning TOC-DEPTH]
                  [--toc-at-subsec-beginning TOC-DEPTH] [--print-preamble]
                  [--print-css] [--print-options] [--print-highlight-styles]
                  [--verbose] [--indented] [--online-MathJax]

MaTiSSe.py, Markdown To Impressive Scientific Slides

optional arguments:
  -h, --help            show this help message and exit
  -v, --version         Show version
  -i INPUT, --input INPUT
                        Input file name of markdown source to be parsed
  -o OUTPUT, --output OUTPUT
                        Output directory name containing the presentation
                        files
  -hs STYLE.CSS, --highlight-style STYLE.CSS
                        Select the highlight.js style (default github.css);
                        select "disable" to disable highligth.js
  --toc-at-sec-beginning TOC-DEPTH
                        Insert Table of Contents at each section beginning
                        (default no): to activate indicate the TOC depth
  --toc-at-subsec-beginning TOC-DEPTH
                        Insert Table of Contents at each subsection beginning
                        (default no): to activate indicate the TOC depth
  --print-preamble      Print the preamble data as parsed from source
  --print-css           Print the css as parsed from source (if done)
  --print-options       Print the available options for each presentation
                        element
  --print-highlight-styles
                        Print the available highlight.js style (default
                        github.css)
  --verbose             More verbose printing messages (default no)
  --indented            Indent html output file (default no, may corrupt slide
                        rendering)
  --online-MathJax      Use online rendering of LaTeX equations by means of
                        online MathJax service; default use offline, local
                        copy of MathJax engine

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.

The command line arguments should be auto-explicative. The most complex step is to understand how to write a presentation by means of the MaTiSSe.py flavored markdown syntax.

Getting Started	MaTiSSe.py flavored markdown syntax	Themes, themes over and over again
Getting-Started	MaTiSSe.py flavored markdown syntax	Theming: defining the presentation theme