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 -~----------~----~----~----~------~----~------~--~---