diff options
| author | Karen Tracey <kmtracey@gmail.com> | 2010-03-02 04:04:23 +0000 |
|---|---|---|
| committer | Karen Tracey <kmtracey@gmail.com> | 2010-03-02 04:04:23 +0000 |
| commit | ecb56cecbddffe7f06e94a08d2d71713d85514e4 (patch) | |
| tree | 2cb82d71a5442f3a5ecb2d8a3b52458e69e3cca5 /docs/ref/templates | |
| parent | 6d7754ba034ef9890b5b18c630c21e7252e664eb (diff) | |
Fixed #12946: Removed an invalid example of url tag usage from the docs.
git-svn-id: http://code.djangoproject.com/svn/django/trunk@12652 bcc190cf-cafb-0310-a4f2-bffc1f526a37
Diffstat (limited to 'docs/ref/templates')
| -rw-r--r-- | docs/ref/templates/builtins.txt | 12 |
1 files changed, 9 insertions, 3 deletions
diff --git a/docs/ref/templates/builtins.txt b/docs/ref/templates/builtins.txt index 1ac86c5d1b..8bc4f8e4f6 100644 --- a/docs/ref/templates/builtins.txt +++ b/docs/ref/templates/builtins.txt @@ -891,12 +891,18 @@ Returns an absolute URL (i.e., a URL without the domain name) matching a given view function and optional parameters. This is a way to output links without violating the DRY principle by having to hard-code URLs in your templates:: - {% url path.to.some_view arg1,arg2,name1=value1 %} + {% url path.to.some_view v1,v2 %} The first argument is a path to a view function in the format ``package.package.module.function``. Additional arguments are optional and -should be comma-separated values that will be used as positional and keyword -arguments in the URL. All arguments required by the URLconf should be present. +should be comma-separated values that will be used as arguments in the URL. +The example above shows passing positional arguments. Alternatively you may +use keyword syntax:: + + {% url path.to.some_view arg1=v1,arg2=v2 %} + +Do not mix both positional and keyword syntax in a single call. All arguments +required by the URLconf should be present. For example, suppose you have a view, ``app_views.client``, whose URLconf takes a client ID (here, ``client()`` is a method inside the views file |
