On 7 jan, 00:03, phoebebright <phoebebri...@spamcop.net> wrote:
> Thanks for that clarification.  I am finding that a lot of assumptions
> are made in the documentation about previous knowledge.

Indeed. It is assumed that the reader knows at least a couple things
about the web, programming, HTML, and the HTTP protocol !-)

> Maybe starting a collection of seemingly obvious statements would be
> helpful for newbies:
> - django is a module for python, so a basic knowledge of python is
> required,

Go to the project's home page. The first line of text contains the
brand (and main menu). The fifth line - which is the first _effective_
content of the page - says :
"Django is a high-level Python Web framework"

I may be a bit biased here, but as far as I'm concerned, this is
obvious enough.

> - django includes a templating language that has a limited

s/limited/extensible/

> set of
> commands, so python code will not work there.

Still on the project's home page:
"""
Template system

Use Django's powerful, extensible and designer-friendly template
language to separate design, content and Python code.
"""

Note that you have two strong hints there:
1/ python code
2/ separate

If that's not enough, following the 'template language' link, you land
on a documentation page that makes the whole point very clear:

"""
If you have a background in programming, or if you’re used to
languages like PHP which mix programming code directly into HTML,
you’ll want to bear in mind that the Django template system is not
simply Python embedded into HTML. This is by design: the template
system is meant to express presentation, not program logic.

The Django template system provides tags which function similarly to
some programming constructs – an if tag for boolean tests, a for tag
for looping, etc. – but these are not simply executed as the
corresponding Python code, and the template system will not execute
arbitrary Python expressions
"""


(snip other already documented things).

Now I don't mean there's no room for improvement, but what, you just
can't stack everything on the home page, can you ?-)


--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups 
"Django users" group.
To post to this group, send email to django-users@googlegroups.com
To unsubscribe from this group, send email to 
django-users+unsubscr...@googlegroups.com
For more options, visit this group at 
http://groups.google.com/group/django-users?hl=en
-~----------~----~----~----~------~----~------~--~---

Reply via email to