mirror of https://github.com/matze/mtheme.git
243 lines
10 KiB
TeX
243 lines
10 KiB
TeX
%%
|
||
%% This is file `mtheme.sty',
|
||
%%
|
||
%% Copyright (C) 2015 by Matthias Vogelgesang <matthias.vogelgesang@gmail.com>
|
||
%% ---------------------------------------------------------------------------
|
||
%% Licensed under CC-BY-SA 4.0 International.
|
||
%%
|
||
%% The initial template comes from the HSRM beamer theme by Benjamin Weiss,
|
||
%% which you can find at https://github.com/benjamin-weiss/hsrmbeamertheme.
|
||
%% ---------------------------------------------------------------------------
|
||
%%
|
||
|
||
\documentclass{ltxdoc}
|
||
\EnableCrossrefs
|
||
\CodelineIndex
|
||
\RecordChanges
|
||
%\OnlyDescription
|
||
|
||
\usepackage{setspace}
|
||
\onehalfspacing
|
||
|
||
\usepackage{fontspec}
|
||
\setmainfont[BoldItalicFont={Fira Sans Italic},%
|
||
ItalicFont={Fira Sans Light Italic},%
|
||
BoldFont={Fira Sans}]{Fira Sans Light}
|
||
\setmonofont{Fira Mono}
|
||
\defaultfontfeatures{Ligatures=TeX}
|
||
|
||
\usepackage{enumitem}
|
||
\setlist[itemize]{noitemsep}
|
||
\setlist[enumerate]{noitemsep}
|
||
|
||
\usepackage{xcolor}
|
||
\definecolor{mDarkBrown}{HTML}{604c38}
|
||
\definecolor{mDarkTeal}{HTML}{23373b}
|
||
\definecolor{mLightBrown}{HTML}{EB811B}
|
||
\definecolor{mLightGreen}{HTML}{14B03D}
|
||
\definecolor{mBackground}{HTML}{FFFFFF}
|
||
|
||
\usepackage{listings}
|
||
\lstset{%
|
||
language=[LaTeX]{TeX},
|
||
basicstyle=\ttfamily,
|
||
keywordstyle=\color{mLightBrown}\bfseries,
|
||
commentstyle=\color{mLightGreen},
|
||
stringstyle=\color{mLightGreen},
|
||
backgroundcolor=\color{mBackground},
|
||
numbers=none,
|
||
numberstyle=\tiny\ttfamily,
|
||
stepnumber=2,
|
||
showspaces=false,
|
||
showstringspaces=false,
|
||
showtabs=false,
|
||
frame=none,
|
||
framerule=1pt,
|
||
tabsize=2,
|
||
rulesep=5em,
|
||
captionpos=b,
|
||
breaklines=true,
|
||
breakatwhitespace=false,
|
||
framexleftmargin=0em,
|
||
framexrightmargin=0em,
|
||
xleftmargin=0em,
|
||
xrightmargin=0em,
|
||
aboveskip=1em,
|
||
belowskip=1em,
|
||
morekeywords={usetheme,institute,maketitle,mthemetitleformat,plain,setbeamercolor},
|
||
}
|
||
\lstMakeShortInline|
|
||
|
||
\usepackage[colorlinks=true,
|
||
linkcolor=mLightBrown,
|
||
menucolor=mLightBrown,
|
||
pagecolor=mLightBrown,
|
||
urlcolor=mLightBrown]{hyperref}
|
||
|
||
\GetFileInfo{beamerthemem.dtx}
|
||
\title{Modern Beamer Presentations\\with the\\\textsc{mtheme} package}
|
||
\author{Matthias Vogelgesang \\ \url{matthias.vogelgesang@gmail.com}}
|
||
\date{\fileversion~from \filedate}
|
||
|
||
\begin{document}
|
||
|
||
\maketitle
|
||
|
||
\section{Introduction}
|
||
Beamer is an awesome way to make presentations with LaTeX. But the stock themes do not necessarily look particularly nice and the custom themes often scream “Beamer” at first sight. The goal of \textsc{mtheme} is to provide a modern Beamer theme with minimal visual noise. It provides section slides with a neat progress bar and
|
||
It is intended to be used with \href{https://www.mozilla.org/en-US/styleguide/products/firefox-os/typeface/}{Fira Sans}, a gorgeous typeface commissioned by Mozilla and designed by \href{http://www.carrois.com/fira-3-1/}{Carrois}. Hence to get the best results you should have installed the Fira typeface and use XeTeX to typeset your slides. Nevertheless this is no hard dependency. The theme also works fine with pdfTeX and the Computer Modern typeface.
|
||
|
||
The codebase is maintained on \href{https://github.com/matze/mtheme}{GitHub}. So if you have issues, find mistakes in the manual or want to contribute – to make the theme even better – get in touch there.
|
||
|
||
\section{Getting Started}
|
||
\subsection{Installation}
|
||
% The easiest way to install the \textsc{mtheme} is via your \TeX distribution’s package manager. If not or you want to access the latest version you can also download the theme on GitHub.
|
||
% \begin{lstlisting}
|
||
% git clone https://github.com/matze/mtheme.git
|
||
% \end{lstlisting}
|
||
The \textsc{mtheme} uses Make as build system. Hence the installation is very straight forward. Simply type
|
||
\begin{lstlisting}
|
||
$ make
|
||
$ make install
|
||
\end{lstlisting}
|
||
in the top directory and all the files will be created and installed on your computer. The complete list of make rules is as follows:
|
||
|
||
\begin{description}
|
||
\item[all] \hfill \\
|
||
Build the theme, the manual and the demo presentation.
|
||
\item[install] \hfill \\
|
||
Install the theme into your local texmf folder.
|
||
\item[uninstall] \hfill \\
|
||
Remove the theme from your local texmf folder.
|
||
\item[sty] \hfill \\
|
||
Build the manual.
|
||
\item[manual] \hfill \\
|
||
Build the manual.
|
||
\item[demo] \hfill \\
|
||
Build the demo presentation.
|
||
\item[ctan] \hfill \\
|
||
Create a package for CTAN distribution.
|
||
\end{description}
|
||
|
||
\subsection{Dependencies}
|
||
|
||
\begin{itemize}
|
||
\item XeLaTeX
|
||
\item \href{https://github.com/mozilla/Fira}{Fira Sans} and Mono font
|
||
\item TikZ
|
||
\end{itemize}
|
||
|
||
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.dtx|. You may also need to install Fira Sans; see the |contrib/| directory for more. Users of Debian or Ubuntu can also install this \href{https://launchpad.net/\%7Eedd/+archive/ubuntu/misc/+files/latex-mtheme_0.1.0vidid1_all.deb}{.deb package} containing the theme files as well as the Fira Sans font files.
|
||
|
||
\subsection{Pandoc}
|
||
|
||
To use this theme with \href{http://johnmacfarlane.net/pandoc/}{Pandoc}-based presentations, you can run the following command
|
||
|
||
\begin{lstlisting}
|
||
$ pandoc -t beamer --latex-engine=xelatex -V theme:m -o output.pdf input.md
|
||
\end{lstlisting}
|
||
|
||
\subsection{A Minimal Example}
|
||
|
||
To get started with the theme is very simple. The following code shows a minimal example of a Beamer presentation using the \textsc{mtheme}.
|
||
|
||
\begin{lstlisting}
|
||
\documentclass[10pt]{beamer}
|
||
\usetheme{m} % load mtheme
|
||
\title{A modern beamer theme} % define title
|
||
\date{\today} % define date
|
||
\author{Matthias Vogelgesang} % define author
|
||
\institute{Institute} % define institute
|
||
\begin{document}
|
||
\maketitle % create titlepage
|
||
\section{First Section} % create section
|
||
\begin{frame}{First Frame} % first frame
|
||
Lorem ipsum dolor sit amet, ...
|
||
\end{frame}
|
||
\begin{frame}{Second Frame} % second frame
|
||
Lorem ipsum dolor sit amet, ...
|
||
\end{frame}
|
||
\end{document}
|
||
\end{lstlisting}
|
||
|
||
\section{Customization}
|
||
\subsection{Package options}
|
||
The theme provides a number of options. To use any of the options below, call them when invoking \textsc{mtheme} in the preamble of the slides, i.e.
|
||
\begin{lstlisting}[numbers=none]
|
||
\usetheme[<options>]{m}
|
||
\end{lstlisting}
|
||
|
||
\begin{description}
|
||
\item[usetitleprogressbar] \hfill \\
|
||
Adds a thin progress bar similar to the section progress bar underneath each frame title.
|
||
\item[protectframetitle] \hfill \\
|
||
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 this option.
|
||
\item[blockbg] \hfill \\
|
||
Adds background color to the blocks similar to other beamer themes.
|
||
\item[nooffset] \hfill \\
|
||
By default, the \textsc{mtheme} adds |\vspace{2em}| after the frametitle to center content vertically on the frame. This option removes this additional space in order to get more content per slide.
|
||
\item[nosectionslide] \hfill \\
|
||
By default when using the |\section| command, a slide is created with just the title and the progress bar on it. This option prevents the creation of these additional slides.
|
||
\item[usetotalslideindicator] \hfill \\
|
||
By default, only the current page number is printed in the lower right corner. This option changes the slide numbering format to |#current/#total|.
|
||
\item[noslidenumbers] \hfill \\
|
||
Omits slide numbers entirely.
|
||
\item[darkcolors] \hfill \\
|
||
Makes the background dark and the foreground light.
|
||
\end{description}
|
||
|
||
\subsection{Color Customization}
|
||
|
||
The included metropolis color theme is used by default, but its colors can be easily changed to suit your tastes. All of the theme's styles are defined in terms of three beamer colors:
|
||
\begin{itemize}
|
||
\item |normal text| (dark fg, light bg)
|
||
\item |alerted text| (colored fg, should be visible against dark or light)
|
||
\item |example text| (colored fg, should be visible against dark or light)
|
||
\end{itemize}
|
||
An easy way to customize the theme is to redefine these colors using
|
||
|
||
\begin{lstlisting}[numbers=none]
|
||
\setbeamercolor{ ... }{ fg= ... , bg= ... }
|
||
\end{lstlisting}
|
||
in your preamble. For greater customization, you can redefine any of the other colors in |beamercolorthememetropolis|, including progress bar.
|
||
|
||
\subsection{Title Formatting}
|
||
The main title, section titles, and frame titles are all formatted according to the custom command |\mthemetitleformat|. By default, this is equivalent to |\scshape| and sets the titles in small capitals, but you can change it in your preamble. For example:
|
||
|
||
\begin{lstlisting}
|
||
% no small capitals
|
||
\renewcommand{\mthemetitleformat}{}
|
||
% all small capitals
|
||
\renewcommand{\mthemetitleformat}{\scshape\MakeLowercase}
|
||
% all capitals
|
||
\renewcommand{\mthemetitleformat}{\MakeUppercase}
|
||
\end{lstlisting}
|
||
|
||
Note that |\MakeLowercase| and |\MakeUppercase| can have unexpected behaviour in math mode, are disabled when |protectframetitle| is used, and cause crashes when an unprotected frametitle appears on a slide with |allowframebreaks|.
|
||
|
||
\subsection{Commands}
|
||
|
||
The |\plain{title=[]}{<body>}| command sets a slide in plain dark colors which can be useful to focus attention on a single sentence or image.
|
||
|
||
\subsection{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.
|
||
|
||
\section{Known Issues}
|
||
|
||
\section{Changelog}
|
||
|
||
\section{License}
|
||
|
||
The theme itself is licensed under a \href{http://creativecommons.org/licenses/by-sa/4.0/}{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.
|
||
|
||
\section{Contributors}
|
||
For a full list of contributors please visit the \href{https://github.com/matze/mtheme/graphs/contributors}{GitHub Repository}.
|
||
|
||
\section{Implementation}
|
||
\DocInput{beamerthemem.dtx}
|
||
\DocInput{beamerfontthememetropolis.dtx}
|
||
\DocInput{beamercolorthememetropolis.dtx}
|
||
|
||
\end{document}
|