Django

Code

Changeset 50

Show
Ignore:
Timestamp:
07/15/05 10:57:46 (3 years ago)
Author:
jacob
Message:

More doc improvements: tweaks to the overview; added admin css documentation from wilson.

Files:

Legend:

Unmodified
Added
Removed
Modified
Copied
Moved
  • django/trunk/docs/overview.txt

    r49 r50  
    1 =============== 
    2 Django overview 
    3 =============== 
     1================== 
     2Django at a glance 
     3================== 
    44 
    55Because Django was developed in a fast-paced newsroom environment, it was 
     
    1818 
    1919Start by describing your database layout in Python code. Django's data-model API 
    20 offers many rich ways of representing your models so far, it's been 
     20offers many rich ways of representing your models -- so far, it's been 
    2121solving two years' worth of database-schema problems. Here's a quick example:: 
    2222 
     
    128128 
    129129Once your models are defined, Django can automatically create an administrative 
    130 interface a Web site that lets authenticated users add, change and 
     130interface -- a Web site that lets authenticated users add, change and 
    131131delete objects. It's as easy as adding an extra admin attribute to your model 
    132132classes:: 
     
    184184 
    185185Once one of the regexes matches, Django imports and calls the given view, which 
    186 is a simple Python function. Each view gets passed a request object  
     186is a simple Python function. Each view gets passed a request object -- 
    187187which contains request metadata and lets you access GET and POST data as simple 
    188 dictionaries and the values captured in the regex, via keyword 
     188dictionaries -- and the values captured in the regex, via keyword 
    189189arguments. 
    190190 
     
    283283Simplistically, it defines the look-and-feel of the site (with the site's logo), 
    284284and provides "holes" for child templates to fill. This makes a site redesign as 
    285 easy as changing a single file the base template. 
     285easy as changing a single file -- the base template. 
    286286 
    287287Note that you don't have to use Django's template system if you prefer another 
     
    290290have to use Django's API, either. You can use another database abstraction 
    291291layer, you can read XML files, you can read files off disk, or anything you 
    292 want. Each piece of Django — models, views, templates — is decoupled 
     292want. Each piece of Django -- models, views, templates -- is decoupled 
    293293from the next. 
    294294 
     
    302302    * An RSS framework that makes creating RSS feeds as easy as writing a  
    303303      small Python class. 
    304     * More sexy automatically-generated admin features this overview barely 
     304    * More sexy automatically-generated admin features -- this overview barely 
    305305      scratched the surface 
    306306