Installation

# Create a virtual environmentvirtualenv -p python3.4 venv# Source the virtual environmentsource venv/bin/activate# Install latexbuild in the virtual environmentpip install latexbuild

Rendering Jinja2 templates for Latex

% FILENAME: template.tex\documentclass[12pt]{article}\title{Economics Department:\BLOCK{block title}\BLOCK{endblock}}\author{\vspace{-5ex}}\date{\vspace{-5ex}}\begin{document}\maketitle\section{Department Introduction}This is a standard message from the departmentthat will appear in every syllabus in exactly this place.Professors shouldn't have to think about this.\section{Greatness}\BLOCK{block greatness}\BLOCK{endblock}\section{Boredom}\BLOCK{block boredom}\BLOCK{endblock}\end{document}

%- extends "template.tex"% FILENAME: accounting.tex%- block titleAccounting%- endblock%- block greatnessThis is a great, accounting-specific block%- endblock%- block boredomThis is a boring, accounting-specific block%- endblock

%- extends "template.tex"% FILENAME: statistics.tex%- block titleStatistics for juggernauts%- endblock%- block greatnessThis is a great, statistics-specific block%- endblock%- block boredomThis is a boring, statistics-specific block%- endblock

This snippet provides an ordered list displaying thelist variable passed from Python:\begin{enumerate}%- for variable in variable_list\item\VAR{variable}%- endfor\end{enumerate}Alternatively, this snippet provides an unordered listdisplaying the list variable passed from Python:\begin{itemize}%- for variable in variable_list\item\VAR{variable}%- endfor\end{itemize}

Building Latex Output

fromlatexbuildimportbuild_pdf,build_html,build_docx,render_latex_templatePATH_JINJA2="/path/to/your/latex/jinja2/root"PATH_TEMPLATE_RELATIVE_TO_PATH_JINJA2="template/filepath.tex"PATH_OUTPUT_PDF="/path/to/your/output/directory/MYOUTPUTFILE.pdf"PATH_OUTPUT_HTML="/path/to/your/output/directory/MYOUTPUTFILE.html"PATH_OUTPUT_DOCX="/path/to/your/output/directory/MYOUTPUTFILE.docx"# Build Jinja2 template, compile result latex, move compiled file to output path,# and clean up all intermediate filesbuild_pdf(PATH_JINJA2,PATH_TEMPLATE_RELATIVE_TO_PATH_JINJA2,PATH_OUTPUT_PDF)build_html(PATH_JINJA2,PATH_TEMPLATE_RELATIVE_TO_PATH_JINJA2,PATH_OUTPUT_HTML)build_docx(PATH_JINJA2,PATH_TEMPLATE_RELATIVE_TO_PATH_JINJA2,PATH_OUTPUT_DOCX)# If you just want the rendered template's text in a python variable,# do the following (assuming you have no variables to pass):render_latex_template(PATH_JINJA2,PATH_TEMPLATE_RELATIVE_TO_PATH_JINJA2)# If your template renders Jinja2 variables, most interfaces provide# a dictionary parameter. See below for an example for simply# rendering the template's text in PythonDICT_VALS= {'var1':'my variable 1 value','list_var': ['item 1 for analysis','item 2 for analysis']    }render_latex_template(PATH_JINJA2,PATH_TEMPLATE_RELATIVE_TO_PATH_JINJA2,DICT_VALS,    )

Supported / tested systems

Written by