logo oujood
🔍

La balise commentaire en Django

Dans Django, commenter du code ne se fait pas comme en Python. On dispose de deux syntaxes dans les templates : la balise courte {# ... #} pour les petits commentaires, et le bloc {% comment %} pour masquer plusieurs lignes. Dans les vues, c'est Python pur — le caractère # reprend ses droits.

OUJOOD.COM

Commenter une ligne dans un template

En Python, une ligne de commentaire commence par #. Dans un template Django, cette syntaxe ne fonctionne pas — le moteur de rendu ne la reconnaît pas comme commentaire. Pour les commentaires courts, Django propose la balise {# ... #}. Tout ce qui se trouve entre ces accolades est ignoré au rendu. C'est la solution la plus légère pour masquer un mot ou une courte expression sans perturber la structure du template.

Exemple — masquer la chaîne "Tout le monde" dans un titre :

  📋 Copier le code

<!DOCTYPE html>
<html>
<body>
<h1>
Bienvenue {# Tout le monde #} !
</h1>

</body>
</html> 
Au rendu, Django affiche simplement : Bienvenue ! — la chaîne commentée disparaît complètement de la page générée.

Commenter un bloc avec {% comment %}

Pour masquer plusieurs lignes d'un coup, la balise {% comment %} est faite pour ça. Elle délimite un bloc entier que Django ignorera lors du rendu.

La structure est simple :
  • Début du commentaire : {% comment %}
  • Fin du commentaire : {% endcomment %}
Tout ce qui se trouve entre ces deux balises — HTML, variables, filtres — est mis de côté. Rien n'est rendu, rien n'est évalué.

Une note facultative peut être ajoutée directement dans la balise ouvrante. C'est utile pour expliquer pourquoi ce bloc a été désactivé, ou laisser un message aux autres développeurs qui liront le code plus tard.

Exemple complet :

  📋 Copier le code

<!DOCTYPE html>
<html>
<body>
<h1>
Bienvenue {# Tout le monde #} !
</h1>
<p>Texte rendu : </p>
{% comment %}
	<h1>Bienvenue mesdames et messieurs !</h1>
    <p>Texte commenté avec {{ create_date|date : "c" }}</p>
{% endcomment %}
</body>
</html>
Pour ajouter un message dans le commentaire, on le place entre guillemets juste après la balise ouvrante :
{% comment "message ajouté au commentaire" %}
	<h1>Bienvenue mesdames et messieurs !</h1>
    <p>Texte commenté avec {{ create_date|date : "c" }}</p>
{% endcomment %}
Ce message n'apparaît jamais dans la page — il reste un repère interne, utile en contexte d'équipe ou sur des projets qui évoluent dans le temps.

Commentaires dans les vues Python

Les vues Django sont écrites en Python. Là, pas de syntaxe spéciale : le caractère # reprend son rôle habituel. Tout ce qui suit un # sur une ligne est ignoré par l'interpréteur.

Exemple — commenter des lignes dans un fichier views.py :

Fichier views.py   📋 Copier le code

from django.http import HttpResponse
from django.template import loader

def testing(request):
  template = loader.get_template('template.html')
  context = {
  # voici un commentaire
  #le commentaire dans views
    'prenom': 'Robert',
  }
  # ceci est un autre commentaire
  return HttpResponse(template.render(context, request))  
Pour aller plus loin sur la syntaxe Python, le tutoriel sur les commentaires Python couvre le sujet en détail.

Par carabde | Mis à jour le 01 juin 2026