Browse files

Rolled a number of comments into documentation; thanks to all those w…

…ho contributed.

git-svn-id: bcc190cf-cafb-0310-a4f2-bffc1f526a37
  • Loading branch information...
jacobian committed Jul 21, 2005
1 parent 96d69c5 commit 18749c00602edeafd0b10da807ec55767fd6a6c8
Showing with 12 additions and 3 deletions.
  1. +2 −1 docs/cache.txt
  2. +1 −1 docs/model-api.txt
  3. +9 −1 docs/templates.txt
@@ -20,7 +20,8 @@ far the fastest option if you've got the RAM).
Before using the cache, you'll need to tell Django which cache backend you'd
like to use. Do this by setting the ``CACHE_BACKEND`` in your settings file.
-The CACHE_BACKEND setting is a quasi-URI. Examples::
+The CACHE_BACKEND setting is a "fake" URI (really an unregistered scheme).
============================== ===========================================
@@ -278,7 +278,7 @@ Field Types
.. _`strftime formatting`:
- A floating-point number. Has two required arguments:
+ A floating-point number. Has two **required** arguments:
====================== ===================================================
Argument Description
@@ -40,6 +40,14 @@ template. Each element will be explained later in this document.::
<p>{{ story.tease|truncatewords:"100" }}</p>
{% endfor %}
{% endblock %}
+.. admonition:: Philosophy
+ Why use a text-based template instead of an XML-based one (like Zope's
+ TAL)? We wanted Django's template language to be usable for more than
+ just XML/HTML templates -- at the Journal-World we use it for emails,
+ Javascript, CSV -- you can use the template language for any text-based
+ format.
What's a variable?
@@ -198,7 +206,7 @@ Here are some tips for working with inheritance:
* We often prefer to use three-level inheritance: a single base template
for the entire site, a set of mid-level templates for each section of
- the site, and then the individual templates for each page. This
+ the site, and then the individual templates for each view. This
maximizes code reuse, and makes it easier to add items to shared
content areas (like section-wide navigation).

0 comments on commit 18749c0

Please sign in to comment.