Add Django templates

Create a template for a view

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

1. Place the caret at the unresolved reference to a template.

2. Press Alt+Enter, or click the yellow light bulb to show the list of available intention actions.

3. From the suggestion list, choose action Create template <name>:

   

   Create Template dialog appears, showing the read-only 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. You can specify the other directories in addition.

4. 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.

5. Click OK. The empty .html file with the name is created in the specified location.

Configure a template language for a project

1. Open the Settings/Preferences dialog, and click the node Python Template Languages.

2. In the Template Languages page, do the following:

   • 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.

     Note that in HTML, XHTML, and XML files templates are always recognized.

     Use Add and Remove buttons to make up the desired list of file types.

You can make Django support skip some folders (disable Django language substitution), if you mark them as resources.

Define template directories

1. In the Settings/Preferences dialog (Ctrl+Alt+S), click the Project Structure page.

2. Choose the directory to be marked as a template root.

3. Do one of the following:

   • Click on the toolbar of the Content roots pane.

   • Choose Templates on the directory's context menu.

Mark a folder as a template directory

1. In the Project tool window, right-click the desired directory.

2. From the context menu, choose Mark Directory As, and then click the checked command Template Directory.

   This results in adding the marked directory to the list of template directories in the Project Structure page.

Debug a Django template

1. Place breakpoints at the desired lines of the Django templates:

   

2. Launch Django server in the Debug mode.

   This is how it's done:

   1. From the main menu, choose Run | Edit Configurations.

   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 main toolbar, or press Shift+F9.

   PyCharm will open the template in your browser, and suspend at the breakpoints you've set.

   The Debugger session starts, and Debug tool window appears.

3. In the Debug tool window, you can:

   • Examine the rendering contexts in the Variables pane.

   • Step through the breakpoints defined within the Django template.

   • Use the debugging console.