Django Typst

A Django template engine that uses Typst to render Portable Document Format (PDF) files.

Full documentation can be found at https://django-typst-engine.readthedocs.io/en/latest/

Installation and Configuration

The Django Typst engine is available from PyPI so you can install it with all the usual tools:

pip install django_typst
# or
uv add django_typst
# or
poetry add django_typst

Once installed, to make the typst engine available, you need to add it to the TEMPLATES configuration in your settings.py. e.g.:

TEMPLATES = [
    ...
    {
        "BACKEND": "django_typst.TypstEngine",
        "NAME": "typst",
        "DIRS": [BASE_DIR / "templates"],
        "APP_DIRS": False,
        "OPTIONS": {
            "ROOT": None,
            "FONT_PATHS": [],
            "IGNORE_SYSTEM_FONTS": False,
            "PDF_STANDARD": "1.7",
            "PPI": None,
        }
    },
]

Note that this should be in addition to the standard Django template engine that was already there.

All the OPTIONS are... optional and the values above represent their defaults should no alternative be provided.

* The engine with use the folder the template is in as the root if one is not specified.

[!NOTE] The Django Typst Engine does support loading templates from app dirs with the APP_DIR configuration, but just like the jinja2 engine, it expects the in-app folder to have an engine specific name of typst. So if you want to have templates in app directories, please ensure they sit within a folder called typst.

Usage

To use this engine with one of the standard Django class based views you only need to set the template_engine class property to the value "typst". You should also set the content_type property to the value "application/pdf" to ensure the PDF is returned with the correct content type. For example, in a simple TemplateView it would look like this:

from django.views import generic

class MyTemplateView(generic.TemplateView):
  template_engine = "typst"
  content_type = "application/pdf"

  ...