Added "philosophy" sections to tutorials so they can be styled differently
git-svn-id: http://code.djangoproject.com/svn/django/trunk@250 bcc190cf-cafb-0310-a4f2-bffc1f526a37
This commit is contained in:
parent
ec31445c52
commit
e5a8c38fa1
|
@ -128,7 +128,9 @@ This directory structure will house the poll application.
|
||||||
The first step in writing a database Web app in Django is to define your models
|
The first step in writing a database Web app in Django is to define your models
|
||||||
-- essentially, your database layout, with additional metadata.
|
-- essentially, your database layout, with additional metadata.
|
||||||
|
|
||||||
PHILOSOPHY: A model is the single, definitive source of data about your
|
.. admonition:: Philosophy
|
||||||
|
|
||||||
|
A model is the single, definitive source of data about your
|
||||||
data. It contains the essential fields and behaviors of the data you're
|
data. It contains the essential fields and behaviors of the data you're
|
||||||
storing. Django follows the `DRY Principle`_. The goal is to define your
|
storing. Django follows the `DRY Principle`_. The goal is to define your
|
||||||
data model in one place and automatically derive things from it.
|
data model in one place and automatically derive things from it.
|
||||||
|
@ -195,7 +197,9 @@ is able to:
|
||||||
|
|
||||||
But first we need to tell our project that the ``polls`` app is installed.
|
But first we need to tell our project that the ``polls`` app is installed.
|
||||||
|
|
||||||
PHILOSOPHY: Django apps are "pluggable": You can use an app in multiple
|
.. adminition:: Philosophy
|
||||||
|
|
||||||
|
Django apps are "pluggable": You can use an app in multiple
|
||||||
projects, and you can distribute apps, because they're not tied to a given
|
projects, and you can distribute apps, because they're not tied to a given
|
||||||
Django installation.
|
Django installation.
|
||||||
|
|
||||||
|
|
|
@ -9,21 +9,20 @@ application and will focus on Django's automatically-generated admin site.
|
||||||
|
|
||||||
.. _Tutorial 1: http://www.djangoproject.com/documentation/tutorial1/
|
.. _Tutorial 1: http://www.djangoproject.com/documentation/tutorial1/
|
||||||
|
|
||||||
Philosophy
|
.. admonition:: Philosophy
|
||||||
==========
|
|
||||||
|
|
||||||
Generating admin sites for your staff or clients to add, change and delete
|
Generating admin sites for your staff or clients to add, change and delete
|
||||||
content is tedious work that doesn't require much creativity. For that reason,
|
content is tedious work that doesn't require much creativity. For that reason,
|
||||||
Django entirely automates creation of admin interfaces for models.
|
Django entirely automates creation of admin interfaces for models.
|
||||||
|
|
||||||
Django was written in a newsroom environment, with a very clear separation
|
Django was written in a newsroom environment, with a very clear separation
|
||||||
between "content publishers" and the "public" site. Site managers use the
|
between "content publishers" and the "public" site. Site managers use the
|
||||||
system to add news stories, events, sports scores, etc., and that content is
|
system to add news stories, events, sports scores, etc., and that content is
|
||||||
displayed on the public site. Django solves the problem of creating a unified
|
displayed on the public site. Django solves the problem of creating a unified
|
||||||
interface for site administrators to edit content.
|
interface for site administrators to edit content.
|
||||||
|
|
||||||
The admin isn't necessarily intended to be used by site visitors; it's for site
|
The admin isn't necessarily intended to be used by site visitors; it's for site
|
||||||
managers.
|
managers.
|
||||||
|
|
||||||
Start the development server
|
Start the development server
|
||||||
============================
|
============================
|
||||||
|
|
Loading…
Reference in New Issue