app/soc/templates/README.templates
author Mario Ferraro <fadinlight@gmail.com>
Sun, 15 Nov 2009 22:12:20 +0100
changeset 3093 d1be59b6b627
parent 529 7c5ec72cdcf1
permissions -rw-r--r--
GMaps related JS changed to use new google namespace. Google is going to change permanently in the future the way to load its services, so better stay safe. Also this commit shows uses of the new melange.js module. Fixes Issue 634.
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
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