author | Pawel Solyga <Pawel.Solyga@gmail.com> |
Wed, 04 Mar 2009 20:50:27 +0000 | |
changeset 1649 | 495171ad94c0 |
parent 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 |
529
7c5ec72cdcf1
Replace nick_name and its variants with public_name. Remove the
Todd Larsen <tlarsen@google.com>
parents:
54
diff
changeset
|
26 |
soc/<model>/<view> sub-directories. |
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
|
27 |