Home/ Questions/Q 588149
In Process

The Archive Base Latest Questions

Editorial Team
  • 0
Asked: 2026-05-13T15:17:17+00:00

For a new project we’re writing documentation about the Django template system. We use

  • 0

For a new project we’re writing documentation about the Django template system. We use Django for the documentation project itself too, so Django picks up all our example variables in the sample code and tries to render them. The only way we found to get around this is to use {% templatetag %}, but that makes our code really unreadable. Is there maybe a way to make Django ignore all template variables in a specific section?

Share

Leave an answer

You must login to add an answer.

Need An Account,

1 Answer

  1. Editorial Team

    Due to limitations in the Django template lexer (like being a kludgy hack), this is impossible. However, if you are willing to put your example code in separate files, you can use the ssi tag:

    {% ssi /path/to/my/code/examples/example01.html %}

    And it won’t parse the file, just include it verbatim. However, this also has limitations in that you can’t use variables in the include path (i.e. if you move template locations, you have to rewrite or at least find-and-replace your template files), and you have to put the include path (i.e. /path/to/my/code/examples) in the ALLOWED_INCLUDE_ROOTS setting in your settings.py. (See http://docs.djangoproject.com/en/dev/ref/templates/builtins/#ssi.)

    • 0