A LaTeX Beamer theme, forked from the metropolis theme (with dragon patches)
Go to file
xenia d23403af80 fix: improve page numbering styles and calculation
- For improved compatibility with
  [Pympress](https://github.com/Cimbali/pympress), use the recommended
  format for PDF page numbers on notes pages. This allows presentations
  built with `show notes` on (i.e., notes on every other page) to work
  out of the box. Other notes page formats and other PDF viewers are not
  impacted.
- Change page numbering defaults to `appendixpagenumber` so that
  appendix pages are restarted from the beginning. Additionally,
  progressbar calculation will only take into account the
  `mainframenumber`, which doesn't include appendix pages.
- Remove deprecated options relating to frame numbering, as I'm not sure
  whether it impacts the change in defaults above.
2025-06-09 23:23:12 -04: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 1.0.1 (#46) 2025-04-01 20:51:12 +02:00
examples chore: autoformat demo.tex 2025-04-01 16:33:49 +02:00
src fix: improve page numbering styles and calculation 2025-06-09 23:23:12 -04:00
testfiles feat: redesign itemize environment (#50) 2025-05-21 15:24:16 +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 1.0.1 (#46) 2025-04-01 20:51:12 +02:00
CHANGELOG.md chore(main): release 1.0.1 (#46) 2025-04-01 20:51:12 +02: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 1.0.1 (#46) 2025-04-01 20:51:12 +02:00
ctan_announcement.txt chore: update ctan announcement 2025-04-01 21:52:41 +02:00
flake.lock build: setup nix flake and use it for gh actions 2025-01-17 11:11:57 +01:00
flake.nix chore: remove commented parts from nix flake 2025-04-01 16:33:49 +02:00
release-please-config.json fix: add missing files for updating version tags 2025-04-01 16:45:17 +02: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!