jinjatex 0.2

A wrapper to easily use Jinja2 for tex-templates.

A wrapper of Jinja2 for easy rendering of .tex files of all sorts.

Installation

pip install jinjatex

Usage

The main Jinjatex class provides wrappers to compile tex templates with jinja. Tex is not included, so make sure the binaries are available.

Template Syntax

The jinja template syntax is changed a little to not interference with latex commands:

((( This is a variable )))
((= This is a comment. =))
((* This is a block *))

((= Example =))
((* for value in somelist *))
    ((( value )))
((* endfor *))

Python Bindings

from jinjatex import Jinjatex

from textwrap import dedent

# Example 1: Compile string templates

template_string = dedent(r"""
    % Example Template
    \documentclass{article}

    \begin{document}
    Hi ((( name )))!

    The document will be compiled multiple times, until
    all references etc. are resolved, like this one: \ref{somelabel}

    \section{Somesection}
    \label{somelabel}

    Some more content.

    \end{document}
    """)

tex = Jinjatex()

# Return rendered template only
tex.render(template_string)
# Compile .tex and return content of .pdf, default engine is pdflatex
with open('result.pdf', 'wb') as file:
    file.write(tex.compile(template_string))


# Example 2: Jinja options and other tex compilers
# Assuming a template 'mytemplate.tex' exists in mypackage/tex_templates

from jinja2 import PackageLoader, StrictUndefined

tex = Jinjatex(tex_engine='xelatex',
               loader=PackageLoader('mypackage', 'tex_templates'),
               trim_blocks=True,
               undefined=StrictUndefined)

tex.render_template('mytemplate.tex')
with open('result.pdf', 'wb') as file:
    file.write(tex.compile_template('mytemplate.tex'))