author | Pawel Solyga <Pawel.Solyga@gmail.com> |
Tue, 30 Sep 2008 16:26:30 +0000 | |
changeset 214 | 21f94815fc85 |
parent 54 | 03e267d67478 |
child 529 | 7c5ec72cdcf1 |
permissions | -rw-r--r-- |
34
14c266e01a56
Fix a typo in the {% extends %} example and add a section on Model-specific
Todd Larsen <tlarsen@google.com>
parents:
3
diff
changeset
|
1 |
TEMPLATE NAMESPACES |
14c266e01a56
Fix a typo in the {% extends %} example and add a section on Model-specific
Todd Larsen <tlarsen@google.com>
parents:
3
diff
changeset
|
2 |
|
3
962da9e1065d
Add a "namespace-subdivided" Django templates directory for the SoC
Todd Larsen <tlarsen@google.com>
parents:
diff
changeset
|
3 |
Templates are placed in a "namespace" subdirectory in the templates directory, |
962da9e1065d
Add a "namespace-subdivided" Django templates directory for the SoC
Todd Larsen <tlarsen@google.com>
parents:
diff
changeset
|
4 |
since the templates directory will be added to the Django templates search |
962da9e1065d
Add a "namespace-subdivided" Django templates directory for the SoC
Todd Larsen <tlarsen@google.com>
parents:
diff
changeset
|
5 |
path. This allows other packages to extend existing templates without "hiding" |
962da9e1065d
Add a "namespace-subdivided" Django templates directory for the SoC
Todd Larsen <tlarsen@google.com>
parents:
diff
changeset
|
6 |
the original template. For example, a template in another Melange application |
962da9e1065d
Add a "namespace-subdivided" Django templates directory for the SoC
Todd Larsen <tlarsen@google.com>
parents:
diff
changeset
|
7 |
can extend a template in the SoC framework like this: |
962da9e1065d
Add a "namespace-subdivided" Django templates directory for the SoC
Todd Larsen <tlarsen@google.com>
parents:
diff
changeset
|
8 |
|
34
14c266e01a56
Fix a typo in the {% extends %} example and add a section on Model-specific
Todd Larsen <tlarsen@google.com>
parents:
3
diff
changeset
|
9 |
{% extends 'soc/some_existing_template.html' %} |
3
962da9e1065d
Add a "namespace-subdivided" Django templates directory for the SoC
Todd Larsen <tlarsen@google.com>
parents:
diff
changeset
|
10 |
|
962da9e1065d
Add a "namespace-subdivided" Django templates directory for the SoC
Todd Larsen <tlarsen@google.com>
parents:
diff
changeset
|
11 |
without "hiding" the some_existing_template.html for other uses, even if the |
962da9e1065d
Add a "namespace-subdivided" Django templates directory for the SoC
Todd Larsen <tlarsen@google.com>
parents:
diff
changeset
|
12 |
derived template is also named some_existing_template.html. |
962da9e1065d
Add a "namespace-subdivided" Django templates directory for the SoC
Todd Larsen <tlarsen@google.com>
parents:
diff
changeset
|
13 |
|
962da9e1065d
Add a "namespace-subdivided" Django templates directory for the SoC
Todd Larsen <tlarsen@google.com>
parents:
diff
changeset
|
14 |
So, please do not put any templates in this soc/templates directory, but only |
962da9e1065d
Add a "namespace-subdivided" Django templates directory for the SoC
Todd Larsen <tlarsen@google.com>
parents:
diff
changeset
|
15 |
place them in the soc/templates/soc "namespace" subdirectory. |
962da9e1065d
Add a "namespace-subdivided" Django templates directory for the SoC
Todd Larsen <tlarsen@google.com>
parents:
diff
changeset
|
16 |
|
962da9e1065d
Add a "namespace-subdivided" Django templates directory for the SoC
Todd Larsen <tlarsen@google.com>
parents:
diff
changeset
|
17 |
Different Melange applications should also follow this pattern, to promote |
962da9e1065d
Add a "namespace-subdivided" Django templates directory for the SoC
Todd Larsen <tlarsen@google.com>
parents:
diff
changeset
|
18 |
sharing of templates between applications as well. For exmample, the GSoC |
962da9e1065d
Add a "namespace-subdivided" Django templates directory for the SoC
Todd Larsen <tlarsen@google.com>
parents:
diff
changeset
|
19 |
Melange application should place its templates in gsoc/templates/gsoc. |
962da9e1065d
Add a "namespace-subdivided" Django templates directory for the SoC
Todd Larsen <tlarsen@google.com>
parents:
diff
changeset
|
20 |
|
34
14c266e01a56
Fix a typo in the {% extends %} example and add a section on Model-specific
Todd Larsen <tlarsen@google.com>
parents:
3
diff
changeset
|
21 |
MODEL/VIEW TEMPLATE NAMING |
14c266e01a56
Fix a typo in the {% extends %} example and add a section on Model-specific
Todd Larsen <tlarsen@google.com>
parents:
3
diff
changeset
|
22 |
|
14c266e01a56
Fix a typo in the {% extends %} example and add a section on Model-specific
Todd Larsen <tlarsen@google.com>
parents:
3
diff
changeset
|
23 |
View templates are usually named some_view.html for a corresponding someView() |
14c266e01a56
Fix a typo in the {% extends %} example and add a section on Model-specific
Todd Larsen <tlarsen@google.com>
parents:
3
diff
changeset
|
24 |
function and SomeViewForm form class. Since SomeView is likely to be a common |
14c266e01a56
Fix a typo in the {% extends %} example and add a section on Model-specific
Todd Larsen <tlarsen@google.com>
parents:
3
diff
changeset
|
25 |
View name for multiple Models, Model-specific templates should be placed in |
14c266e01a56
Fix a typo in the {% extends %} example and add a section on Model-specific
Todd Larsen <tlarsen@google.com>
parents:
3
diff
changeset
|
26 |
soc/<model> sub-directories. For example, the template used by the Profile |
14c266e01a56
Fix a typo in the {% extends %} example and add a section on Model-specific
Todd Larsen <tlarsen@google.com>
parents:
3
diff
changeset
|
27 |
view for the Person Model belongs in soc/person/profile.html. |
14c266e01a56
Fix a typo in the {% extends %} example and add a section on Model-specific
Todd Larsen <tlarsen@google.com>
parents:
3
diff
changeset
|
28 |