mirrors/django
1
0
Fork 0
mirror of https://github.com/django/django.git synced 2025-07-04 09:49:12 +00:00
Code Issues 32 Releases Wiki Activity

magic-removal: Small improvements to docs/tutorial01.txt

Browse Source 
git-svn-id: http://code.djangoproject.com/svn/django/branches/magic-removal@2725 bcc190cf-cafb-0310-a4f2-bffc1f526a37
This commit is contained in:
Adrian Holovaty 2006-04-23 05:20:31 +00:00
parent 85f4b13804
commit 9bd6bef487
1 changed files with 11 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
docs/tutorial01.txt
View File

@ -60,12 +60,17 @@ Let's look at what ``startproject`` created::
These files are: These files are:
* ``__init__.py``: An empty file that tells Python that this directory
should be considered a Python package. (Read `more about packages`_ in the
official Python docs if you're a Python beginner.)
* ``manage.py``: A command-line utility that lets you interact with this * ``manage.py``: A command-line utility that lets you interact with this
Django project in various ways. Django project in various ways.
* ``settings.py``: Settings/configuration for this Django project. * ``settings.py``: Settings/configuration for this Django project.
* ``urls.py``: The URL declarations for this Django project; a "table of * ``urls.py``: The URL declarations for this Django project; a "table of
contents" of your Django-powered site. contents" of your Django-powered site.
.. _more on packages: http://docs.python.org/tut/node8.html#packages
The development server The development server
---------------------- ----------------------
@ -102,7 +107,7 @@ It worked!
Full docs for the development server are at `django-admin documentation`_. Full docs for the development server are at `django-admin documentation`_.
.. django-admin documentation: http://www.djangoproject.com/documentation/django_admin/ .. _django-admin documentation: http://www.djangoproject.com/documentation/django_admin/
Your first page Your first page
--------------- ---------------
@ -136,8 +141,8 @@ database's connection parameters:
database's interactive prompt. database's interactive prompt.
While you're editing ``settings.py``, take note of the ``INSTALLED_APPS`` While you're editing ``settings.py``, take note of the ``INSTALLED_APPS``
setting towards the bottom of the file. That variable holds the names of all setting towards the bottom of the file. That variable holds the names of all
Django applications that are activated in this Django instance. Apps can be Django applications that are activated in this Django instance. Apps can be
used in multiple projects, and you can package and distribute them for use used in multiple projects, and you can package and distribute them for use
by others in their projects. by others in their projects.
@ -340,7 +345,7 @@ Note the following:
quotes. The author of this tutorial runs PostgreSQL, so the example quotes. The author of this tutorial runs PostgreSQL, so the example
output is in PostgreSQL syntax. output is in PostgreSQL syntax.
* The `sql` command doesn't actually run the SQL in your database - it just * The `sql` command doesn't actually run the SQL in your database - it just
prints it to the screen so that you can see what SQL Django thinks is required. prints it to the screen so that you can see what SQL Django thinks is required.
If you wanted to, you could copy and paste this SQL into your database prompt. If you wanted to, you could copy and paste this SQL into your database prompt.
However, as we will see shortly, Django provides an easier way of committing However, as we will see shortly, Django provides an easier way of committing
@ -370,7 +375,7 @@ Now, run ``syncdb`` again to create those model tables in your database::
The ``syncdb`` command runs the sql from 'sqlall' on your database for all apps The ``syncdb`` command runs the sql from 'sqlall' on your database for all apps
in ``INSTALLED_APPS`` that don't already exist in your database. This creates in ``INSTALLED_APPS`` that don't already exist in your database. This creates
all the tables, initial data and indexes for any apps you have added to your all the tables, initial data and indexes for any apps you have added to your
project since the last time you ran syncdb. ``syncdb`` can be called as often project since the last time you ran syncdb. ``syncdb`` can be called as often
as you like, and it will only ever create the tables that don't exist. as you like, and it will only ever create the tables that don't exist.
@ -518,7 +523,7 @@ Let's jump back into the Python interactive shell by running
>>> p.was_published_today() >>> p.was_published_today()
False False
# Give the Poll a couple of Choices. The create call constructs a new # Give the Poll a couple of Choices. The create call constructs a new
# choice object, does the INSERT statement, adds the choice to the set # choice object, does the INSERT statement, adds the choice to the set
# of available choices and returns the new Choice object. # of available choices and returns the new Choice object.
>>> p = Poll.objects.get(pk=1) >>> p = Poll.objects.get(pk=1)