From 90ed9fc91759125cef5b531cb77d6a66208bc1ff Mon Sep 17 00:00:00 2001 From: Adrian Holovaty Date: Sun, 9 Apr 2006 23:17:00 +0000 Subject: [PATCH] magic-removal: Started reworking docs/tutorial01.txt git-svn-id: http://code.djangoproject.com/svn/django/branches/magic-removal@2637 bcc190cf-cafb-0310-a4f2-bffc1f526a37 --- docs/tutorial01.txt | 35 +++++++++++++++++------------------ 1 file changed, 17 insertions(+), 18 deletions(-) diff --git a/docs/tutorial01.txt b/docs/tutorial01.txt index e74a43da7e..22b099714f 100644 --- a/docs/tutorial01.txt +++ b/docs/tutorial01.txt @@ -6,13 +6,13 @@ By Adrian Holovaty Let's learn by example. -Throughout this tutorial, we'll walk you through the creation of a simple Web -poll application. +Throughout this tutorial, we'll walk you through the creation of a basic +blogging application. It'll consist of two parts: -* A public site that lets people vote in polls and view poll results. -* An admin site that lets you add, change and delete polls behind the scenes. +* A public site that lets people read your blog entries and submit comments. +* An admin site that lets you add, change and delete entries and comments. We'll assume you have `Django installed`_ already. @@ -65,9 +65,9 @@ These files are: The development server ---------------------- -Change into the ``myproject`` directory, if you haven't already, and run the -command ``python manage.py runserver``. You'll see the following output on the -command line:: +Let's verify this worked. Change into the ``myproject`` directory, if you +haven't already, and run the command ``python manage.py runserver``. You'll see +the following output on the command line:: Validating models... 0 errors found. @@ -76,31 +76,30 @@ command line:: Development server is running at http://127.0.0.1:8000/ Quit the server with CONTROL-C (Unix) or CTRL-BREAK (Windows). -(If you get an error about ``DATABASE_ENGINE``, edit your ``settings.py`` file -to change the ``DATABASE_ENGINE`` setting to point to the correct database, and -make sure you have the right database libraries installed -- such as PostgreSQL's -psycopg or MySQL's MySQLdb.) - You've started the Django development server, a lightweight, pure-Python Web -server that builds on the BaseHTTPServer included in Python's standard library. -We've included this with Django so you can develop things rapidly, without -having to deal with configuring Apache until you're ready for production. +server. We've included this with Django so you can develop things rapidly, +without having to deal with configuring Apache until you're ready for +production. -DON'T use this server in anything resembling a production environment. It's -intended only for use while developing. +Now's a good time to note: DON'T use this server in anything resembling a +production environment. It's intended only for use while developing. .. admonition:: Changing the port By default, the ``runserver`` command starts the development server on port 8000. If you want to change the server's port, pass it as a command-line - argument:: + argument. For instance, this command starts the server on port 8080:: python manage.py runserver 8080 + Full docs for the development server are at `django-admin documentation`_. + Now that the server's running, visit http://127.0.0.1:8000/ with your Web browser. You'll see a "Welcome to Django" page, in pleasant, light-blue pastel. It worked! +.. django-admin documentation: http://www.djangoproject.com/documentation/django_admin/ + Database setup --------------