Skip to main content

Preprocessor to generate LaTeX/beamer files

Project description

beamer_gen

Preprocessor to generate LaTeX-beamer code from a more compact language.

The needs for a new sub language were:

  • compactness: so as to remove type as few formatting informations as possible,
  • expressiveness: allow to format most beamer frames with clear and short syntax,
  • flexibility: allowance for LaTeX without to much overhead.

In TeX environments, are enclosed into \begin{env} and \end{env} tags which makes it unambiguous but requires duplicating the name of the environment. Here, for compactness, the choice is made instead to use indentation as environment markers. Indentation is therefore significant and compulsory.

Features

beamer_gen code has shortcuts for the following current LaTeX/beamer features:

  • sections, using s Section title,
  • frames, using + Frame title,
  • blocks, using b Block title,
  • items, using - item text with automatic environment creation,
  • columns, using c{ratio} (ratio relative to \columnwidth) with automatic environment creation,
  • figures, using f{ratio}{filename} (ratio relative to \columnwidth).

Beamer overlay directives (<...>) are supported for frames, blocks, figures and items. Frames can also have options ([...]), in which case, they must be specified after an optional beamer directive (+<+->[fragile] Title for instance). Columns can also have a placement option (e.g. [c]), which needs to be specified before the size.

Everything else is reproduced verbatim.

Usage

Usage is straightforward:

usage: beamer_gen.py [-h] filename [filename ...]

Generate LaTeX/beamer files from a stub.

positional arguments:
  filename    name of the file to be processed.

optional arguments:
  -h, --help  show this help message and exit

Each file is processed by creating a new file with the original extension replaced by .tex.

Example

The following source:

+[allowframebreaks] Example 1
    b<+-> Example block
        - first item
            - subitem
            - other subitem
        - second item
    b<+-> second block
        c{0.4}
            f<3->{0.8}{figure1.png}
        c[t]{0.6}
            Some generic text:
            - and items

translates into:

\begin{frame}[allowframebreaks]
    \frametitle{Example 1}
    \begin{block}<+->{Example block}
        \begin{itemize}
            \item first item
                \begin{itemize}
                    \item subitem
                    \item other subitem
                \end{itemize}
            \item second item
        \end{itemize}
    \end{block}
    \begin{block}<+->{second block}
        \begin{columns}
            \column{0.4\columnwidth}
            \includegraphics<3->[width=0.8\columnwidth]{figure1.png}
            \column[t]{0.6\columnwidth}
            Some generic text:
            \begin{itemize}
                \item and items
            \end{itemize}
        \end{columns}
    \end{block}
\end{frame}

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for beamer-gen, version 1.2.0
Filename, size File type Python version Upload date Hashes
Filename, size beamer_gen-1.2.0-py3-none-any.whl (5.6 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size beamer_gen-1.2.0.tar.gz (4.5 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page