diff --git a/docs/url_dispatch.txt b/docs/url_dispatch.txt index 3b83a98804..fe09fe18cd 100644 --- a/docs/url_dispatch.txt +++ b/docs/url_dispatch.txt @@ -288,6 +288,37 @@ that in automatically. .. _Django overview: http://www.djangoproject.com/documentation/overview/ +Multiple view prefixes +---------------------- + +In practice, you'll probably end up mixing and matching views to the point +where the views in your ``urlpatterns`` won't have a common prefix. However, +you can still take advantage of the view prefix shortcut to remove duplication. +Just add multiple ``patterns()`` objects together, like this: + +Old:: + + from django.conf.urls.defaults import * + + urlpatterns = patterns( '' + (r'^/?$', 'django.views.generic.date_based.archive_index'), + (r'^(?P\d{4})/(?P[a-z]{3})/$', 'django.views.generic.date_based.archive_month'), + (r'^tag/(?P\w+)/$', 'weblog.views.tag'), + ) + +New:: + + from django.conf.urls.defaults import * + + urlpatterns = patterns('django.views.generic.date_based' + (r'^/?$', 'archive_index'), + (r'^(?P\d{4})/(?P[a-z]{3})/$','archive_month'), + ) + + urlpatterns += patterns('weblog.views', + (r'^tag/(?P\w+)/$', 'tag'), + ) + Including other URLconfs ========================