Opened 7 years ago

Closed 7 years ago

Last modified 7 years ago

#28190 closed Cleanup/optimization (fixed)

Clarify absolute/relative paths in the extends/include template tag docs

Reported by: Anupam Owned by: nobody
Component: Documentation Version: 1.11
Severity: Normal Keywords:
Cc: Triage Stage: Accepted
Has patch: yes Needs documentation: no
Needs tests: no Patch needs improvement: yes
Easy pickings: no UI/UX: no

Description (last modified by Tim Graham)

Minor point but I feel it is worth re-iterating that the example (https://docs.djangoproject.com/en/1.11/ref/templates/builtins/#include) is using an absolute path and folks should prefix "./" if the template being referenced is in the same directory as the template that is referencing it.

PR

Change History (3)

comment:1 by Tim Graham, 7 years ago

Component: UncategorizedDocumentation
Description: modified (diff)
Has patch: set
Patch needs improvement: set
Summary: Re-iterate the point about absolute/relative paths in the 'include' templatetag exampleClarify absolute/relative paths in the extends/include template tag docs
Triage Stage: UnreviewedAccepted
Type: UncategorizedCleanup/optimization

As I said on the PR, I'm not sure if "absolute path" is good terminology to use, considering that the given path is usually relative to the directory specified by a template loader, however, some clarifications could be made.

comment:2 by Tim Graham <timograham@…>, 7 years ago

Resolution: fixed
Status: newclosed

In 1f2e4f9c:

Fixed #28190 -- Clarifed how include/extends treat template names.

comment:3 by Tim Graham <timograham@…>, 7 years ago

In 9a3bcaf4:

[1.11.x] Fixed #28190 -- Clarifed how include/extends treat template names.

Backport of 1f2e4f9cfe26dd9ad1fc85375c1dce38c65bbe6b from master

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