templates are a crucial part of any web application, enabling developers to create dynamic html content by embedding python code within html. pyramid supports several templating engines, including jinja2, chameleon, and mako. each of these engines has its own syntax and features, but they all serve the same basic purpose: to generate html content dynamically.

concepts related to python pyramid templates

template engines: jinja2, chameleon, and mako are some of the templating engines that python pyramid supports. with these template engines, developers can write html pages dynamically by inserting python code into html templates.
inheritance of templates: it is possible to create a base template with common elements like headers, footers, or navigation bars in it and then extend this base template in child templates to add specific content; this feature is called template inheritance. it helps in reusing code and having consistent layouts across multiple pages.
template context: the term “template context” refers to information passed from views (in python) to templates. in python pyramid, you can pass data to templates either via the render() function or through context argument while rendering a template.

setting up templates in pyramid

to get started with templating in pyramid, you need to choose a templating engine. in this article, we will focus on jinja2, one of the most popular and widely used templating engines.

using jinja2 template engine

creating a small project using jinja template with project file structure as given below

step 1: create a pyramid project of jina2

step2 : now create a jinja2 template

create a new jinja2 template file with the .jinja2 extension. for example, i'm creating hello_world.jinja2 in the project's templates directory.

html

<!doctype html>
<html lang="en">
<head>
    <meta charset="utf-8">
    <title>hello, {{ name }}!</title>
</head>
<body>
    <h1>hello, {{ name }}!</h1>
    <p>welcome to {{ city }}, in {{ country }}
</body>
</html>

step3 : write pyramid view function

now, create a view function in default.py in views folder.

python

@view_config(route_name='another')
def hello_world(request):
    context = {'name': 'johny','city':'lucknow','country':'india'}
    return render_to_response('myproject:templates/hello_world.jinja2',
                              context, request=request)

step4: register route

config.add_route('another', '/another')

step 5 : to run the development server follow this command.

 pserve development.ini

the project runs successfully to see that open the serving url(http://127.0.0.1:6543) and open it on the browser.

complete code

python

# myproject:routes.py

def includeme(config):
    config.add_static_view('static', 'static', cache_max_age=3600)
    config.add_route('home', '/')
    config.add_route('another', '/another')

python

# myproject:views/default.py
from pyramid.view import view_config
from pyramid.renderers import render_to_response

@view_config(route_name='home', renderer='myproject:templates/mytemplate.jinja2')
def my_view(request):
    return {'project': 'myproject'}

@view_config(route_name='another')
def hello_world(request):
    context = {'name': 'johny','city':'lucknow','country':'india'}
    return render_to_response('myproject:templates/hello_world.jinja2', context, request=request)

html

#myproject:templates/mytemplate.jinja2
<!doctype html>
<html lang="en">
<head>
    <meta charset="utf-8">
    <title>hello, {{ name }}!</title>
</head>
<body>
    <h1>hello, {{ name }}!</h1>
    <p>welcome to {{ city }}, in {{ country }}
</body>
</html>

output:

using chameleon template engine

creating a small project using chameleon template with project file structure as given below

step1: create a pyramid project of chameleon

step 2: now create a chameleon template

create a new chameleon template file with the .pt extension. for example, i'm creating base.pt and home.pt in the project's templates directory.

base.pt

html

<!doctype html>
<html lang="en">
<head>
    <meta charset="utf-8">
    <title>my wesbite</title>
</head>
<body>
    <header>
        <h1>welcome to my website...!</h1>
    </header>
    <main>${content}</main>
    <footer>© 2024 my website</footer>
</body>
</html>

home.pt

html

<div>heyy ${name}! welcome to my home page!</div>

step3: write pyramid view function

now, create a view function in default.py in views folder.

python

@view_config(route_name='another')
def home(request):
    context = {'name': 'rony'}
    return render_to_response('project2:templates/home.pt', context, request=request)

step4: register route

config.add_route('another', '/another')

step 5 : to run the development server follow this command.

>> pserve development.ini

the project runs successfully to see that open the serving url (http://127.0.0.1:6543) and open it on the browser.

complete code

python

#project2:views/default.py
from pyramid.view import view_config
from pyramid.renderers import render_to_response

@view_config(route_name='home', renderer='project2:templates/mytemplate.pt')
def my_view(request):
    return {'project': 'project2'}

@view_config(route_name='another')
def home(request):
    context = {'name': 'rony'}
    return render_to_response('project2:templates/home.pt', context, request=request)

python

#project2:routes.py
def includeme(config):
    config.add_static_view('static', 'static', cache_max_age=3600)
    config.add_route('home', '/')
    config.add_route('another', '/another')

html

#project2:templates/base.pt
<!doctype html>
<html lang="en">
<head>
    <meta charset="utf-8">
    <title>my wesbite</title>
</head>
<body>
    <header>
        <h1>welcome to my website...!</h1>
    </header>
    <main>${content}</main>
    <footer>© 2024 my website</footer>
</body>
</html>

html

#project2:templates/home.pt
<div>heyy ${name}! welcome to my home page!</div>

output:

Save or share this article