Changes between Initial Version and Version 1 of Ticket #28102


Ignore:
Timestamp:
Apr 20, 2017, 7:04:57 AM (8 years ago)
Author:
Tim Graham
Comment:

The TemplatesSetting docs could be more explicit and include an example of how to compute the full path to Django's built-in widget directories. The same confusion was also raised in #28088.

Legend:

Unmodified
Added
Removed
Modified

  • Ticket #28102

    • Property Easy pickings set
    • Property Triage Stage Unreviewed → Accepted
    • Property Summary Contradictory documentation about DIRS and TemplatesSetting → Document how to put the full path of the built-in widget directories in DIRS

  • Ticket #28102 – Description

    initial v1  
    1 The documentation for the [`DIRS`](https://docs.djangoproject.com/en/1.11/ref/templates/api/#the-dirs-option) template setting states that
     1The documentation for the [https://docs.djangoproject.com/en/stable/ref/templates/api/#the-dirs-option DIRS] template setting states that
    22> This should be set to a list of strings that contain **full paths** to your template directories
    33
    4 However, the documentation for the [`TemplatesSetting`](https://docs.djangoproject.com/en/1.11/ref/forms/renderers/#templatessetting) class tells us:
     4However, the documentation for the [https://docs.djangoproject.com/en/stable/ref/forms/renderers/#templatessetting TemplatesSetting] class tells us:
    55> Adding the built-in widgets templates directory (**django/forms/templates** or **django/forms/jinja2**) in `DIRS` of one of your template engines.
    66That is, it says to add a relative path to the `DIRS` setting, which contradicts the documentation for `DIRS`.
Back to Top