A LaTeX Beamer theme, forked from the metropolis theme (with dragon patches)
Go to file
Johan Larsson a6abea0b02
chore: autoformat demo.tex
2025-04-01 16:33:49 +02:00
.github/workflows ci: fix name of wrapper 2025-01-17 13:43:33 +01:00
assets chore: convert fonts in screenshot to paths 2024-10-30 14:07:35 +01:00
doc chore(main): release 0.6.0 (#34) 2025-01-17 17:00:09 +01:00
examples chore: autoformat demo.tex 2025-04-01 16:33:49 +02:00
src feat: support `\thanks` in title page (#45) 2025-04-01 16:33:37 +02:00
testfiles feat: support `\thanks` in title page (#45) 2025-04-01 16:33:37 +02:00
.envrc build: setup nix flake and use it for gh actions 2025-01-17 11:11:57 +01:00
.gitignore docs: add rendered demo to repository 2025-02-25 10:04:14 +01:00
.release-please-manifest.json chore(main): release 0.6.0 (#34) 2025-01-17 17:00:09 +01:00
CHANGELOG.md chore(main): release 0.6.0 (#34) 2025-01-17 17:00:09 +01:00
LICENSE chore: add a license file 2024-01-09 21:02:26 +01:00
README.md docs: fix demo link in README.md (#40) 2025-03-03 21:04:35 +01:00
build.lua chore(main): release 0.6.0 (#34) 2025-01-17 17:00:09 +01:00
ctan_announcement.txt chore: update ctan announcement 2025-01-17 17:15:42 +01:00
flake.lock build: setup nix flake and use it for gh actions 2025-01-17 11:11:57 +01:00
flake.nix build: use l3build wrapper 2025-01-17 13:40:13 +01:00
release-please-config.json chore: make next feature version stable (1.0.0) 2024-03-12 11:01:11 +01:00

README.md

Moloch

CTAN CI

Moloch is a simple Beamer theme suitable for anyone to use. It is a fork of the Metropolis Theme.

The fork was created for the following reasons:

  • To fix some outstanding issues that had not been addressed for a long time.
  • To remove some of the more opinionated design choices, such as special handling of the Fira family of fonts.
  • To strip away some features that added complexity to the code base without achieving valuable functionality for the majority of users, such as special code block designs and the pgfplots theme.

Here's a blog post in which I introduce the theme and write in more detail about the changes with respect to Metropolis. Also see the demo for a quick introduction to the theme.

Do not expect this theme to be backwards compatible with the Metropolis theme.

Screenshot

Installation

Moloch is on CTAN, so you can install it using your favorite LaTeX package manager. For example, with tlmgr:

tlmgr install moloch

You can also install the theme from source, in which case you need a working LaTeX installation with l3build installed. Then just follow these steps:

git clone https://github.com/jolars/moloch.git
cd moloch
l3build install

Usage

The following code shows a minimal example of a Beamer presentation using Moloch.

\documentclass{beamer}
\usetheme{moloch}
\title{A minimal example}
\date{\today}
\author{Johan Larsson}
\institute{Centre for Modern Beamer Themes}
\begin{document}
  \maketitle
  \section{First Section}
  \begin{frame}{First Frame}
    Hello, world!
  \end{frame}
\end{document}

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.

Contributing

Contributions are welcome, but we are generally not interested in changes that can be easily added through the standard Beamer interface.

Also, when writing commit messages, please use the conventional commits format.

Versioning

The project uses semantic versioning.

Acknowledgments

Almost all of moloch is a result of Mathias Vogelgesang's (@matze) hard work on the metropolis theme (of which moloch is a fork).

Thanks to @samcarter for the logo!