This is a Jinja2 template.
\n\n\n\n# project/urls.py\nfrom django.contrib import admin\nfrom django.urls import path\nfrom myapp.views import hello_world\n\nurlpatterns = [\n path('admin/', admin.site.urls),\n path('hello/', hello_world, name='hello_world'),\n]\n","lang":"python","description":"To quickly set up django-jinja:\n1. Add 'django_jinja' and your app 'myapp' to `INSTALLED_APPS`.\n2. Configure `TEMPLATES` in `settings.py` to use `django_jinja.base.Jinja2` as a backend, ensuring `match_extension` (e.g., '.jinja') matches your template file names.\n3. Create a simple view in `myapp/views.py` that renders a Jinja2 template.\n4. Create a Jinja2 template (e.g., `myapp/templates/myapp/hello.jinja`).\n5. Map a URL to your view in `project/urls.py`.\nThis minimal setup allows Django to load and render Jinja2 templates via django-jinja."},"warnings":[{"fix":"Upgrade your Django project to Django 3.2 or newer, and your Python environment to Python 3.8 or newer. Ensure all project dependencies are compatible.","message":"Version 2.11.0 dropped support for Django versions older than 3.2 and Python versions older than 3.8. Projects on older Django/Python will break upon upgrade.","severity":"breaking","affected_versions":"2.11.0+"},{"fix":"Upgrade your Jinja2 library to version 3.0 or higher. Ensure your Python environment is 3.6 or higher (preferably 3.8+ for django-jinja 2.11.0+).","message":"Version 2.8.0 upgraded to Jinja2 3.0, consequently dropping support for Jinja2 versions 2.11 and below, and also dropped support for Python 3.5.","severity":"breaking","affected_versions":"2.8.0+"},{"fix":"Explicitly set a unique `\"NAME\": \"jinja2\"` (or another descriptive name) within the `Jinja2` backend's dictionary in your `TEMPLATES` settings. Alternatively, upgrade to `django-jinja` 2.11.0+ for a better default.","message":"Prior to version 2.11.0, the default `NAME` for the Jinja2 template engine backend was 'backend', which could lead to confusion or conflicts if not explicitly overridden.","severity":"gotcha","affected_versions":"<2.11.0"},{"fix":"Ensure `jinja2.ext.i18n` is included in the `extensions` list within the `OPTIONS` of your `Jinja2` backend in `TEMPLATES`. For `django-jinja >= 2.9.0`, consider adding `\"policies\": {\"ext.i18n.trimmed\": True}`. If on 2.7.0, upgrade to 2.7.1 or newer.","message":"The `makemessages` command for Jinja2 templates requires correct configuration of Jinja2 i18n extensions and had a specific bug in version 2.7.0 preventing detection of `{% trans %}` tags.","severity":"gotcha","affected_versions":"2.7.0 and generally if i18n not configured"},{"fix":"Add `DEFAULT_AUTO_FIELD = 'django.db.models.BigAutoField'` to your `settings.py` file to prevent deprecation warnings and ensure proper primary key types for models.","message":"Django 3.2 and newer versions require the `DEFAULT_AUTO_FIELD` setting to be explicitly defined in your project's `settings.py` for all models.","severity":"gotcha","affected_versions":"Django >= 3.2"}],"env_vars":null,"last_verified":"2026-04-16T00:00:00.000Z","next_check":"2026-07-15T00:00:00.000Z","problems":[{"fix":"Upgrade your Django version to one supported by django-jinja (currently >=3.2, <5.0). E.g., `pip install 'Django>=3.2,<5.0'`.","cause":"Your installed Django version is not compatible with the installed django-jinja version.","error":"ImproperlyConfigured: django-jinja requires Django >=3.2,<5.0. You are using Django X.Y.Z."},{"fix":"Ensure `APP_DIRS: True` and `\"match_extension\": \".jinja\"` (or your chosen extension) are correctly set for your `django_jinja.base.Jinja2` backend in `settings.py`. Verify the template file exists at the expected path (e.g., `myapp/templates/myapp/hello.jinja`).","cause":"The Jinja2 template loader cannot find the specified template. This often indicates incorrect `TEMPLATES` configuration (e.g., `APP_DIRS` is False, `match_extension` does not match, or template path is wrong).","error":"jinja2.exceptions.TemplateNotFound: myapp/hello.jinja"},{"fix":"In your `settings.py`, ensure the `OPTIONS` dictionary for your `django_jinja.base.Jinja2` backend includes `\"extensions\": [...]` and `\"jinja2.ext.i18n\"` is part of that list.","cause":"The `makemessages` command is failing because the Jinja2 backend's options are missing the `extensions` key or `jinja2.ext.i18n` is not included for internationalization.","error":"You are trying to run makemessages without a TEMPLATES['OPTIONS'] for the Jinja2 backend containing 'extensions' list."},{"fix":"Ensure you are using `django_jinja.base.Jinja2` as your backend. If you need direct access to the Jinja2 environment, django-jinja provides `django_jinja.base.get_env()` to retrieve the configured Jinja2 environment.","cause":"You are likely attempting to access the Jinja2 environment from Django's generic template engine API, which might not expose it directly or consistently. This could happen if using `django.template.backends.jinja2.Jinja2` instead of `django_jinja.base.Jinja2` or trying to access it outside of django-jinja's intended API.","error":"AttributeError: 'Jinja2' object has no attribute 'env' (when trying to access jinja2 environment directly)"}]}