metropolis_theme/README.md

Beamer mtheme

The mtheme is a Beamer theme with minimal visual. The core design principles of the theme were described in a blog post. Not convinced? Have a look at the demo slides.

Installation

To install the theme either run make install or copy the style files ending with .sty to the source files of your presentation. As of now, fonts, colors and the section indicator are hardcoded into the theme. For the demo you need

• XeLaTeX,
• the Fira Sans and Mono font and
• TikZ.

Depending on the Linux distribution, the packaged name of Fira Sans might be Fira Sans OT instead of Fira Sans. In that case, you may have to edit beamerfontthememetropolis.sty. You may also need to install Fira Sans; see the contrib/ directory for more

Usage

To build the demo slides just run make in the top-level directory. To use this theme with Pandoc-based presentations, you can run the following command

$ pandoc -t beamer --latex-engine=xelatex -V theme:m -o output.pdf input.md

Customization

Package options

The usetitleprogressbar option adds a thin progress bar similar to the section progress bar underneath each frame title

In order to use \cite, \ref and similar commands in a frame title you have to protect the title. This can be done automatically with the protectframetitle option.

The blockbg option defines extra colors used in defining the blocks. The blocks then have a gray background similar to other beamer themes.

By default, this package adds \vspace{2em} after the frametitle to make content more centered on the frame. If using more content per slide, this can be turned off at the package-level by passing the nooffset option.

With option nosectionslide, no dedicated slide is produced when a new section starts. By default when using the \section command, a slide is created with just the title on it.

The nosmallcapitals option supresses the usage of small capitals on title page, frame titles and dedicated section slides.

Option usetotalslideindicator creates slide numbering in lower right corner in following format: #current/#total. By default, just current page number is printed.

Commands

The \plain{title=[]}{body} command sets a slide in plain dark colors which can be useful to focus attentation on a single image.

pgfplot styles

The beamer theme also contains pre-defined pgfplot styles. Use the mlineplot key to plot line data and mbarplot or horizontal mbarplot to plot bar charts.

License

The theme itself is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License. This means that if you change the theme and re-distribute it, you must retain the copyright notice header and license it under the same CC-BY-SA license. This does not affect the presentation that you create with the theme.