Ticket #3333: relative_doc_paths.diff
| File relative_doc_paths.diff, 55.8 kB (added by jacob, 2 years ago) |
|---|
-
docs/add_ons.txt
old new 17 17 The automatic Django administrative interface. For more information, see 18 18 `Tutorial 2`_. 19 19 20 .. _Tutorial 2: http://www.djangoproject.com/documentation/tutorial2/20 .. _Tutorial 2: ../tutorial2/ 21 21 22 22 auth 23 23 ==== … … 26 26 27 27 See the `authentication documentation`_. 28 28 29 .. _authentication documentation: http://www.djangoproject.com/documentation/authentication/29 .. _authentication documentation: ../authentication/ 30 30 31 31 comments 32 32 ======== … … 46 46 47 47 See the `csrf documentation`_. 48 48 49 .. _csrf documentation: http://www.djangoproject.com/documentation/csrf/49 .. _csrf documentation: ../csrf/ 50 50 51 51 formtools 52 52 ========= … … 137 137 138 138 See the `flatpages documentation`_. 139 139 140 .. _flatpages documentation: http://www.djangoproject.com/documentation/flatpages/140 .. _flatpages documentation: ../flatpages/ 141 141 142 142 markup 143 143 ====== … … 157 157 158 158 See the `redirects documentation`_. 159 159 160 .. _redirects documentation: http://www.djangoproject.com/documentation/redirects/160 .. _redirects documentation: ../redirects/ 161 161 162 162 sites 163 163 ===== … … 168 168 169 169 See the `sites documentation`_. 170 170 171 .. _sites documentation: http://www.djangoproject.com/documentation/sites/171 .. _sites documentation: ../sites/ 172 172 173 173 sitemaps 174 174 ======== … … 177 177 178 178 See the `sitemaps documentation`_. 179 179 180 .. _sitemaps documentation: http://www.djangoproject.com/documentation/sitemaps/180 .. _sitemaps documentation: ../sitemaps/ 181 181 182 182 syndication 183 183 =========== … … 186 186 187 187 See the `syndication documentation`_. 188 188 189 .. _syndication documentation: http://www.djangoproject.com/documentation/syndication/189 .. _syndication documentation: ../syndication/ 190 190 191 191 Other add-ons 192 192 ============= -
docs/apache_auth.txt
old new 65 65 SetEnv DJANGO_SETTINGS_MODULE mysite.settings 66 66 PythonOption DJANGO_SETTINGS_MODULE mysite.settings 67 67 68 .. _authentication system: http://www.djangoproject.com/documentation/authentication/68 .. _authentication system: ../authentication/ 69 69 .. _Subversion: http://subversion.tigris.org/ 70 70 .. _mod_dav: http://httpd.apache.org/docs/2.0/mod/mod_dav.html 71 .. _custom permissions: http://www.djangoproject.com/documentation/authentication/#custom-permissions71 .. _custom permissions: ../authentication/#custom-permissions -
docs/api_stability.txt
old new 98 98 rewrite before Django 1.0. Even if the change isn't quite that drastic, 99 99 there will at least be moderate changes. 100 100 101 .. _caching: http://www.djangoproject.com/documentation/cache/102 .. _custom template tags and libraries: http://www.djangoproject.com/documentation/templates_python/103 .. _database lookup: http://www.djangoproject.com/documentation/db_api/104 .. _django-admin utility: http://www.djangoproject.com/documentation/django_admin/105 .. _fastcgi integration: http://www.djangoproject.com/documentation/fastcgi/106 .. _flatpages: http://www.djangoproject.com/documentation/flatpages/107 .. _generic views: http://www.djangoproject.com/documentation/generic_views/108 .. _internationalization: http://www.djangoproject.com/documentation/i18n/109 .. _legacy database integration: http://www.djangoproject.com/documentation/legacy_databases/110 .. _model definition: http://www.djangoproject.com/documentation/model_api/111 .. _mod_python integration: http://www.djangoproject.com/documentation/modpython/112 .. _redirects: http://www.djangoproject.com/documentation/redirects/113 .. _request/response objects: http://www.djangoproject.com/documentation/request_response/114 .. _sending email: http://www.djangoproject.com/documentation/email/115 .. _sessions: http://www.djangoproject.com/documentation/sessions/116 .. _settings: http://www.djangoproject.com/documentation/settings/117 .. _syndication: http://www.djangoproject.com/documentation/syndication/118 .. _template language: http://www.djangoproject.com/documentation/templates/119 .. _transactions: http://www.djangoproject.com/documentation/transactions/120 .. _url dispatch: http://www.djangoproject.com/documentation/url_dispatch/121 .. _forms and validation: http://www.djangoproject.com/documentation/forms/122 .. _serialization: http://www.djangoproject.com/documentation/serialization/123 .. _authentication: http://www.djangoproject.com/documentation/authentication/101 .. _caching: ../cache/ 102 .. _custom template tags and libraries: ../templates_python/ 103 .. _database lookup: ../db_api/ 104 .. _django-admin utility: ../django_admin/ 105 .. _fastcgi integration: ../fastcgi/ 106 .. _flatpages: ../flatpages/ 107 .. _generic views: ../generic_views/ 108 .. _internationalization: ../i18n/ 109 .. _legacy database integration: ../legacy_databases/ 110 .. _model definition: ../model_api/ 111 .. _mod_python integration: ../modpython/ 112 .. _redirects: ../redirects/ 113 .. _request/response objects: ../request_response/ 114 .. _sending email: ../email/ 115 .. _sessions: ../sessions/ 116 .. _settings: ../settings/ 117 .. _syndication: ../syndication/ 118 .. _template language: ../templates/ 119 .. _transactions: ../transactions/ 120 .. _url dispatch: ../url_dispatch/ 121 .. _forms and validation: ../forms/ 122 .. _serialization: ../serialization/ 123 .. _authentication: ../authentication/ -
docs/authentication.txt
old new 144 144 Raises ``django.contrib.auth.models.SiteProfileNotAvailable`` if the current site 145 145 doesn't allow profiles. 146 146 147 .. _Django model: http://www.djangoproject.com/documentation/model_api/148 .. _DEFAULT_FROM_EMAIL: http://www.djangoproject.com/documentation/settings/#default-from-email147 .. _Django model: ../model_api/ 148 .. _DEFAULT_FROM_EMAIL: ../settings/#default-from-email 149 149 150 150 Manager functions 151 151 ~~~~~~~~~~~~~~~~~ … … 271 271 else: 272 272 # Do something for anonymous users. 273 273 274 .. _request objects: http://www.djangoproject.com/documentation/request_response/#httprequest-objects275 .. _session documentation: http://www.djangoproject.com/documentation/sessions/274 .. _request objects: ../request_response/#httprequest-objects 275 .. _session documentation: ../sessions/ 276 276 277 277 How to log a user in 278 278 -------------------- … … 441 441 442 442 {% endblock %} 443 443 444 .. _forms documentation: http://www.djangoproject.com/documentation/forms/445 .. _site framework docs: http://www.djangoproject.com/documentation/sites/444 .. _forms documentation: ../forms/ 445 .. _site framework docs: ../sites/ 446 446 447 447 Limiting access to logged-in users that pass a test 448 448 --------------------------------------------------- … … 544 544 def limited_object_detail(*args, **kwargs): 545 545 return object_detail(*args, **kwargs) 546 546 547 .. _generic view: http://www.djangoproject.com/documentation/generic_views/547 .. _generic view: ../generic_views/ 548 548 549 549 Permissions 550 550 =========== … … 606 606 The only thing this does is create those extra permissions when you run 607 607 ``syncdb``. 608 608 609 .. _model Meta attribute: http://www.djangoproject.com/documentation/model_api/#meta-options609 .. _model Meta attribute: ../model_api/#meta-options 610 610 611 611 API reference 612 612 ------------- … … 645 645 setting contains ``"django.core.context_processors.auth"``, which is default. 646 646 For more, see the `RequestContext docs`_. 647 647 648 .. _RequestContext docs: http://www.djangoproject.com/documentation/templates_python/#subclassing-context-requestcontext648 .. _RequestContext docs: ../templates_python/#subclassing-context-requestcontext 649 649 650 650 Users 651 651 ----- … … 691 691 <p>You don't have permission to do anything in the foo app.</p> 692 692 {% endif %} 693 693 694 .. _template context: http://www.djangoproject.com/documentation/templates_python/694 .. _template context: ../templates_python/ 695 695 696 696 Groups 697 697 ====== … … 756 756 Finally, note that this messages framework only works with users in the user 757 757 database. To send messages to anonymous users, use the `session framework`_. 758 758 759 .. _session framework: http://www.djangoproject.com/documentation/sessions/759 .. _session framework: ../sessions/ 760 760 761 761 Other authentication sources 762 762 ============================ -
docs/cache.txt
old new 250 250 251 251 See the `middleware documentation`_ for more on middleware. 252 252 253 .. _`middleware documentation`: http://www.djangoproject.com/documentation/middleware/253 .. _`middleware documentation`: ../middleware/ 254 254 255 255 The per-view cache 256 256 ================== -
docs/contributing.txt
old new 186 186 `i18n documentation`_. 187 187 188 188 .. _Django i18n mailing list: http://groups.google.com/group/django-i18n/ 189 .. _i18n documentation: http://www.djangoproject.com/documentation/i18n/189 .. _i18n documentation: ../i18n/ 190 190 191 191 Coding style 192 192 ============ … … 311 311 testing applications. See `Testing Django applications`_ for an explanation of 312 312 how to write new tests. 313 313 314 .. _Testing Django applications: http://www.djangoproject.com/documentation/testing/314 .. _Testing Django applications: ../testing/ 315 315 316 316 Running the unit tests 317 317 ---------------------- … … 544 544 .. _community page: http://www.djangoproject.com/community/ 545 545 .. _ticket tracker: http://code.djangoproject.com/newticket 546 546 .. _django-developers: http://groups.google.com/group/django-developers 547 .. _FAQ: http://www.djangoproject.com/documentation/faq/547 .. _FAQ: ../faq/ 548 548 .. _search the tracker: http://code.djangoproject.com/search 549 549 .. _django-users: http://groups.google.com/group/django-users 550 550 .. _`#django`: irc://irc.freenode.net/django 551 551 .. _list of tickets with patches: http://code.djangoproject.com/report/12 552 552 .. _PEP 8: http://www.python.org/peps/pep-0008.html 553 .. _i18n documentation: http://www.djangoproject.com/documentation/i18n/553 .. _i18n documentation: ../i18n/ 554 554 .. _i18n branch: http://code.djangoproject.com/browser/django/branches/i18n 555 555 .. _`tags/releases`: http://code.djangoproject.com/browser/django/tags/releases -
docs/design_philosophies.txt
old new 186 186 187 187 This is the philosophy behind `template inheritance`_. 188 188 189 .. _template inheritance: http://www.djangoproject.com/documentation/templates/#template-inheritance189 .. _template inheritance: ./templates/#template-inheritance 190 190 191 191 Be decoupled from HTML 192 192 ---------------------- -
docs/django-admin.txt
old new 53 53 Use admin-index template snippets if you want to customize the look and feel of 54 54 your admin's index page. See `Tutorial 2`_ for more information. 55 55 56 .. _Tutorial 2: http://www.djangoproject.com/documentation/tutorial2/56 .. _Tutorial 2: ../tutorial2/ 57 57 58 58 createcachetable [tablename] 59 59 ---------------------------- … … 61 61 Creates a cache table named ``tablename`` for use with the database cache 62 62 backend. See the `cache documentation`_ for more information. 63 63 64 .. _cache documentation: http://www.djangoproject.com/documentation/cache/64 .. _cache documentation: ../cache/ 65 65 66 66 dbshell 67 67 ------- … … 190 190 you want to configure Django to serve static media, read the `serving static files`_ 191 191 documentation. 192 192 193 .. _serving static files: http://www.djangoproject.com/documentation/static_files/193 .. _serving static files: ../static_files/ 194 194 195 195 Turning off auto-reload 196 196 ~~~~~~~~~~~~~~~~~~~~~~~ -
docs/email.txt
old new 101 101 102 102 This method exists for convenience and readability. 103 103 104 .. _ADMINS setting: http://www.djangoproject.com/documentation/settings/#admins105 .. _EMAIL_SUBJECT_PREFIX setting: http://www.djangoproject.com/documentation/settings/#email-subject-prefix106 .. _SERVER_EMAIL setting: http://www.djangoproject.com/documentation/settings/#server-email104 .. _ADMINS setting: ../settings/#admins 105 .. _EMAIL_SUBJECT_PREFIX setting: ../settings/#email-subject-prefix 106 .. _SERVER_EMAIL setting: ../settings/#server-email 107 107 108 108 mail_managers() function 109 109 ======================== … … 114 114 115 115 mail_managers(subject, message, fail_silently=False) 116 116 117 .. _MANAGERS setting: http://www.djangoproject.com/documentation/settings/#managers117 .. _MANAGERS setting: ../settings/#managers 118 118 119 119 Examples 120 120 ======== -
docs/faq.txt
old new 63 63 The framework cleanly separates components such as its database layer and 64 64 application layer. And it ships with a simple-yet-powerful `cache framework`_. 65 65 66 .. _`cache framework`: http://www.djangoproject.com/documentation/cache/66 .. _`cache framework`: ../cache/ 67 67 68 68 Who's behind this? 69 69 ------------------ … … 191 191 192 192 We've documented our philosophies on the `design philosophies page`_. 193 193 194 .. _design philosophies page: http://www.djangoproject.com/documentation/design_philosophies/194 .. _design philosophies page: ../design_philosophies/ 195 195 196 196 Do you have any of those nifty "screencast" things? 197 197 --------------------------------------------------- … … 277 277 run into trouble. 278 278 279 279 .. _`Download the code`: http://www.djangoproject.com/download/ 280 .. _`installation guide`: http://www.djangoproject.com/documentation/install/281 .. _tutorial: http://www.djangoproject.com/documentation/tutorial1/282 .. _documentation: http://www.djangoproject.com/documentation/280 .. _`installation guide`: ../install/ 281 .. _tutorial: ../tutorial1/ 282 .. _documentation: ../ 283 283 .. _ask questions: http://www.djangoproject.com/community/ 284 284 285 285 How do I fix the "install a later version of setuptools" error? … … 337 337 the development Web server that comes with Django. Things should Just Work. 338 338 339 339 .. _WSGI: http://www.python.org/peps/pep-0333.html 340 .. _How to use Django with FastCGI: http://www.djangoproject.com/documentation/fastcgi/340 .. _How to use Django with FastCGI: ../fastcgi/ 341 341 .. _server arrangements wiki page: http://code.djangoproject.com/wiki/ServerArrangements 342 342 343 343 How do I install mod_python on Windows? … … 464 464 465 465 Yes. See `Integrating with a legacy database`_. 466 466 467 .. _`Integrating with a legacy database`: http://www.djangoproject.com/documentation/legacy_databases/467 .. _`Integrating with a legacy database`: ../legacy_databases/ 468 468 469 469 If I make changes to a model, how do I update the database? 470 470 ----------------------------------------------------------- … … 511 511 As explained in the `SQL initial data file`_ documentation, this SQL file can 512 512 contain arbitrary SQL, so you can make any sorts of changes you need to make. 513 513 514 .. _SQL initial data file: http://www.djangoproject.com/documentation/model_api/#providing-initial-sql-data514 .. _SQL initial data file: ../model_api/#providing-initial-sql-data 515 515 516 516 Why is Django leaking memory? 517 517 ----------------------------- … … 592 592 See `serving the admin files`_ in the "How to use Django with mod_python" 593 593 documentation. 594 594 595 .. _serving the admin files: http://www.djangoproject.com/documentation/modpython/#serving-the-admin-files595 .. _serving the admin files: ../modpython/#serving-the-admin-files 596 596 597 597 My "list_filter" contains a ManyToManyField, but the filter doesn't display. 598 598 ---------------------------------------------------------------------------- … … 630 630 like to make should be possible by editing the stylesheet. We've got a 631 631 `guide to the CSS used in the admin`_ to get you started. 632 632 633 .. _`guide to the CSS used in the admin`: http://www.djangoproject.com/documentation/admin_css/633 .. _`guide to the CSS used in the admin`: ../admin_css/ 634 634 635 635 How do I create users without having to edit password hashes? 636 636 ------------------------------------------------------------- … … 640 640 641 641 You can also use the Python API. See `creating users`_ for full info. 642 642 643 .. _creating users: http://www.djangoproject.com/documentation/authentication/#creating-users643 .. _creating users: ../authentication/#creating-users 644 644 645 645 Contributing code 646 646 ================= … … 651 651 Thanks for asking! We've written an entire document devoted to this question. 652 652 It's titled `Contributing to Django`_. 653 653 654 .. _Contributing to Django: http://www.djangoproject.com/documentation/contributing/654 .. _Contributing to Django: ../contributing/ 655 655 656 656 I submitted a bug fix in the ticket system several weeks ago. Why are you ignoring my patch? 657 657 -------------------------------------------------------------------------------------------- -
docs/fastcgi.txt
old new 17 17 process doesn't run inside the Web server process, but in a separate, 18 18 persistent process. 19 19 20 .. _current preferred setup: http://www.djangoproject.com/documentation/modpython/20 .. _current preferred setup: ../modpython/ 21 21 .. _Apache: http://httpd.apache.org/ 22 22 .. _mod_python: http://www.modpython.org/ 23 23 .. _mod_perl: http://perl.apache.org/ -
docs/flatpages.txt
old new 29 29 to your MIDDLEWARE_CLASSES_ setting. 30 30 3. Run the command ``manage.py syncdb``. 31 31 32 .. _INSTALLED_APPS: http://www.djangoproject.com/documentation/settings/#installed-apps33 .. _MIDDLEWARE_CLASSES: http://www.djangoproject.com/documentation/settings/#middleware-classes32 .. _INSTALLED_APPS: ../settings/#installed-apps 33 .. _MIDDLEWARE_CLASSES: ../settings/#middleware-classes 34 34 35 35 How it works 36 36 ============ … … 63 63 64 64 For more on middleware, read the `middleware docs`_. 65 65 66 .. _SITE_ID: http://www.djangoproject.com/documentation/settings/#site-id67 .. _RequestContext: http://www.djangoproject.com/documentation/templates_python/#subclassing-context-djangocontext68 .. _middleware docs: http://www.djangoproject.com/documentation/middleware/66 .. _SITE_ID: ../settings/#site-id 67 .. _RequestContext: ../templates_python/#subclassing-context-djangocontext 68 .. _middleware docs: ../middleware/ 69 69 70 70 How to add, change and delete flatpages 71 71 ======================================= … … 84 84 `django/contrib/flatpages/models.py`_. You can access flatpage objects via the 85 85 `Django database API`_. 86 86 87 .. _Django model: http://www.djangoproject.com/documentation/model_api/87 .. _Django model: ../model_api/ 88 88 .. _django/contrib/flatpages/models.py: http://code.djangoproject.com/browser/django/trunk/django/contrib/flatpages/models.py 89 .. _Django database API: http://www.djangoproject.com/documentation/db_api/89 .. _Django database API: ../db_api/ 90 90 91 91 Flatpage templates 92 92 ================== -
docs/forms.txt
old new 14 14 If you have legacy form/manipulator code, read the "Migration plan" section in 15 15 that document to understand how we're making the switch. 16 16 17 .. _newforms documentation: http://www.djangoproject.com/documentation/newforms/17 .. _newforms documentation: ../newforms/ 18 18 19 19 Introduction 20 20 ============ … … 665 665 the executable specified in the ``JING_PATH`` setting (see the settings_ 666 666 document for more details). 667 667 668 .. _`generic views`: http://www.djangoproject.com/documentation/generic_views/669 .. _`models API`: http://www.djangoproject.com/documentation/model_api/670 .. _settings: http://www.djangoproject.com/documentation/settings/668 .. _`generic views`: ../generic_views/ 669 .. _`models API`: ../model_api/ 670 .. _settings: ../settings/ -
docs/generic_views.txt
old new 71 71 ``extra_context`` that is always fresh you need to wrap it in a function or 72 72 lambda that returns the QuerySet. 73 73 74 .. _database API docs: http://www.djangoproject.com/documentation/db_api/74 .. _database API docs: ../db_api/ 75 75 76 76 "Simple" generic views 77 77 ====================== … … 223 223 by ``date_field``. For example, if ``num_latest`` is ``10``, then 224 224 ``latest`` will be a list of the latest 10 objects in ``queryset``. 225 225 226 .. _RequestContext docs: http://www.djangoproject.com/documentation/templates_python/#subclassing-context-djangocontext226 .. _RequestContext docs: ../templates_python/#subclassing-context-djangocontext 227 227 228 228 ``django.views.generic.date_based.archive_year`` 229 229 ------------------------------------------------ … … 916 916 See the `manipulator and formfield documentation`_ for more information 917 917 about using ``FormWrapper`` objects in templates. 918 918 919 .. _authentication system: http://www.djangoproject.com/documentation/authentication/920 .. _manipulator and formfield documentation: http://www.djangoproject.com/documentation/forms/919 .. _authentication system: ../authentication/ 920 .. _manipulator and formfield documentation: ../forms/ 921 921 922 922 ``django.views.generic.create_update.update_object`` 923 923 ---------------------------------------------------- -
docs/i18n.txt
old new 53 53 You'll probably also want to remove ``'django.core.context_processors.i18n'`` 54 54 from your ``TEMPLATE_CONTEXT_PROCESSORS`` setting. 55 55 56 .. _documentation for USE_I18N: http://www.djangoproject.com/documentation/settings/#use-i18n56 .. _documentation for USE_I18N: ../settings/#use-i18n 57 57 58 58 How to specify translation strings 59 59 ================================== … … 175 175 verbose_name = _('my thing') 176 176 verbose_name_plural = _('mythings') 177 177 178 .. _Django models: http://www.djangoproject.com/documentation/model_api/178 .. _Django models: ../model_api/ 179 179 180 180 Pluralization 181 181 ~~~~~~~~~~~~~ … … 274 274 In this case, both the tag and the filter will see the already-translated 275 275 string, so they don't need to be aware of translations. 276 276 277 .. _Django templates: http://www.djangoproject.com/documentation/templates_python/277 .. _Django templates: ../templates_python/ 278 278 279 279 How to create language files 280 280 ============================ … … 394 394 please let us know! See `Submitting and maintaining translations`_ for 395 395 the steps to take. 396 396 397 .. _Submitting and maintaining translations: http://www.djangoproject.com/documentation/contributing/397 .. _Submitting and maintaining translations: ../contributing/ 398 398 399 399 How Django discovers language preference 400 400 ======================================== … … 472 472 selection to German and English (and any sublanguage, like de-ch or 473 473 en-us). 474 474 475 .. _LANGUAGES setting: http://www.djangoproject.com/documentation/settings/#languages475 .. _LANGUAGES setting: ../settings/#languages 476 476 477 477 * If you define a custom ``LANGUAGES`` setting, as explained in the 478 478 previous bullet, it's OK to mark the languages as translation strings … … 530 530 ``settings.LANGUAGE_CODE``, while with dynamic (middleware) translation, it's 531 531 in ``request.LANGUAGE_CODE``. 532 532 533 .. _settings file: http://www.djangoproject.com/documentation/settings/534 .. _middleware documentation: http://www.djangoproject.com/documentation/middleware/535 .. _session: http://www.djangoproject.com/documentation/sessions/536 .. _request object: http://www.djangoproject.com/documentation/request_response/#httprequest-objects533 .. _settings file: ../settings/ 534 .. _middleware documentation: ../middleware/ 535 .. _session: ../sessions/ 536 .. _request object: ../request_response/#httprequest-objects 537 537 538 538 The ``set_language`` redirect view 539 539 ================================== … … 599 599 of the settings file to determine this, and a settings file doesn't exist 600 600 if you're manually configuring your settings.) 601 601 602 .. _settings documentation: http://www.djangoproject.com/documentation/settings/#using-settings-without-the-django-settings-module-environment-variable602 .. _settings documentation: ../settings/#using-settings-without-the-django-settings-module-environment-variable 603 603 604 604 All message file repositories are structured the same way. They are: 605 605 -
docs/install.txt
old new 38 38 .. _Apache: http://httpd.apache.org/ 39 39 .. _mod_python: http://www.modpython.org/ 40 40 .. _WSGI: http://www.python.org/peps/pep-0333.html 41 .. _How to use Django with mod_python: http://www.djangoproject.com/documentation/modpython/41 .. _How to use Django with mod_python: ../modpython/ 42 42 .. _server-arrangements wiki page: http://code.djangoproject.com/wiki/ServerArrangements 43 43 44 44 Get your database running -
docs/legacy_databases.txt
old new 9 9 This document assumes you know the Django basics, as covered in the 10 10 `official tutorial`_. 11 11 12 .. _official tutorial: http://www.djangoproject.com/documentation/tutorial1/12 .. _official tutorial: ../tutorial1/ 13 13 14 14 Give Django your database parameters 15 15 ==================================== … … 25 25 * `DATABASE_HOST`_ 26 26 * `DATABASE_PORT`_ 27 27 28 .. _settings file: http://www.djangoproject.com/documentation/settings/29 .. _DATABASE_NAME: http://www.djangoproject.com/documentation/settings/#database-name30 .. _DATABASE_ENGINE: http://www.djangoproject.com/documentation/settings/#database-engine31 .. _DATABASE_USER: http://www.djangoproject.com/documentation/settings/#database-user32 .. _DATABASE_PASSWORD: http://www.djangoproject.com/documentation/settings/#database-password33 .. _DATABASE_HOST: http://www.djangoproject.com/documentation/settings/#database-host34 .. _DATABASE_PORT: http://www.djangoproject.com/documentation/settings/#database-port28 .. _settings file: ../settings/ 29 .. _DATABASE_NAME: ../settings/#database-name 30 .. _DATABASE_ENGINE: ../settings/#database-engine 31 .. _DATABASE_USER: ../settings/#database-user 32 .. _DATABASE_PASSWORD: ../settings/#database-password 33 .. _DATABASE_HOST: ../settings/#database-host 34 .. _DATABASE_PORT: ../settings/#database-port 35 35 36 36 Auto-generate the models 37 37 ======================== … … 52 52 the Python package that holds your app. Then add the app to your 53 53 ``INSTALLED_APPS`` setting. 54 54 55 .. _django-admin.py documentation: http://www.djangoproject.com/documentation/django_admin/55 .. _django-admin.py documentation: ../django_admin/ 56 56 57 57 Install the core Django tables 58 58 ============================== -
docs/middleware.txt
old new 47 47 cached for as long as the ``CACHE_MIDDLEWARE_SECONDS`` setting defines. See 48 48 the `cache documentation`_. 49 49 50 .. _`cache documentation`: http://www.djangoproject.com/documentation/cache/#the-per-site-cache50 .. _`cache documentation`: ../cache/#the-per-site-cache 51 51 52 52 django.middleware.common.CommonMiddleware 53 53 ----------------------------------------- … … 123 123 124 124 Enables session support. See the `session documentation`_. 125 125 126 .. _`session documentation`: http://www.djangoproject.com/documentation/sessions/126 .. _`session documentation`: ../sessions/ 127 127 128 128 django.contrib.auth.middleware.AuthenticationMiddleware 129 129 ------------------------------------------------------- … … 131 131 Adds the ``user`` attribute, representing the currently-logged-in user, to 132 132 every incoming ``HttpRequest`` object. See `Authentication in Web requests`_. 133 133 134 .. _Authentication in Web requests: http://www.djangoproject.com/documentation/authentication/#authentication-in-web-requests134 .. _Authentication in Web requests: ../authentication/#authentication-in-web-requests 135 135 136 136 django.middleware.transaction.TransactionMiddleware 137 137 --------------------------------------------------- … … 147 147 148 148 See the `transaction management documentation`_. 149 149 150 .. _`transaction management documentation`: http://www.djangoproject.com/documentation/transactions/150 .. _`transaction management documentation`: ../transactions/ 151 151 152 152 Writing your own middleware 153 153 =========================== -
docs/modpython.txt
old new 20 20 .. _mod_perl: http://perl.apache.org/ 21 21 .. _prefork MPM: http://httpd.apache.org/docs/2.2/mod/prefork.html 22 22 .. _worker MPM: http://httpd.apache.org/docs/2.2/mod/worker.html 23 .. _How to use Django with FastCGI: http://www.djangoproject.com/documentation/fastcgi/23 .. _How to use Django with FastCGI: ../fastcgi/ 24 24 25 25 Basic configuration 26 26 =================== -
docs/outputting_csv.txt
old new 24 24 25 25 For more information on the CSV library, see the `CSV library docs`_. 26 26 27 .. _Request and response objects: http://www.djangoproject.com/documentation/request_response/27 .. _Request and response objects: ../request_response/ 28 28 .. _CSV library docs: http://www.python.org/doc/current/lib/module-csv.html 29 29 30 30 Here's an example:: … … 115 115 there aren't any problems with quotes. If you can be certain your data doesn't 116 116 have single or double quotes in it, you can remove the ``addslashes`` filters. 117 117 118 .. _Django template system: http://www.djangoproject.com/documentation/templates/119 .. _addslashes template filter: http://www.djangoproject.com/documentation/templates/#addslashes118 .. _Django template system: ../templates/ 119 .. _addslashes template filter: ../templates/#addslashes -
docs/outputting_pdf.txt
old new 43 43 For more information on ``HttpResponse`` objects, see 44 44 `Request and response objects`_. 45 45 46 .. _Request and response objects: http://www.djangoproject.com/documentation/request_response/46 .. _Request and response objects: ../request_response/ 47 47 48 48 Here's a "Hello World" example:: 49 49 -
docs/overview.txt
old new 11 11 reference. Please see our more-detailed Django documentation_ when you're ready 12 12 to start a project. 13 13 14 .. _documentation: http://www.djangoproject.com/documentation/14 .. _documentation: ../ 15 15 16 16 Design your model 17 17 ================= -
docs/redirects.txt
old new 15 15 to your MIDDLEWARE_CLASSES_ setting. 16 16 3. Run the command ``manage.py syncdb``. 17 17 18 .. _INSTALLED_APPS: http://www.djangoproject.com/documentation/settings/#installed-apps19 .. _MIDDLEWARE_CLASSES: http://www.djangoproject.com/documentation/settings/#middleware-classes18 .. _INSTALLED_APPS: ../settings/#installed-apps 19 .. _MIDDLEWARE_CLASSES: ../settings/#middleware-classes 20 20 21 21 How it works 22 22 ============ … … 46 46 47 47 For more on middleware, read the `middleware docs`_. 48 48 49 .. _SITE_ID: http://www.djangoproject.com/documentation/settings/#site-id50 .. _middleware docs: http://www.djangoproject.com/documentation/middleware/49 .. _SITE_ID: ../settings/#site-id 50 .. _middleware docs: ../middleware/ 51 51 52 52 How to add, change and delete redirects 53 53 ======================================= … … 66 66 `django/contrib/redirects/models.py`_. You can access redirect 67 67 objects via the `Django database API`_. 68 68 69 .. _Django model: http://www.djangoproject.com/documentation/model_api/69 .. _Django model: ../model_api/ 70 70 .. _django/contrib/redirects/models.py: http://code.djangoproject.com/browser/django/trunk/django/contrib/redirects/models.py 71 .. _Django database API: http://www.djangoproject.com/documentation/db_api/71 .. _Django database API: ../db_api/ -
docs/request_response.txt
old new 117 117 ``AuthenticationMiddleware`` activated. For more, see 118 118 `Authentication in Web requests`_. 119 119 120 .. _Authentication in Web requests: http://www.djangoproject.com/documentation/authentication/#authentication-in-web-requests120 .. _Authentication in Web requests: ../authentication/#authentication-in-web-requests 121 121 122 122 ``session`` 123 123 A readable-and-writable, dictionary-like object that represents the current 124 124 session. This is only available if your Django installation has session 125 125 support activated. See the `session documentation`_ for full details. 126 126 127 .. _`session documentation`: http://www.djangoproject.com/documentation/sessions/127 .. _`session documentation`: ../sessions/ 128 128 129 129 ``raw_post_data`` 130 130 The raw HTTP POST data. This is only useful for advanced processing. Use -
docs/sessions.txt
old new 27 27 ``SessionMiddleware`` line from ``MIDDLEWARE_CLASSES`` and ``'django.contrib.sessions'`` 28 28 from your ``INSTALLED_APPS``. It'll save you a small bit of overhead. 29 29 30 .. _middleware: http://www.djangoproject.com/documentation/middleware/30 .. _middleware: ../middleware/ 31 31 32 32 Using sessions in views 33 33 ======================= … … 290 290 (default), then the session data will only be saved if it has been modified -- 291 291 that is, if any of its dictionary values have been assigned or deleted. 292 292 293 .. _Django settings: http://www.djangoproject.com/documentation/settings/293 .. _Django settings: ../settings/ 294 294 295 295 Technical details 296 296 ================= -
docs/settings.txt
old new 59 59 60 60 django-admin.py runserver --settings=mysite.settings 61 61 62 .. _django-admin.py: http://www.djangoproject.com/documentation/django_admin/62 .. _django-admin.py: ../django_admin/ 63 63 64 64 On the server (mod_python) 65 65 -------------------------- … … 75 75 76 76 Read the `Django mod_python documentation`_ for more information. 77 77 78 .. _Django mod_python documentation: http://www.djangoproject.com/documentation/modpython/78 .. _Django mod_python documentation: ../modpython/ 79 79 80 80 Default settings 81 81 ================ … … 102 102 103 103 For more, see the `diffsettings documentation`_. 104 104 105 .. _diffsettings documentation: http://www.djangoproject.com/documentation/django_admin/#diffsettings105 .. _diffsettings documentation: ../django_admin/#diffsettings 106 106 107 107 Using settings in Python code 108 108 ============================= … … 306 306 307 307 See also DATETIME_FORMAT, TIME_FORMAT, YEAR_MONTH_FORMAT and MONTH_DAY_FORMAT. 308 308 309 .. _allowed date format strings: http://www.djangoproject.com/documentation/templates/#now309 .. _allowed date format strings: ../templates/#now 310 310 311 311 DATETIME_FORMAT 312 312 --------------- … … 319 319 320 320 See also DATE_FORMAT, DATETIME_FORMAT, TIME_FORMAT, YEAR_MONTH_FORMAT and MONTH_DAY_FORMAT. 321 321 322 .. _allowed date format strings: http://www.djangoproject.com/documentation/templates/#now322 .. _allowed date format strings: ../templates/#now 323 323 324 324 DEBUG 325 325 ----- … … 433 433 installation. Each string should be a full Python path to a Python package that 434 434 contains a Django application, as created by `django-admin.py startapp`_. 435 435 436 .. _django-admin.py startapp: http://www.djangoproject.com/documentation/django_admin/#startapp-appname436 .. _django-admin.py startapp: ../django_admin/#startapp-appname 437 437 438 438 INTERNAL_IPS 439 439 ------------ … … 464 464 in standard language format. For example, U.S. English is ``"en-us"``. See the 465 465 `internationalization docs`_. 466 466 467 .. _internationalization docs: http://www.djangoproject.com/documentation/i18n/467 .. _internationalization docs: ../i18n/ 468 468 469 469 LANGUAGES 470 470 --------- … … 612 612 A string representing the full Python import path to your root URLconf. For example: 613 613 ``"mydjangoapps.urls"``. See `How Django processes a request`_. 614 614 615 .. _How Django processes a request: http://www.djangoproject.com/documentation/url_dispatch/#how-django-processes-a-request615 .. _How Django processes a request: ../url_dispatch/#how-django-processes-a-request 616 616 617 617 SECRET_KEY 618 618 ---------- … … 704 704 705 705 See the `site framework docs`_. 706 706 707 .. _site framework docs: http://www.djangoproject.com/documentation/sites/707 .. _site framework docs: ../sites/ 708 708 709 709 TEMPLATE_CONTEXT_PROCESSORS 710 710 --------------------------- … … 760 760 Output, as a string, that the template system should use for invalid (e.g. 761 761 misspelled) variables. See `How invalid variables are handled`_. 762 762 763 .. _How invalid variables are handled: http://www.djangoproject.com/documentation/templates_python/#how-invalid-variables-are-handled763 .. _How invalid variables are handled: ../templates_python/#how-invalid-variables-are-handled 764 764 765 765 TEST_RUNNER 766 766 ----------- … … 798 798 See also DATE_FORMAT, DATETIME_FORMAT, TIME_FORMAT, YEAR_MONTH_FORMAT and 799 799 MONTH_DAY_FORMAT. 800 800 801 .. _allowed date format strings: http://www.djangoproject.com/documentation/templates/#now801 .. _allowed date format strings: ../templates/#now 802 802 803 803 TIME_ZONE 804 804 --------- … … 868 868 See `allowed date format strings`_. See also DATE_FORMAT, DATETIME_FORMAT, 869 869 TIME_FORMAT and MONTH_DAY_FORMAT. 870 870 871 .. _cache docs: http://www.djangoproject.com/documentation/cache/872 .. _middleware docs: http://www.djangoproject.com/documentation/middleware/873 .. _session docs: http://www.djangoproject.com/documentation/sessions/871 .. _cache docs: ../cache/ 872 .. _middleware docs: ../middleware/ 873 .. _session docs: ../sessions/ 874 874 .. _See available choices: http://www.postgresql.org/docs/8.1/static/datetime-keywords.html#DATETIME-TIMEZONE-SET-TABLE 875 .. _template documentation: http://www.djangoproject.com/documentation/templates_python/875 .. _template documentation: ../templates_python/ 876 876 877 877 Creating your own settings 878 878 ========================== -
docs/sitemaps.txt
old new 23 23 It works much like Django's `syndication framework`_. To create a sitemap, just 24 24 write a ``Sitemap`` class and point to it in your URLconf_. 25 25 26 .. _syndication framework: http://www.djangoproject.com/documentation/syndication/27 .. _URLconf: http://www.djangoproject.com/documentation/url_dispatch/26 .. _syndication framework: ../syndication/ 27 .. _URLconf: ../url_dispatch/ 28 28 29 29 Installation 30 30 ============ … … 41 41 reason it needs to go into ``INSTALLED_APPS`` is so that the 42 42 ``load_template_source`` template loader can find the default templates.) 43 43 44 .. _INSTALLED_APPS: http://www.djangoproject.com/documentation/settings/#installed-apps45 .. _TEMPLATE_LOADERS: http://www.djangoproject.com/documentation/settings/#template-loaders46 .. _sites framework: http://www.djangoproject.com/documentation/sites/44 .. _INSTALLED_APPS: ../settings/#installed-apps 45 .. _TEMPLATE_LOADERS: ../settings/#template-loaders 46 .. _sites framework: ../sites/ 47 47 48 48 Initialization 49 49 ============== … … 68 68 ``NewsSitemap``). It may also map to an *instance* of a ``Sitemap`` class 69 69 (e.g., ``BlogSitemap(some_var)``). 70 70 71 .. _URLconf: http://www.djangoproject.com/documentation/url_dispatch/71 .. _URLconf: ../url_dispatch/ 72 72 73 73 Sitemap classes 74 74 =============== … … 217 217 creates an entry in the sitemap. These entries include only the ``location`` 218 218 attribute -- not ``lastmod``, ``changefreq`` or ``priority``. 219 219 220 .. _flatpages: http://www.djangoproject.com/documentation/flatpages/221 .. _sites documentation: http://www.djangoproject.com/documentation/sites/220 .. _flatpages: ../flatpages/ 221 .. _sites documentation: ../sites/ 222 222 223 223 ``GenericSitemap`` 224 224 ------------------ … … 232 232 ``priority`` and ``changefreq`` keyword arguments to the ``GenericSitemap`` 233 233 constructor to specify these attributes for all URLs. 234 234 235 .. _generic views: http://www.djangoproject.com/documentation/generic_views/235 .. _generic views: ../generic_views/ 236 236 237 237 Example 238 238 ------- … … 261 261 (r'^sitemap.xml$', 'django.contrib.sitemaps.views.sitemap', {'sitemaps': sitemaps}) 262 262 ) 263 263 264 .. _URLconf: http://www.djangoproject.com/documentation/url_dispatch/264 .. _URLconf: ../url_dispatch/ 265 265 266 266 Creating a sitemap index 267 267 ======================== -
docs/sites.txt
old new 276 276 ones), put ``objects = models.Manager()`` in your model, before you define 277 277 ``CurrentSiteManager``. 278 278 279 .. _manager: http://www.djangoproject.com/documentation/model_api/#managers280 .. _manager documentation: http://www.djangoproject.com/documentation/model_api/#managers279 .. _manager: ../model_api/#managers 280 .. _manager documentation: ../model_api/#managers 281 281 282 282 How Django uses the sites framework 283 283 =================================== … … 316 316 * The shortcut view (``django.views.defaults.shortcut``) uses the domain of 317 317 the current ``Site`` object when calculating an object's URL. 318 318 319 .. _redirects framework: http://www.djangoproject.com/documentation/redirects/320 .. _flatpages framework: http://www.djangoproject.com/documentation/flatpages/321 .. _syndication framework: http://www.djangoproject.com/documentation/syndication/322 .. _authentication framework: http://www.djangoproject.com/documentation/authentication/319 .. _redirects framework: ../redirects/ 320 .. _flatpages framework: ../flatpages/ 321 .. _syndication framework: ../syndication/ 322 .. _authentication framework: ../authentication/ -
docs/static_files.txt
old new 24 24 For information on serving static files in an Apache production environment, 25 25 see the `Django mod_python documentation`_. 26 26 27 .. _Django mod_python documentation: http://www.djangoproject.com/documentation/modpython/#serving-media-files27 .. _Django mod_python documentation: ../modpython/#serving-media-files 28 28 29 29 How to do it 30 30 ============ … … 49 49 * The file ``/path/bar.jpg`` will not be accessible, because it doesn't 50 50 fall under the docume