Does the Jinja2 templating language have the concept of 'here' (current directory)?
I do not believe so. Typically you include or extend other templates by specifying their paths relative to the root of whatever template loader and environment you're using.
So let's say your templates are all in /path/to/templates
and you've set up Jinja like so:
import jinja2
template_dir = '/path/to/templates'
loader = jinja2.FileSystemLoader(template_dir)
environment = jinja2.Environment(loader=loader)
Now, if you'd like to include /path/to/templates/includes/sidebar.html
in the /path/to/templates/index.html
template, you'd write the following in your index.html
:
{% include 'includes/sidebar.html' %}
and Jinja would figure out how to find it.
Just to add to Will McCutchen's answer,
You can have multiple directories in your loader. It then searches in each of the directories (in order) until it finds the template.
for example, if you wanted to have "sidebar.html" instead of "/includes/sidebar.html" then have:
loader=jinja2.FileSystemLoader(
[os.path.join(os.path.dirname(__file__),"templates/includes"),
os.path.join(os.path.dirname(__file__),"templates")])
instead of
loader=jinja2.FileSystemLoader(os.path.join(os.path.dirname(__file__),"templates"))
According to the documentation for jinja2.Environment.join_path(), support for relative template paths is possible by overriding join_path() to implement "template path joining".
class RelEnvironment(jinja2.Environment):
"""Override join_path() to enable relative template paths."""
def join_path(self, template, parent):
return os.path.join(os.path.dirname(parent), template)