Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Browse files

Finished tutorial02 and added a link to it from tutorial01

git-svn-id: 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
23 docs/tutorial01.txt
@@ -1,6 +1,8 @@
-Tutorial: Writing your first Django app
+Writing your first Django app, part 1
+By Adrian Holovaty <>
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:
-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:
+.. _part 2 of this tutorial:
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.
-There's much more to come. This document is not finished.
+Customize the admin look and feel
+Clearly having "Django administration" and "" 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 `` 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::
+ "/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
+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
+Django offers another shortcut in this department. Run the command
+`` 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

0 comments on commit c9cc6f8

Please sign in to comment.
Something went wrong with that request. Please try again.