How Does Django Find Templates

Add Django templates

PyCharm makes it possible to create and render templates written in one of the supported template languages:

Django
Jinja2

It is of import to annotation that one can edit templates without actually installing the template languages. However, in club to create or render templates, and navigate between views and templates, the corresponding template linguistic communication should be properly installed.

Create a template for a view

Suppose yous reference a template file that doesn't withal exist. PyCharm marks such a reference as unresolved, and provides an intention action to create a template file "from usage".

Place the caret at the unresolved reference to a template.
Printing Alt+Enter, or click the yellow light bulb to evidence the listing of available intention actions.
From the suggestion list, choose action Create template <name>:

Create Template dialog appears, showing the read-simply template name (Template path field), and a list of possible template locations (Templates root field).

Note that PyCharm automatically discovers the directories specified in the TEMPLATE_DIRS or TEMPLATE_LOADERS fields of the settings.py file. Y'all can specify the other directories in improver.
In the Create Template dialog, select the template directory, where the new template will be created.

The Template root field provides a list of possible locations for the new template. This list includes the template directories specified in the Template Languages page of the Settings dialog, plus the directories, which are automatically detected in the TEMPLATE_DIRS or TEMPLATE_LOADERS variables of the settings.py file.
Click OK. The empty .html file with the name is created in the specified location.

Before making use of a certain template linguistic communication, configure it in the Template Languages page of the Settings dialog and ensure that file types of whatsoever existing templates are properly recognized.

Configure a template language for a project

Open the Settings/Preferences dialog, and click the node Python Template Languages.
In the Template Languages page, practice the post-obit:
- From the Template language list, select the specific template language to be used in project.
- In the Template file types area, specify the types of files, where template tags will be recognized.
  
  Notation that in HTML, XHTML, and XML files templates are always recognized.
  
  Utilise Add and Remove buttons to brand upwards the desired list of file types.

Y'all tin can brand Django support skip some folders (disable Django language exchange), if you lot mark them as resources.

When creating a Django application, y'all tin immediately specify a folder where templates will be stored.

Define template directories

In the Settings/Preferences dialog (Ctrl+Alt+S), click the Project Structure page.
Choose the directory to be marked every bit a template root.
Do ane of the following:
- Click on the toolbar of the Content roots pane.
- Cull Templates on the directory'south context menu.

Mark a folder as a template directory

In the Project tool window, right-click the desired directory.
From the context carte du jour, choose , then click the checked command .

This results in adding the marked directory to the listing of template directories in the Project Construction page.

You can brand Django support skip some folders (disable Django language substitution), if you marking them every bit resource.

PyCharm allows placing breakpoints to the lines of Django template files, at the lines with Django tags or expressions. If you want to trace back exceptions that are raised in form of template debugging, open upBreakpoints dialog, and in the Django Exception Breakpoints tab, select the checkbox Append. Debugging Jinja templates is not supported.

Debug a Django template

Place breakpoints at the desired lines of the Django templates:
Launch Django server in the Debug mode.

This is how information technology's done:
1. From the main card, choose .
2. If the desired Django Server run/debug configuration exists, select it, otherwise create a new one, as described in the section Creating and Editing Run/Debug Configuration.
3. Then click the button on the master toolbar, or press Shift+F9.
PyCharm will open the template in your browser, and append at the breakpoints you've set.

The Debugger session starts, and Debug tool window appears.
In the Debug tool window, y'all can:
- Examine the rendering contexts in the Variables pane.
- Step through the breakpoints divers within the Django template.
- Utilise the debugging panel.

Last modified: 01 April 2022