Templates inheritance (2.2+)

.. _templates:

Templates inheritance (2.2+)

New in Cookiecutter 2.2+

Sometimes you need to extend a base template with a different configuration to avoid nested blocks.

Cookiecutter introduces the ability to use common templates using the power of jinja: extends, include and super.

Here's an example repository::

https://github.com/user/repo-name.git
├── {{cookiecutter.project_slug}}/
|   └── file.txt
├── templates/
|   └── base.txt
└── cookiecutter.json

every file in the templates directory will become referable inside the project itself, and the path should be relative from the templates folder like ::

# file.txt
{% extends "base.txt" %}

... or ...

# file.txt
{% include "base.txt" %}

see more on https://jinja.palletsprojects.com/en/2.11.x/templates/