mirrors/django
1
0
Fork 0
mirror of https://github.com/django/django.git synced 2025-10-24 14:16:09 +00:00
Code Issues 32 Releases Wiki Activity

[5.1.x] Used :pypi: role in docs where appropriate.

Browse Source 
Backport of 304d256674 from main.
This commit is contained in:
Mariusz Felisiak
2024-08-05 15:35:50 +02:00
committed by Natalia
parent 88ebcb1856
commit 20bd3f02be
10 changed files with 25 additions and 35 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
docs/topics/db/optimization.txt
View File

@@ -14,7 +14,7 @@ As general programming practice, this goes without saying. Find out :ref:`what
queries you are doing and what they are costing you <faq-see-raw-sql-queries>`.
Use :meth:`.QuerySet.explain` to understand how specific ``QuerySet``\s are
executed by your database. You may also want to use an external project like
django-debug-toolbar_, or a tool that monitors your database directly.
:pypi:`django-debug-toolbar`, or a tool that monitors your database directly.
Remember that you may be optimizing for speed or memory or both, depending on
your requirements. Sometimes optimizing for one will be detrimental to the
@@ -30,8 +30,6 @@ readability of your code. **All** of the suggestions below come with the caveat
that in your circumstances the general principle might not apply, or might even
be reversed.
.. _django-debug-toolbar: https://github.com/jazzband/django-debug-toolbar/
Use standard DB optimization techniques
=======================================

2
docs/topics/email.txt
View File

@@ -708,7 +708,7 @@ to a file that can be inspected at your leisure.
Another approach is to use a "dumb" SMTP server that receives the emails
locally and displays them to the terminal, but does not actually send
anything. The `aiosmtpd`_ package provides a way to accomplish this:
anything. The :pypi:`aiosmtpd` package provides a way to accomplish this:
.. code-block:: shell

4
docs/topics/i18n/translation.txt
View File

@@ -1335,9 +1335,7 @@ whenever you restart your application server::
You can even pre-generate the JavaScript catalog as part of your deployment
procedure and serve it as a static file. This radical technique is implemented
in django-statici18n_.
.. _django-statici18n: https://django-statici18n.readthedocs.io/
in :pypi:`django-statici18n`.
.. _url-internationalization:

9
docs/topics/performance.txt
View File

@@ -55,11 +55,10 @@ code.
Django tools
~~~~~~~~~~~~
`django-debug-toolbar
<https://github.com/jazzband/django-debug-toolbar/>`_ is a very handy tool that
provides insights into what your code is doing and how much time it spends
doing it. In particular it can show you all the SQL queries your page is
generating, and how long each one has taken.
:pypi:`django-debug-toolbar` is a very handy tool that provides insights into
what your code is doing and how much time it spends doing it. In particular it
can show you all the SQL queries your page is generating, and how long each one
has taken.
Third-party panels are also available for the toolbar, that can (for example)
report on cache performance and template rendering times.