From f843e74d5059d27181f1d869957dfaab2a0c7156 Mon Sep 17 00:00:00 2001 From: norareidy Date: Mon, 7 Apr 2025 17:54:00 -0400 Subject: [PATCH 1/4] DOCSP-48767: Intersphinx links --- source/connect.txt | 4 ++-- source/get-started/create-admin.txt | 2 +- source/interact-data/specify-a-query.txt | 26 ++++++++++++------------ source/limitations-upcoming.txt | 4 ++-- source/model-data/indexes.txt | 7 ++++--- source/model-data/models.txt | 6 +++--- 6 files changed, 25 insertions(+), 24 deletions(-) diff --git a/source/connect.txt b/source/connect.txt index 634a418..d023911 100644 --- a/source/connect.txt +++ b/source/connect.txt @@ -146,11 +146,11 @@ function accepts the following arguments: - ``db_name``: The name of the database you want to use. - ``conn_max_age``: Configures persistent database connections. This argument is optional. To learn more, see - `Persistent connections <{+django-docs+}/ref/databases/#persistent-database-connections>`__ + :std:ext-doc:`Persistent connections ` in the {+framework+} documentation. - ``test``: Provides a dictionary of settings for test databases. This argument is optional. To learn more, see - `the TEST setting <{+django-docs+}/ref/settings/#test>`__ + :std:ext-doc:`the TEST setting ` in the {+framework+} documentation. Example diff --git a/source/get-started/create-admin.txt b/source/get-started/create-admin.txt index bcac068..0d506dd 100644 --- a/source/get-started/create-admin.txt +++ b/source/get-started/create-admin.txt @@ -13,7 +13,7 @@ Create an Admin Site You can create a {+framework+} admin site to edit your application's data from a web interface. To learn more about the {+framework+} admin -site and its features, see `The Django admin site <{+django-docs+}/ref/contrib/admin/>`__ +site and its features, see :py:attr:`The Django admin site ` in the {+framework+} documentation. .. procedure:: diff --git a/source/interact-data/specify-a-query.txt b/source/interact-data/specify-a-query.txt index aeb74e5..f95c7f0 100644 --- a/source/interact-data/specify-a-query.txt +++ b/source/interact-data/specify-a-query.txt @@ -257,9 +257,9 @@ expression matching, and year value matching for datetime fields. .. tip:: - To view a full list of lookup types, see `Field lookups - <{+django-docs+}/ref/models/querysets/#field-lookups>`__ in the - ``QuerySet`` {+framework+} API reference. + To view a full list of lookup types, see + :std:ext-doc:`Field lookups ` + in the ``QuerySet`` {+framework+} API reference. This section describes how to refine your query filters in the following ways: @@ -397,18 +397,17 @@ You can run queries that use multiple sets of matching criteria in the following ways: - Pass multiple query filters to your query method, separated - by commas. To view an example, see `Retrieving objects - <{+django-docs+}/topics/db/queries/#retrieving-objects>`__ in the - {+framework+} documentation. + by commas. To view an example, see + :std:ext-doc:`Django's LOGGING setting ` + in the {+framework+} documentation. -- Chain query methods together. To learn more, see `Chaining filters - <{+django-docs+}/topics/db/queries/#chaining-filters>`__ in the {+framework+} - documentation. +- Chain query methods together. To learn more, see + :std:ext-doc:`Chaining filters ` + in the {+framework+} documentation. - Use ``Q`` objects and separate each object with a logical operator. - To learn more, see `Complex lookups with Q objects - <{+django-docs+}/topics/db/queries/#complex-lookups-with-q-objects>`__ in the {+framework+} - documentation. + To learn more, see :std:ext-doc:`Complex lookups with Q objects ` + in the {+framework+} documentation. Q Object Example ```````````````` @@ -814,5 +813,6 @@ pipeline syntax, see the :ref:`django-raw-queries` guide. To learn how to perform other ``QuerySet`` operations, see the :ref:`django-crud` guide. -To learn more about {+framework+} queries, see `Making queries <{+django-docs+}/topics/db/queries>`__ +To learn more about {+framework+} queries, see +:std:ext-doc:`Making queries ` in the {+framework+} documentation. diff --git a/source/limitations-upcoming.txt b/source/limitations-upcoming.txt index 1707f70..dabb186 100644 --- a/source/limitations-upcoming.txt +++ b/source/limitations-upcoming.txt @@ -115,7 +115,7 @@ Fields ``$lookup`` operations, see the :atlas:`Reduce $lookup Operations ` guide in the Atlas documentation. - - Performance of `CASCADE deletes <{+django-docs+}/ref/models/fields/#django.db.models.CASCADE>`__ + - Performance of :py:mod:`CASCADE deletes ` on a ``ForeignKey`` field is not as performant as using an ``EmbeddedModelField``. @@ -196,7 +196,7 @@ Migration Limitations validation in your application, see the :manual:`Specify JSON Schema Validation ` guide in the {+mdb-server+} manual. -- `DDL Transactions <{+django-docs+}/topics/migrations/#transactions>`__. +- :std:ext-doc:`DDL Transactions ` - The ``migrate --fake-initial`` option. .. _django-limitations-performance: diff --git a/source/model-data/indexes.txt b/source/model-data/indexes.txt index d092f22..87ccad8 100644 --- a/source/model-data/indexes.txt +++ b/source/model-data/indexes.txt @@ -92,8 +92,9 @@ same indexes on the MongoDB collection. .. tip:: - To learn how to create and apply database migrations, see `Migrations - <{+django-docs+}/topics/migrations/>`__ in the {+framework+} documentation. + To learn how to create and apply database migrations, see + :std:ext-doc:`Migrations ` in the + {+framework+} documentation. This section shows how to create the following index types: @@ -280,7 +281,7 @@ creates a unique compound index on these fields: Setting the ``constraints`` option to a ``UniqueConstraint`` automatically creates an index on the specified fields. To learn more about the ``Meta`` - class's ``constraint`` option, see `Constraints <{+django-docs+}/ref/models/constraints/>`__ + class's ``constraint`` option, see :std:ext-doc:`Constraints ` in the {+framework+} documentation. Additional Information diff --git a/source/model-data/models.txt b/source/model-data/models.txt index 5c20703..f2ceb32 100644 --- a/source/model-data/models.txt +++ b/source/model-data/models.txt @@ -237,7 +237,7 @@ define a model: .. tip:: To learn more about the metadata options you can specify - in the ``Meta`` class, see `Model Meta options <{+django-docs+}/ref/models/options/>`__ + in the ``Meta`` class, see :py:attr:`Model Meta options ` in the {+framework+} documentation. To use your models, you must add them to your project's @@ -376,8 +376,8 @@ and pass the following arguments: - ``size``: *(Optional)* Specifies the maximum size of the array. - ``options``: *(Optional)* Specifies {+framework+} field options. - To view a list of available options, see `Field options - <{+django-docs+}/ref/models/fields/#field-options>`__ + To view a list of available options, see + :std:ext-doc:`Field options ` in the {+framework+} documentation. .. tip:: From 30edd2c211fc35ef0b4b89029bd44dd63f514dda Mon Sep 17 00:00:00 2001 From: norareidy Date: Mon, 7 Apr 2025 18:25:45 -0400 Subject: [PATCH 2/4] test --- source/temp.txt | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) create mode 100644 source/temp.txt diff --git a/source/temp.txt b/source/temp.txt new file mode 100644 index 0000000..369d14b --- /dev/null +++ b/source/temp.txt @@ -0,0 +1,19 @@ +====================== +Test Intersphinx Links +====================== + +1. :std:ext-doc:`Persistent connections ` +#. :std:ext-doc:`Persistent connections ` +#. :std:ext-doc:`Persistent connections ` +#. :std:ext-doc:`CONN_MAX_AGE ` +#. :std:ext-doc:`CONN_MAX_AGE ` + +1. :std:ext-doc:`the TEST setting ` +#. :std:ext-doc:`the TEST setting ` +#. :std:ext-doc:`~ref/settings/#test` + +1. :py:attr:`The Django admin site ` +#. :py:attr:`The Django admin site ` +#. :py:mod:`django.contrib.admin` +#. :py:mod:`django.contrib.admin.AdminSite` +#. :std:ext-doc:`The Django admin site ` \ No newline at end of file From 0de0dab5aae8d8af99c1990996a327fccb7d0d4f Mon Sep 17 00:00:00 2001 From: norareidy Date: Mon, 7 Apr 2025 18:42:18 -0400 Subject: [PATCH 3/4] test again --- source/get-started/create-admin.txt | 2 +- source/temp.txt | 28 +++++++++++++++++----------- 2 files changed, 18 insertions(+), 12 deletions(-) diff --git a/source/get-started/create-admin.txt b/source/get-started/create-admin.txt index 0d506dd..aced80d 100644 --- a/source/get-started/create-admin.txt +++ b/source/get-started/create-admin.txt @@ -13,7 +13,7 @@ Create an Admin Site You can create a {+framework+} admin site to edit your application's data from a web interface. To learn more about the {+framework+} admin -site and its features, see :py:attr:`The Django admin site ` +site and its features, see :py:mod:`The Django admin site ` in the {+framework+} documentation. .. procedure:: diff --git a/source/temp.txt b/source/temp.txt index 369d14b..692f647 100644 --- a/source/temp.txt +++ b/source/temp.txt @@ -3,17 +3,23 @@ Test Intersphinx Links ====================== 1. :std:ext-doc:`Persistent connections ` -#. :std:ext-doc:`Persistent connections ` -#. :std:ext-doc:`Persistent connections ` -#. :std:ext-doc:`CONN_MAX_AGE ` -#. :std:ext-doc:`CONN_MAX_AGE ` +#. :py:mod:`django.databases.persistent-database-connections` +#. :py:mod:`django.settings.CONN_MAX_AGE` 1. :std:ext-doc:`the TEST setting ` -#. :std:ext-doc:`the TEST setting ` -#. :std:ext-doc:`~ref/settings/#test` +#. :py:mod:`django.settings.test` -1. :py:attr:`The Django admin site ` -#. :py:attr:`The Django admin site ` -#. :py:mod:`django.contrib.admin` -#. :py:mod:`django.contrib.admin.AdminSite` -#. :std:ext-doc:`The Django admin site ` \ No newline at end of file +1. :py:mod:`django.contrib.admin` + +1. :std:ext-doc:`Field lookups ` +#. :py:attr:`django.db.models.field-lookups` +#. :py:attr:`~django.db.models.field-lookups` +#. :py:mod:`django.db.models.field-lookups` +#. :py:mod:`~django.db.models.field-lookups` + +1. :std:ext-doc:`Retrieving objects ` +#. :py:mod:`django.db.queries.retrieving-objects` +#. :py:mod:`~django.db.queries.retrieving-objects` +#. :py:attr:`django.db.queries.retrieving-objects` +#. :py:attr:`~django.db.queries.retrieving-objects` +#. :std:ext-doc:`~retrieving-objects` \ No newline at end of file From e398f4b34426a3805424a6b0cfe87a7f4be9b9e9 Mon Sep 17 00:00:00 2001 From: norareidy Date: Mon, 7 Apr 2025 18:48:11 -0400 Subject: [PATCH 4/4] again --- source/temp.txt | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/source/temp.txt b/source/temp.txt index 692f647..c8ce335 100644 --- a/source/temp.txt +++ b/source/temp.txt @@ -17,9 +17,9 @@ Test Intersphinx Links #. :py:mod:`django.db.models.field-lookups` #. :py:mod:`~django.db.models.field-lookups` -1. :std:ext-doc:`Retrieving objects ` -#. :py:mod:`django.db.queries.retrieving-objects` -#. :py:mod:`~django.db.queries.retrieving-objects` -#. :py:attr:`django.db.queries.retrieving-objects` -#. :py:attr:`~django.db.queries.retrieving-objects` -#. :std:ext-doc:`~retrieving-objects` \ No newline at end of file +1. :py:attr:`django.db.models.Field` +#. :py:attr:`~django.db.models.Field` +#. :py:attr:`django.db.models` +#. :py:mod:`django.db.models` +#. :py:mod:`django.db.models.Field` +#. :py:mod:`~django.db.models.Field` \ No newline at end of file