Changeset 8043
- Timestamp:
- 07/21/08 22:01:21 (2 months ago)
- Files:
-
- django/trunk/docs/api_stability.txt (modified) (2 diffs)
- django/trunk/docs/authentication.txt (modified) (3 diffs)
- django/trunk/docs/csrf.txt (modified) (3 diffs)
- django/trunk/docs/db-api.txt (modified) (1 diff)
- django/trunk/docs/django-admin.txt (modified) (1 diff)
- django/trunk/docs/forms.txt (modified) (5 diffs)
- django/trunk/docs/i18n.txt (modified) (1 diff)
- django/trunk/docs/install.txt (modified) (2 diffs)
- django/trunk/docs/release_notes_0.95.txt (modified) (2 diffs)
- django/trunk/docs/templates.txt (modified) (1 diff)
- django/trunk/docs/tutorial03.txt (modified) (1 diff)
- django/trunk/docs/url_dispatch.txt (modified) (2 diffs)
Legend:
- Unmodified
- Added
- Removed
- Modified
- Copied
- Moved
django/trunk/docs/api_stability.txt
r8020 r8043 60 60 - `Request/response objects`_. 61 61 62 - `Sending e mail`_.62 - `Sending e-mail`_. 63 63 64 64 - `Sessions`_. … … 109 109 .. _redirects: ../redirects/ 110 110 .. _request/response objects: ../request_response/ 111 .. _sending e mail: ../email/111 .. _sending e-mail: ../email/ 112 112 .. _sessions: ../sessions/ 113 113 .. _settings: ../settings/ django/trunk/docs/authentication.txt
r8020 r8043 632 632 633 633 Allows a user to reset their password, and sends them the new password 634 in an e mail.634 in an e-mail. 635 635 636 636 **Optional arguments:** … … 641 641 642 642 * ``email_template_name``: The full name of a template to use for 643 generating the e mail with the new password. This will default to643 generating the e-mail with the new password. This will default to 644 644 ``registration/password_reset_email.html`` if not supplied. 645 645 … … 697 697 698 698 * ``django.contrib.auth.forms.PasswordResetForm``: A form for resetting a 699 user's password and e mailing the new password to them.699 user's password and e-mailing the new password to them. 700 700 701 701 * ``django.contrib.auth.forms.UserCreationForm``: A form for creating a django/trunk/docs/csrf.txt
r7294 r8043 5 5 The CsrfMiddleware class provides easy-to-use protection against 6 6 `Cross Site Request Forgeries`_. This type of attack occurs when a malicious 7 web site creates a link or form button that is intended to perform some action8 on your web site, using the credentials of a logged-in user who is tricked7 Web site creates a link or form button that is intended to perform some action 8 on your Web site, using the credentials of a logged-in user who is tricked 9 9 into clicking on the link in their browser. 10 10 … … 39 39 isn't, the user will get a 403 error. 40 40 41 This ensures that only forms that have originated from your web site41 This ensures that only forms that have originated from your Web site 42 42 can be used to POST data back. 43 43 … … 48 48 49 49 POST requests that are not accompanied by a session cookie are not protected, 50 but they do not need to be protected, since the 'attacking' web site50 but they do not need to be protected, since the 'attacking' Web site 51 51 could make these kind of requests anyway. 52 52 django/trunk/docs/db-api.txt
r8001 r8043 464 464 ``extra()`` calls, Django will not inspect these fragments to see if they need 465 465 to be rewritten because of changes in the merged query. So test the effects 466 carefully. Also reali se that if you are combining two ``QuerySets`` with466 carefully. Also realize that if you are combining two ``QuerySets`` with 467 467 ``|``, you cannot use ``extra(select=...)`` or ``extra(where=...)`` on *both* 468 468 ``QuerySets``. You can only use those calls on one or the other (Django will django/trunk/docs/django-admin.txt
r7844 r8043 396 396 Runs over the entire source tree of the current directory and pulls out all 397 397 strings marked for translation. It creates (or updates) a message file in the 398 conf/locale (in the django tree) or locale (for project and application)398 conf/locale (in the Django tree) or locale (for project and application) 399 399 directory. After making changes to the messages files you need to compile them 400 400 with ``compilemessages`` for use with the builtin gettext support. See the django/trunk/docs/forms.txt
r8029 r8043 1558 1558 --------------------------------- 1559 1559 1560 Form validation happens when the data is cleaned. If you want to customi se1560 Form validation happens when the data is cleaned. If you want to customize 1561 1561 this process, there are various places you can change, each one serving a 1562 1562 different purpose. Three types of cleaning methods are run during form … … 1569 1569 problem with the data it is processing, passing the relevant error message to 1570 1570 the ``ValidationError`` constructor. If no ``ValidationError`` is raised, the 1571 method should return the cleaned (normali sed) data as a Python object.1571 method should return the cleaned (normalized) data as a Python object. 1572 1572 1573 1573 If you detect multiple errors during a cleaning method and wish to signal all … … 1602 1602 any validation that requires access to multiple fields from the form at 1603 1603 once. This is where you might put in things to check that if field ``A`` 1604 is supplied, field ``B`` must contain a valid e mail address and the1604 is supplied, field ``B`` must contain a valid e-mail address and the 1605 1605 like. The data that this method returns is the final ``cleaned_data`` 1606 1606 attribute for the form, so don't forget to return the full list of … … 1724 1724 HTML - Django doesn't add a class definition, or any other widget-specific 1725 1725 attributes. This means that all 'TextInput' widgets will appear the same 1726 on your web page.1726 on your Web page. 1727 1727 1728 1728 If you want to make one widget look different to another, you need to … … 1748 1748 <tr><th>Comment:</th><td><input type="text" name="comment" /></td></tr> 1749 1749 1750 On a real web page, you probably don't want every widget to look the same. You1750 On a real Web page, you probably don't want every widget to look the same. You 1751 1751 might want a larger input element for the comment, and you might want the 1752 1752 'name' widget to have some special CSS class. To do this, you specify a django/trunk/docs/i18n.txt
r7844 r8043 889 889 used to differentiate between different programs that store their data 890 890 in a common message-file library (usually ``/usr/share/locale/``). The 891 ``django`` domain is used for python and template translation strings891 ``django`` domain is used for Python and template translation strings 892 892 and is loaded into the global translation catalogs. The ``djangojs`` 893 893 domain is only used for JavaScript translation catalogs to make sure django/trunk/docs/install.txt
r7361 r8043 19 19 20 20 If you just want to experiment with Django, skip ahead to the next 21 section; Django includes a lightweight web server you can use for21 section; Django includes a lightweight Web server you can use for 22 22 testing, so you won't need to set up Apache until you're ready to 23 23 deploy Django in production. … … 65 65 66 66 * If you're using SQLite and either Python 2.3 or Python 2.4, you'll need 67 pysqlite_. Use version 2.0.3 or higher. Python 2.5 ships with an sqlite67 pysqlite_. Use version 2.0.3 or higher. Python 2.5 ships with an SQLite 68 68 wrapper in the standard library, so you don't need to install anything extra 69 69 in that case. django/trunk/docs/release_notes_0.95.txt
r7294 r8043 100 100 101 101 Need help resolving a problem with Django? The documentation in the 102 distribution is also available online_ at the `Django website`_. The FAQ_102 distribution is also available online_ at the `Django Web site`_. The FAQ_ 103 103 document is especially recommended, as it contains a number of issues that 104 104 come up time and again. … … 116 116 117 117 .. _online: http://www.djangoproject.com/documentation/0.95/ 118 .. _Django website: http://www.djangoproject.com/118 .. _Django Web site: http://www.djangoproject.com/ 119 119 .. _FAQ: http://www.djangoproject.com/documentation/faq/ 120 120 .. _django-users: http://groups.google.com/group/django-users django/trunk/docs/templates.txt
r7811 r8043 1946 1946 ------------------------ 1947 1947 1948 A collection of template tags that can be useful while designing a website,1948 A collection of template tags that can be useful while designing a Web site, 1949 1949 such as a generator of Lorem Ipsum text. See the `webdesign documentation`_. 1950 1950 django/trunk/docs/tutorial03.txt
r7294 r8043 442 442 * Django will find the match at ``'^polls/'`` 443 443 * It will strip off the matching text (``"polls/"``) and send the remaining 444 text -- ``"34/"`` -- to the 'mysite.polls.urls' urlconf for444 text -- ``"34/"`` -- to the 'mysite.polls.urls' URLconf for 445 445 further processing. 446 446 447 447 Now that we've decoupled that, we need to decouple the 448 'mysite.polls.urls' urlconf by removing the leading "polls/" from each448 'mysite.polls.urls' URLconf by removing the leading "polls/" from each 449 449 line:: 450 450 django/trunk/docs/url_dispatch.txt
r7560 r8043 374 374 essentially "roots" a set of URLs below other ones. 375 375 376 For example, here's the URLconf for the `Django website`_ itself. It includes a376 For example, here's the URLconf for the `Django Web site`_ itself. It includes a 377 377 number of other URLconfs:: 378 378 … … 391 391 further processing. 392 392 393 .. _`Django website`: http://www.djangoproject.com/393 .. _`Django Web site`: http://www.djangoproject.com/ 394 394 395 395 Captured parameters
