This extension to Sphinx adds a Builder for the Beamer LaTeX class.
The extension is distributed through the Python Package Index and installed with
pip install sphinxcontrib-beamer
Load the extension in the Sphinx project configuration file conf.py
:
extensions = ['sphinxcontrib.beamer']
and build your Beamer LaTeX output using the new builder:
sphinx-build -b beamer build/doctrees . build
Some variables are configurable in conf.py
:
Theming: Change the theme used by Beamer (defaults to Warsaw
) with:
beamer_theme = <string>
where beamertheme<string>.sty
is a LaTeX style file in the
templates_path
path specified in conf.py
.
Frame breaks: Change if frame breaks are allowed (defaults to True) with:
beamer_allowframebreaks = <True or False>
which sets the allowframebreaks
option to all frames. This Beamer feature
splits a frame environment into multiple slides if the content extends beyond
what can be viewed on one slide.
Custom frame options: Add custom frame options with
Frame Title ----------- .. frame_options:plain Frame content.
which will generate a frame environment
\begin{frame}[plain]{Frame Title} Frame content. \end{frame}
plain
in the example above can be replaced with any comma-separated string
of valid frame options.
This extension is still in its beta stage and has not been thorougly tested. Use it with caution.