Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Browse files

Finished tutorial02 and added a link to it from tutorial01

git-svn-id: http://code.djangoproject.com/svn/django/trunk@142 bcc190cf-cafb-0310-a4f2-bffc1f526a37
  • Loading branch information...
commit c9cc6f87f9fb77a3d12db1b5640ac465f80418c3 1 parent 7ade767
@adrianholovaty adrianholovaty authored
Showing with 75 additions and 18 deletions.
  1. +9 −14 docs/tutorial01.txt
  2. +66 −4 docs/tutorial02.txt
View
23 docs/tutorial01.txt
@@ -1,6 +1,8 @@
-=======================================
-Tutorial: Writing your first Django app
-=======================================
+=====================================
+Writing your first Django app, part 1
+=====================================
+
+By Adrian Holovaty <holovaty@gmail.com>
Let's learn by example.
@@ -368,15 +370,8 @@ Let's jump back into the Python interactive shell::
For full details on the database API, see our `Database API reference`_.
-.. _Database API reference: http://www.djangoproject.com/documentation/db_api/
-
-Coming soon
-===========
+When you're comfortable with the API, read `part 2 of this tutorial`_ to get
+Django's automatic admin working.
-The tutorial ends here for the time being. But check back within 48 hours for
-the next installments:
-
-* Using the dynamically-generated admin site
-* Writing public-facing apps
-* Using the cache framework
-* Using the RSS framework
+.. _Database API reference: http://www.djangoproject.com/documentation/db_api/
+.. _part 2 of this tutorial: http://www.djangoproject.com/documentation/tutorial2/
View
70 docs/tutorial02.txt
@@ -434,7 +434,69 @@ default is to display 50 items per page. Change-list pagination, search boxes,
filters, date-hierarchies and column-header-ordering all work together like you
think they should.
-More
-====
-
-There's much more to come. This document is not finished.
+Customize the admin look and feel
+=================================
+
+Clearly having "Django administration" and "mysite.com" at the top of each
+admin page is ridiculous. It's just placeholder text.
+
+That's easy to change, though, using Django's template system.
+
+Open your admin settings file and look at the ``TEMPLATE_DIRS`` setting.
+``TEMPLATE_DIRS`` is a tuple of filesystem directories to check when loading
+Django templates. It's a search path.
+
+The ``django-admin.py startproject`` command automatically prepopulated
+this setting with the location of Django's default admin templates, according
+to where you have Django installed. But let's add an extra line to
+``TEMPLATE_DIRS`` so that it checks a custom directory first, before checking
+the default admin template directory::
+
+ TEMPLATE_DIRS = (
+ "/home/mytemplates/admin",
+ "/usr/lib/python2.3/site-packages/django/conf/admin_templates",
+ )
+
+Now copy the template ``base_site.html`` from within the default Django admin
+template directory, into ``/home/mytemplates/admin`` (or wherever you're
+putting your custom admin templates). Edit the file and replace the generic
+Django stuff with your own site's name as you see fit.
+
+Note that any of Django's default admin templates can be overridden. To
+override a template, just do the same thing you did with ``base_site.html`` --
+copy it from the default directory into your custom directory, and make
+changes.
+
+Customize the admin index page
+==============================
+
+On a similar note, you might want to customize the look and feel of the Django
+admin index page.
+
+By default, it displays all available apps, according to your ``INSTALLED_APPS``
+setting. But the order in which it displays things is random, and you may want
+to make significant changes to the layout. After all, the index is probably the
+most important page of the admin, and it should be easy to use.
+
+The template to customize is ``index.html``. (Do the same as with
+``base_site.html`` in the previous section -- copy it from the default directory
+to your custom template directory.) Edit the file, and you'll see it uses a
+template tag called ``{% get_admin_app_list as app_list %}``. That's the magic
+that retrieves every installed Django app. Instead of using that, you can
+hard-code links to object-specific admin pages in whatever way you think is
+best.
+
+Django offers another shortcut in this department. Run the command
+``django-admin.py adminindex polls`` to get a chunk of template code for
+inclusion in the admin index template. It's a useful starting point.
+
+Coming soon
+===========
+
+The tutorial ends here for the time being. But check back within 48 hours for
+the next installments:
+
+* Writing public-facing apps
+* Using the cache framework
+* Using the RSS framework
+* Using the comments framework
Please sign in to comment.
Something went wrong with that request. Please try again.