Réponses:
Les balises de commentaire sont documentées sur https://docs.djangoproject.com/en/stable/ref/templates/builtins/#std:templatetag-comment
{% comment %} this is a comment {% endcomment %}
Les commentaires sur une seule ligne sont documentés sur https://docs.djangoproject.com/en/stable/topics/templates/#comments
{# this won't be rendered #}
Contrairement aux commentaires html traditionnels comme celui-ci:
<!-- not so secret secrets -->
Les commentaires du modèle Django ne sont pas rendus dans le html final. Vous pouvez donc vous sentir libre de remplir les détails d'implémentation comme ceci:
Multi-ligne:
{% comment %}
The other half of the flexbox is defined
in a different file `sidebar.html`
as <div id="sidebar-main">.
{% endcomment %}
Une seule ligne:
{# jquery latest #}
{#
beware, this won't be commented out...
actually renders as regular body text on the page
#}
Je trouve cela particulièrement utile pour les <a href="{% url 'view_name' %}"
vues qui n'ont pas encore été créées.
Le commentaire multiligne dans les modèles django utilise comme suit ex: pour .html etc.
{% comment %} All inside this tags are treated as comment {% endcomment %}
{% extends "file.html" %}
balise, vous devriez la mettre tout en haut du fichier de modèle avant même le{% comment %}
...{% endcomment %}
, sinon vous obtiendrez une<ExtendsNode: extends "file.html"> must be the first tag in the template
erreur. Je dis que si quelqu'un veut placer les commentaires sur plusieurs lignes en haut du modèle.