Opened 11 years ago

Closed 11 years ago

Last modified 11 years ago

#20565 closed New feature (fixed)

Generic view descriptions should give template examples

Reported by: david.reitter@… Owned by: Baptiste Darthenay
Component: Documentation Version: dev
Severity: Normal Keywords:
Cc: bmispelon@…, Baptiste Darthenay Triage Stage: Accepted
Has patch: yes Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: yes UI/UX: no

Description

When reading the docs for generic views, I wonder what the templates should like like.

It does not seem like standard templates are provided (why not?), but as a minimum, the documentation should give an example of a template for each view class.

The template variables are idiosyncratic w.r.t. the view class, e.g., the ListView defines 'object_list' as a variable. So why not give this template example:

{% block content %}
<h1>Exams</h1>
    <table>
        {% for o in object_list %}
           <tr><td>{{ o }}</td><td><a href="{% url 'exam_update' o.id %}">edit</a>&nbsp;&nbsp;<a href="{% url 'exam_delete' o.id %}">del</a></td></tr>
        {% endfor %}
    </table>
{% endblock %}

Right now, I am looking for how to correctly implement the delete confirmation template.

https://docs.djangoproject.com/en/dev/ref/class-based-views/generic-editing/#django.views.generic.edit.DeleteView

Change History (6)

comment:1 by Baptiste Mispelon, 11 years ago

Cc: bmispelon@… added
Triage Stage: UnreviewedAccepted
Type: UncategorizedNew feature

Seeing as we're already providing an example views.py and urls.py for most views, I think it makes sense to include an example template when it makes sense.

The only example template I could find was in https://docs.djangoproject.com/en/1.5/topics/class-based-views/generic-display/#generic-views-of-objects.

comment:2 by Baptiste Darthenay, 11 years ago

Cc: Baptiste Darthenay added
Owner: changed from nobody to Baptiste Darthenay
Status: newassigned

comment:3 by Baptiste Darthenay, 11 years ago

comment:4 by Baptiste Darthenay, 11 years ago

Has patch: set

comment:5 by Baptiste Darthenay <baptiste+github@…>, 11 years ago

Resolution: fixed
Status: assignedclosed

In 81545940c68de0d1235a2fb50e61b8619f17a3e3:

Fixed #20565 -- Added template examples for GCBV.

Thanks to David Reitter for the report,
and to Marc Tamlyn and Baptiste Mispelon for the review.

comment:6 by Marc Tamlyn <marc.tamlyn@…>, 11 years ago

In f6567578887b7cc4efb0006ac4a3a5ba7a1c2cc7:

Merge pull request #1271 from batisteo/ticket-20565

Fixed #20565 -- Added template examples for GCBV.

Note: See TracTickets for help on using tickets.
Back to Top