From fee1cf726204f7ead542bf86b6647362cbe7a695 Mon Sep 17 00:00:00 2001
From: rshide <32021884+rshide@users.noreply.github.com>
Date: Tue, 11 Aug 2026 22:28:43 -0500
Subject: [PATCH 1/2] Refs #37127 -- Added a version-aware sourcefile Sphinx
 role.

Co-authored-by: Tim Schilling <schillingt@better-simple.com>
---
 docs/_ext/djangodocs.py                       | 34 ++++++++++
 tests/{sphinx => sphinx_tests}/__init__.py    |  0
 tests/sphinx_tests/test_djangodocs.py         | 64 ++++++++++++++++++
 .../test_github_links.py                      | 65 +++++++++----------
 .../testdata/package/__init__.py              |  0
 .../testdata/package/import_error.py          |  0
 .../testdata/package/module.py                |  2 +-
 .../testdata/package/other_module.py          |  0
 .../testdata/package/wildcard_base.py         |  0
 .../testdata/package/wildcard_module.py       |  0
 tests/sphinx_tests/tests.py                   | 27 ++++++++
 11 files changed, 157 insertions(+), 35 deletions(-)
 rename tests/{sphinx => sphinx_tests}/__init__.py (100%)
 create mode 100644 tests/sphinx_tests/test_djangodocs.py
 rename tests/{sphinx => sphinx_tests}/test_github_links.py (69%)
 rename tests/{sphinx => sphinx_tests}/testdata/package/__init__.py (100%)
 rename tests/{sphinx => sphinx_tests}/testdata/package/import_error.py (100%)
 rename tests/{sphinx => sphinx_tests}/testdata/package/module.py (83%)
 rename tests/{sphinx => sphinx_tests}/testdata/package/other_module.py (100%)
 rename tests/{sphinx => sphinx_tests}/testdata/package/wildcard_base.py (100%)
 rename tests/{sphinx => sphinx_tests}/testdata/package/wildcard_module.py (100%)
 create mode 100644 tests/sphinx_tests/tests.py

diff --git a/docs/_ext/djangodocs.py b/docs/_ext/djangodocs.py
index ac7b161eeece..c42279638b64 100644
--- a/docs/_ext/djangodocs.py
+++ b/docs/_ext/djangodocs.py
@@ -7,11 +7,13 @@
 from docutils import nodes
 from docutils.parsers.rst import Directive
 from docutils.statemachine import ViewList
+from github_links import get_branch
 from sphinx import addnodes
 from sphinx import version_info as sphinx_version
 from sphinx.directives.code import CodeBlock
 from sphinx.domains.std import Cmdoption
 from sphinx.util import logging
+from sphinx.util.nodes import split_explicit_title
 from sphinx.writers.html import HTMLTranslator
 
 logger = logging.getLogger(__name__)
@@ -62,6 +64,7 @@ def setup(app):
     app.add_directive("console", ConsoleDirective)
     app.connect("html-page-context", html_page_context_hook)
     app.add_role("default-role-error", default_role_error)
+    app.add_role("sourcefile", sourcefile)
     return {"parallel_read_safe": True}
 
 
@@ -372,3 +375,34 @@ def default_role_error(
     )
     logger.warning(msg, location=(inliner.document.current_source, lineno))
     return [nodes.Text(text)], []
+
+
+def sourcefile(
+    name,
+    rawtext,
+    text,
+    lineno,
+    inliner,
+    options=None,
+    content=None,
+):
+    options = options or {}
+
+    _, title, target = split_explicit_title(text)
+
+    env = inliner.document.settings.env
+    branch = get_branch(
+        version=env.config.version,
+        next_version=env.config.django_next_version,
+    )
+    url = f"https://github.com/django/django/blob/{branch}/{target}"
+
+    literal = nodes.literal(title, title)
+    reference = nodes.reference(
+        rawtext,
+        "",
+        literal,
+        refuri=url,
+        **options,
+    )
+    return [reference], []
diff --git a/tests/sphinx/__init__.py b/tests/sphinx_tests/__init__.py
similarity index 100%
rename from tests/sphinx/__init__.py
rename to tests/sphinx_tests/__init__.py
diff --git a/tests/sphinx_tests/test_djangodocs.py b/tests/sphinx_tests/test_djangodocs.py
new file mode 100644
index 000000000000..8d95ddcabc5c
--- /dev/null
+++ b/tests/sphinx_tests/test_djangodocs.py
@@ -0,0 +1,64 @@
+import sys
+import unittest
+from types import SimpleNamespace
+
+from sphinx_tests.tests import SimpleSphinxTestCase, sphinx
+
+# The import must happen at the end of setUpClass, so it can't be imported at
+# the top of the file.
+djangodocs = None
+
+
+@unittest.skipIf(sphinx is None, "sphinx required")
+class DjangoDocsTests(SimpleSphinxTestCase):
+    @classmethod
+    def docs_module_import(cls):
+        cls.addClassCleanup(sys.modules.pop, "djangodocs", None)
+        # Linters/IDEs may not be able to detect this as a valid import.
+        import djangodocs as _djangodocs
+
+        global djangodocs
+        djangodocs = _djangodocs
+
+    def sourcefile(self, text, *, version="6.2", next_version="6.2"):
+        config = SimpleNamespace(
+            version=version,
+            django_next_version=next_version,
+        )
+        env = SimpleNamespace(config=config)
+        settings = SimpleNamespace(env=env)
+        document = SimpleNamespace(settings=settings)
+        inliner = SimpleNamespace(document=document)
+        return djangodocs.sourcefile("sourcefile", "", text, 1, inliner)
+
+    def test_sourcefile_uses_main_branch(self):
+        role_nodes, messages = self.sourcefile("django/forms/forms.py")
+
+        self.assertEqual(messages, [])
+        self.assertEqual(role_nodes[0].astext(), "django/forms/forms.py")
+        self.assertEqual(
+            role_nodes[0]["refuri"],
+            "https://github.com/django/django/blob/main/django/forms/forms.py",
+        )
+
+    def test_sourcefile_uses_stable_branch(self):
+        role_nodes, messages = self.sourcefile(
+            "django/forms/forms.py", version="6.0", next_version="6.2"
+        )
+
+        self.assertEqual(messages, [])
+        self.assertEqual(
+            role_nodes[0]["refuri"],
+            "https://github.com/django/django/blob/stable/6.0.x/"
+            "django/forms/forms.py",
+        )
+
+    def test_sourcefile_supports_explicit_title(self):
+        role_nodes, messages = self.sourcefile("'forms.py' <django/forms/forms.py>")
+
+        self.assertEqual(messages, [])
+        self.assertEqual(role_nodes[0].astext(), "'forms.py'")
+        self.assertEqual(
+            role_nodes[0]["refuri"],
+            "https://github.com/django/django/blob/main/django/forms/forms.py",
+        )
diff --git a/tests/sphinx/test_github_links.py b/tests/sphinx_tests/test_github_links.py
similarity index 69%
rename from tests/sphinx/test_github_links.py
rename to tests/sphinx_tests/test_github_links.py
index db0447b62829..58818673ec0d 100644
--- a/tests/sphinx/test_github_links.py
+++ b/tests/sphinx_tests/test_github_links.py
@@ -1,7 +1,6 @@
-import pathlib
 import sys
 
-from django.test import SimpleTestCase
+from sphinx_tests.tests import SimpleSphinxTestCase
 
 
 def last_n_parts(path, n):
@@ -13,16 +12,9 @@ def last_n_parts(path, n):
 github_links = None
 
 
-class GitHubLinkTests(SimpleTestCase):
+class GitHubLinkTests(SimpleSphinxTestCase):
     @classmethod
-    def setUpClass(cls):
-        # The file implementing the code under test is in the docs folder and
-        # is not part of the Django package. This means it cannot be imported
-        # through standard means. Include its parent in the pythonpath for the
-        # duration of the tests to allow the code to be imported.
-        cls.ext_path = str((pathlib.Path(__file__).parents[2] / "docs/_ext").resolve())
-        sys.path.insert(0, cls.ext_path)
-        cls.addClassCleanup(sys.path.remove, cls.ext_path)
+    def docs_module_import(cls):
         cls.addClassCleanup(sys.modules.pop, "github_links", None)
         # Linters/IDEs may not be able to detect this as a valid import.
         import github_links as _github_links
@@ -57,84 +49,86 @@ def test_module_name_to_file_path_module(self):
 
     def test_get_path_and_line_class(self):
         path, line = github_links.get_path_and_line(
-            module="tests.sphinx.testdata.package.module", fullname="MyClass"
+            module="tests.sphinx_tests.testdata.package.module", fullname="MyClass"
         )
 
         self.assertEqual(
-            last_n_parts(path, 5), "tests/sphinx/testdata/package/module.py"
+            last_n_parts(path, 5), "tests/sphinx_tests/testdata/package/module.py"
         )
         self.assertEqual(line, 12)
 
     def test_get_path_and_line_func(self):
         path, line = github_links.get_path_and_line(
-            module="tests.sphinx.testdata.package.module", fullname="my_function"
+            module="tests.sphinx_tests.testdata.package.module", fullname="my_function"
         )
 
         self.assertEqual(
-            last_n_parts(path, 5), "tests/sphinx/testdata/package/module.py"
+            last_n_parts(path, 5), "tests/sphinx_tests/testdata/package/module.py"
         )
         self.assertEqual(line, 24)
 
     def test_get_path_and_line_method(self):
         path, line = github_links.get_path_and_line(
-            module="tests.sphinx.testdata.package.module", fullname="MyClass.my_method"
+            module="tests.sphinx_tests.testdata.package.module",
+            fullname="MyClass.my_method",
         )
 
         self.assertEqual(
-            last_n_parts(path, 5), "tests/sphinx/testdata/package/module.py"
+            last_n_parts(path, 5), "tests/sphinx_tests/testdata/package/module.py"
         )
         self.assertEqual(line, 16)
 
     def test_get_path_and_line_cached_property(self):
         path, line = github_links.get_path_and_line(
-            module="tests.sphinx.testdata.package.module",
+            module="tests.sphinx_tests.testdata.package.module",
             fullname="MyClass.my_cached_property",
         )
 
         self.assertEqual(
-            last_n_parts(path, 5), "tests/sphinx/testdata/package/module.py"
+            last_n_parts(path, 5), "tests/sphinx_tests/testdata/package/module.py"
         )
         self.assertEqual(line, 20)
 
     def test_get_path_and_line_forwarded_import(self):
         path, line = github_links.get_path_and_line(
-            module="tests.sphinx.testdata.package.module", fullname="MyOtherClass"
+            module="tests.sphinx_tests.testdata.package.module", fullname="MyOtherClass"
         )
 
         self.assertEqual(
-            last_n_parts(path, 5), "tests/sphinx/testdata/package/other_module.py"
+            last_n_parts(path, 5), "tests/sphinx_tests/testdata/package/other_module.py"
         )
         self.assertEqual(line, 1)
 
     def test_get_path_and_line_wildcard_import(self):
         path, line = github_links.get_path_and_line(
-            module="tests.sphinx.testdata.package.module", fullname="WildcardClass"
+            module="tests.sphinx_tests.testdata.package.module",
+            fullname="WildcardClass",
         )
 
         self.assertEqual(
             last_n_parts(path, 5),
-            "tests/sphinx/testdata/package/wildcard_module.py",
+            "tests/sphinx_tests/testdata/package/wildcard_module.py",
         )
         self.assertEqual(line, 4)
 
         path, line = github_links.get_path_and_line(
-            module="tests.sphinx.testdata.package.module",
+            module="tests.sphinx_tests.testdata.package.module",
             fullname="WildcardMixin",
         )
         self.assertEqual(
             last_n_parts(path, 5),
-            "tests/sphinx/testdata/package/wildcard_base.py",
+            "tests/sphinx_tests/testdata/package/wildcard_base.py",
         )
         self.assertEqual(line, 1)
 
     def test_get_path_and_line_forwarded_import_module(self):
         path, line = github_links.get_path_and_line(
-            module="tests.sphinx.testdata.package.module",
+            module="tests.sphinx_tests.testdata.package.module",
             fullname="other_module.MyOtherClass",
         )
 
         self.assertEqual(
-            last_n_parts(path, 5), "tests/sphinx/testdata/package/other_module.py"
+            last_n_parts(path, 5), "tests/sphinx_tests/testdata/package/other_module.py"
         )
         self.assertEqual(line, 1)
 
@@ -177,33 +171,36 @@ def test_github_linkcode_resolve_not_found(self):
 
     def test_github_linkcode_resolve_link_to_object(self):
         info = {
-            "module": "tests.sphinx.testdata.package.module",
+            "module": "tests.sphinx_tests.testdata.package.module",
             "fullname": "MyClass",
         }
         self.assertEqual(
             github_links.github_linkcode_resolve(
                 "py", info, version="3.2", next_version="3.2"
             ),
-            "https://github.com/django/django/blob/main/tests/sphinx/"
+            "https://github.com/django/django/blob/main/tests/sphinx_tests/"
             "testdata/package/module.py#L12",
         )
 
     def test_github_linkcode_resolve_link_to_class_older_version(self):
         info = {
-            "module": "tests.sphinx.testdata.package.module",
+            "module": "tests.sphinx_tests.testdata.package.module",
             "fullname": "MyClass",
         }
         self.assertEqual(
             github_links.github_linkcode_resolve(
                 "py", info, version="2.2", next_version="3.2"
             ),
-            "https://github.com/django/django/blob/stable/2.2.x/tests/sphinx/"
-            "testdata/package/module.py#L12",
+            "https://github.com/django/django/blob/stable/2.2.x/"
+            "tests/sphinx_tests/testdata/package/module.py#L12",
         )
 
     def test_import_error(self):
-        msg = "Could not import '.....test' in 'tests.sphinx.testdata.package'."
+        msg = (
+            "Could not import '.....test' in " "'tests.sphinx_tests.testdata.package'."
+        )
         with self.assertRaisesMessage(ImportError, msg):
             github_links.get_path_and_line(
-                module="tests.sphinx.testdata.package.import_error", fullname="Test"
+                module="tests.sphinx_tests.testdata.package.import_error",
+                fullname="Test",
             )
diff --git a/tests/sphinx/testdata/package/__init__.py b/tests/sphinx_tests/testdata/package/__init__.py
similarity index 100%
rename from tests/sphinx/testdata/package/__init__.py
rename to tests/sphinx_tests/testdata/package/__init__.py
diff --git a/tests/sphinx/testdata/package/import_error.py b/tests/sphinx_tests/testdata/package/import_error.py
similarity index 100%
rename from tests/sphinx/testdata/package/import_error.py
rename to tests/sphinx_tests/testdata/package/import_error.py
diff --git a/tests/sphinx/testdata/package/module.py b/tests/sphinx_tests/testdata/package/module.py
similarity index 83%
rename from tests/sphinx/testdata/package/module.py
rename to tests/sphinx_tests/testdata/package/module.py
index 987923b55ee1..0b2498d0e192 100644
--- a/tests/sphinx/testdata/package/module.py
+++ b/tests/sphinx_tests/testdata/package/module.py
@@ -3,7 +3,7 @@
 """
 
 from django.utils.functional import cached_property
-from tests.sphinx.testdata.package.wildcard_module import *  # noqa
+from tests.sphinx_tests.testdata.package.wildcard_module import *  # noqa
 
 from . import other_module  # noqa
 from .other_module import MyOtherClass  # noqa
diff --git a/tests/sphinx/testdata/package/other_module.py b/tests/sphinx_tests/testdata/package/other_module.py
similarity index 100%
rename from tests/sphinx/testdata/package/other_module.py
rename to tests/sphinx_tests/testdata/package/other_module.py
diff --git a/tests/sphinx/testdata/package/wildcard_base.py b/tests/sphinx_tests/testdata/package/wildcard_base.py
similarity index 100%
rename from tests/sphinx/testdata/package/wildcard_base.py
rename to tests/sphinx_tests/testdata/package/wildcard_base.py
diff --git a/tests/sphinx/testdata/package/wildcard_module.py b/tests/sphinx_tests/testdata/package/wildcard_module.py
similarity index 100%
rename from tests/sphinx/testdata/package/wildcard_module.py
rename to tests/sphinx_tests/testdata/package/wildcard_module.py
diff --git a/tests/sphinx_tests/tests.py b/tests/sphinx_tests/tests.py
new file mode 100644
index 000000000000..865f1df121af
--- /dev/null
+++ b/tests/sphinx_tests/tests.py
@@ -0,0 +1,27 @@
+import pathlib
+import sys
+
+from django.test import SimpleTestCase
+
+try:
+    import sphinx
+except ImportError:
+    sphinx = None
+
+
+class SimpleSphinxTestCase(SimpleTestCase):
+    @classmethod
+    def setUpClass(cls):
+        super().setUpClass()
+        # The file implementing the code under test is in the docs folder and
+        # is not part of the Django package. This means it cannot be imported
+        # through standard means. Include its parent in the pythonpath for the
+        # duration of the tests to allow the code to be imported.
+        cls.ext_path = str((pathlib.Path(__file__).parents[2] / "docs/_ext").resolve())
+        sys.path.insert(0, cls.ext_path)
+        cls.addClassCleanup(sys.path.remove, cls.ext_path)
+        cls.docs_module_import()
+
+    @classmethod
+    def docs_module_import(cls):
+        """Override this method to allow importing code in the docs folder."""

From 177fb98c1025dd32879380e0665bc238cbfe6819 Mon Sep 17 00:00:00 2001
From: rshide <32021884+rshide@users.noreply.github.com>
Date: Tue, 11 Aug 2026 22:28:49 -0500
Subject: [PATCH 2/2] Fixed #37127 -- Added source links for form templates.

---
 docs/ref/forms/api.txt         | 34 ++++++++----
 docs/ref/forms/fields.txt      |  7 +--
 docs/ref/forms/renderers.txt   | 18 ++++---
 docs/ref/forms/widgets.txt     | 99 +++++++++++++++++++++++-----------
 docs/topics/forms/formsets.txt | 25 +++++----
 docs/topics/forms/index.txt    |  6 ++-
 6 files changed, 126 insertions(+), 63 deletions(-)

diff --git a/docs/ref/forms/api.txt b/docs/ref/forms/api.txt
index 04816bc5eed6..16f68228da07 100644
--- a/docs/ref/forms/api.txt
+++ b/docs/ref/forms/api.txt
@@ -647,6 +647,9 @@ The template used to render a field's ``<label>``, used when calling
 form by overriding this attribute or more generally by overriding the default
 template, see also :ref:`overriding-built-in-form-templates`.
 
+By default this is :sourcefile:`'django/forms/label.html'
+<django/forms/templates/django/forms/label.html>`.
+
 Output styles
 -------------
 
@@ -673,7 +676,9 @@ template name.
 
 .. attribute:: Form.template_name_div
 
-The template used by ``as_div()``. Default: ``'django/forms/div.html'``.
+The template used by ``as_div()``. Default:
+:sourcefile:`'django/forms/div.html'
+<django/forms/templates/django/forms/div.html>`.
 
 .. method:: Form.as_div()
 
@@ -711,7 +716,8 @@ The template used by ``as_div()``. Default: ``'django/forms/div.html'``.
 
 .. attribute:: Form.template_name_p
 
-The template used by ``as_p()``. Default: ``'django/forms/p.html'``.
+The template used by ``as_p()``. Default: :sourcefile:`'django/forms/p.html'
+<django/forms/templates/django/forms/p.html>`.
 
 .. method:: Form.as_p()
 
@@ -737,7 +743,8 @@ containing one field:
 
 .. attribute:: Form.template_name_ul
 
-The template used by ``as_ul()``. Default: ``'django/forms/ul.html'``.
+The template used by ``as_ul()``. Default: :sourcefile:`'django/forms/ul.html'
+<django/forms/templates/django/forms/ul.html>`.
 
 .. method:: Form.as_ul()
 
@@ -764,7 +771,9 @@ you can specify any HTML attributes on the ``<ul>`` for flexibility:
 
 .. attribute:: Form.template_name_table
 
-The template used by ``as_table()``. Default: ``'django/forms/table.html'``.
+The template used by ``as_table()``. Default:
+:sourcefile:`'django/forms/table.html'
+<django/forms/templates/django/forms/table.html>`.
 
 .. method:: Form.as_table()
 
@@ -1086,21 +1095,24 @@ Customizing the error list format
 
         The name of the template used when calling ``__str__`` or
         :meth:`render`. By default this is
-        ``'django/forms/errors/list/default.html'`` which is a proxy for the
-        ``'ul.html'`` template.
+        :sourcefile:`'django/forms/errors/list/default.html'
+        <django/forms/templates/django/forms/errors/list/default.html>`,
+        which is a proxy for the ``'ul.html'`` template.
 
     .. attribute:: template_name_text
 
         The name of the template used when calling :meth:`.as_text`. By default
-        this is ``'django/forms/errors/list/text.html'``. This template renders
-        the errors as a list of bullet points.
+        this is :sourcefile:`'django/forms/errors/list/text.txt'
+        <django/forms/templates/django/forms/errors/list/text.txt>`. This
+        template renders the errors as a list of bullet points.
 
     .. attribute:: template_name_ul
 
         The name of the template used when calling :meth:`.as_ul`. By default
-        this is ``'django/forms/errors/list/ul.html'``. This template renders
-        the errors in ``<li>`` tags with a wrapping ``<ul>`` with the CSS
-        classes as defined by :attr:`.error_class`.
+        this is :sourcefile:`'django/forms/errors/list/ul.html'
+        <django/forms/templates/django/forms/errors/list/ul.html>`. This
+        template renders the errors in ``<li>`` tags with a wrapping ``<ul>``
+        with the CSS classes as defined by :attr:`.error_class`.
 
     .. method:: get_context()
 
diff --git a/docs/ref/forms/fields.txt b/docs/ref/forms/fields.txt
index 0599014f70c9..e2f484773af1 100644
--- a/docs/ref/forms/fields.txt
+++ b/docs/ref/forms/fields.txt
@@ -389,9 +389,10 @@ be ignored in favor of the value from the form's initial data.
 
 The ``template_name`` argument allows a custom template to be used when the
 field is rendered with :meth:`~django.forms.BoundField.as_field_group`. By
-default this value is set to ``"django/forms/field.html"``. Can be changed per
-field by overriding this attribute or more generally by overriding the default
-template, see also :ref:`overriding-built-in-field-templates`.
+default this value is set to :sourcefile:`"django/forms/field.html"
+<django/forms/templates/django/forms/field.html>`. Can be changed per field by
+overriding this attribute or more generally by overriding the default template,
+see also :ref:`overriding-built-in-field-templates`.
 
 ``bound_field_class``
 ---------------------
diff --git a/docs/ref/forms/renderers.txt b/docs/ref/forms/renderers.txt
index 7dceac9c295f..e0efcbd669db 100644
--- a/docs/ref/forms/renderers.txt
+++ b/docs/ref/forms/renderers.txt
@@ -53,19 +53,22 @@ should return a rendered template (as a string) or raise
 
         The default name of the template to use to render a form.
 
-        Defaults to ``"django/forms/div.html"`` template.
+        Defaults to the :sourcefile:`"django/forms/div.html"
+        <django/forms/templates/django/forms/div.html>` template.
 
     .. attribute:: formset_template_name
 
         The default name of the template to use to render a formset.
 
-        Defaults to ``"django/forms/formsets/div.html"`` template.
+        Defaults to the :sourcefile:`"django/forms/formsets/div.html"
+        <django/forms/templates/django/forms/formsets/div.html>` template.
 
     .. attribute:: field_template_name
 
         The default name of the template used to render a ``BoundField``.
 
-        Defaults to ``"django/forms/field.html"``
+        Defaults to :sourcefile:`"django/forms/field.html"
+        <django/forms/templates/django/forms/field.html>`.
 
     .. attribute:: bound_field_class
 
@@ -101,7 +104,7 @@ This renderer uses a standalone
 :class:`~django.template.backends.django.DjangoTemplates`
 engine (unconnected to what you might have configured in the
 :setting:`TEMPLATES` setting). It loads templates first from the built-in form
-templates directory in :source:`django/forms/templates` and then from the
+templates directory in :sourcefile:`django/forms/templates` and then from the
 installed apps' templates directories using the :class:`app_directories
 <django.template.loaders.app_directories.Loader>` loader.
 
@@ -116,7 +119,7 @@ If you want to render templates with customizations from your
 
 This renderer is the same as the :class:`DjangoTemplates` renderer except that
 it uses a :class:`~django.template.backends.jinja2.Jinja2` backend. Templates
-for the built-in widgets are located in :source:`django/forms/jinja2` and
+for the built-in widgets are located in :sourcefile:`django/forms/jinja2` and
 installed apps can provide templates in a ``jinja2`` directory.
 
 To use this backend, all the forms and widgets in your project and its
@@ -234,8 +237,9 @@ Overriding built-in widget templates
 Each widget has a ``template_name`` attribute with a value such as
 ``input.html``. Built-in widget templates are stored in the
 ``django/forms/widgets`` path. You can provide a custom template for
-``input.html`` by defining ``django/forms/widgets/input.html``, for example.
-See :ref:`built-in widgets` for the name of each widget's template.
+``input.html`` by defining
+:sourcefile:`django/forms/templates/django/forms/widgets/input.html`, for
+example. See :ref:`built-in widgets` for the name of each widget's template.
 
 To override widget templates, you must use the :class:`TemplatesSetting`
 renderer. Then overriding widget templates works :doc:`the same as
diff --git a/docs/ref/forms/widgets.txt b/docs/ref/forms/widgets.txt
index edb6d8c783af..fe3634f5fa94 100644
--- a/docs/ref/forms/widgets.txt
+++ b/docs/ref/forms/widgets.txt
@@ -494,7 +494,8 @@ These widgets make use of the HTML elements ``input`` and ``textarea``.
 .. class:: TextInput
 
     * ``input_type``: ``'text'``
-    * ``template_name``: ``'django/forms/widgets/text.html'``
+    * ``template_name``: :sourcefile:`'django/forms/widgets/text.html'
+      <django/forms/templates/django/forms/widgets/text.html>`
     * Renders as: ``<input type="text" ...>``
 
 ``NumberInput``
@@ -503,7 +504,8 @@ These widgets make use of the HTML elements ``input`` and ``textarea``.
 .. class:: NumberInput
 
     * ``input_type``: ``'number'``
-    * ``template_name``: ``'django/forms/widgets/number.html'``
+    * ``template_name``: :sourcefile:`'django/forms/widgets/number.html'
+      <django/forms/templates/django/forms/widgets/number.html>`
     * Renders as: ``<input type="number" ...>``
 
     Beware that not all browsers support entering localized numbers in
@@ -516,7 +518,8 @@ These widgets make use of the HTML elements ``input`` and ``textarea``.
 .. class:: EmailInput
 
     * ``input_type``: ``'email'``
-    * ``template_name``: ``'django/forms/widgets/email.html'``
+    * ``template_name``: :sourcefile:`'django/forms/widgets/email.html'
+      <django/forms/templates/django/forms/widgets/email.html>`
     * Renders as: ``<input type="email" ...>``
 
 ``URLInput``
@@ -525,7 +528,8 @@ These widgets make use of the HTML elements ``input`` and ``textarea``.
 .. class:: URLInput
 
     * ``input_type``: ``'url'``
-    * ``template_name``: ``'django/forms/widgets/url.html'``
+    * ``template_name``: :sourcefile:`'django/forms/widgets/url.html'
+      <django/forms/templates/django/forms/widgets/url.html>`
     * Renders as: ``<input type="url" ...>``
 
 ``ColorInput``
@@ -534,7 +538,8 @@ These widgets make use of the HTML elements ``input`` and ``textarea``.
 .. class:: ColorInput
 
     * ``input_type``: ``'color'``
-    * ``template_name``:``'django/forms/widgets/color.html'``
+    * ``template_name``: :sourcefile:`'django/forms/widgets/color.html'
+      <django/forms/templates/django/forms/widgets/color.html>`
     * Renders as: ``<input type="color" ...>``
 
 ``SearchInput``
@@ -543,7 +548,8 @@ These widgets make use of the HTML elements ``input`` and ``textarea``.
 .. class:: SearchInput
 
     * ``input_type``: ``'search'``
-    * ``template_name``: ``'django/forms/widgets/search.html'``
+    * ``template_name``: :sourcefile:`'django/forms/widgets/search.html'
+      <django/forms/templates/django/forms/widgets/search.html>`
     * Renders as: ``<input type="search" ...>``
 
 ``TelInput``
@@ -552,7 +558,8 @@ These widgets make use of the HTML elements ``input`` and ``textarea``.
 .. class:: TelInput
 
     * ``input_type``: ``'tel'``
-    * ``template_name``: ``'django/forms/widgets/tel.html'``
+    * ``template_name``: :sourcefile:`'django/forms/widgets/tel.html'
+      <django/forms/templates/django/forms/widgets/tel.html>`
     * Renders as: ``<input type="tel" ...>``
 
     Browsers perform no client-side validation by default because telephone
@@ -570,7 +577,8 @@ These widgets make use of the HTML elements ``input`` and ``textarea``.
 .. class:: PasswordInput
 
     * ``input_type``: ``'password'``
-    * ``template_name``: ``'django/forms/widgets/password.html'``
+    * ``template_name``: :sourcefile:`'django/forms/widgets/password.html'
+      <django/forms/templates/django/forms/widgets/password.html>`
     * Renders as: ``<input type="password" ...>``
 
     Takes one optional argument:
@@ -586,7 +594,8 @@ These widgets make use of the HTML elements ``input`` and ``textarea``.
 .. class:: HiddenInput
 
     * ``input_type``: ``'hidden'``
-    * ``template_name``: ``'django/forms/widgets/hidden.html'``
+    * ``template_name``: :sourcefile:`'django/forms/widgets/hidden.html'
+      <django/forms/templates/django/forms/widgets/hidden.html>`
     * Renders as: ``<input type="hidden" ...>``
 
     Note that there also is a :class:`MultipleHiddenInput` widget that
@@ -598,7 +607,8 @@ These widgets make use of the HTML elements ``input`` and ``textarea``.
 .. class:: DateInput
 
     * ``input_type``: ``'text'``
-    * ``template_name``: ``'django/forms/widgets/date.html'``
+    * ``template_name``: :sourcefile:`'django/forms/widgets/date.html'
+      <django/forms/templates/django/forms/widgets/date.html>`
     * Renders as: ``<input type="text" ...>``
 
     Takes same arguments as :class:`TextInput`, with one more optional
@@ -642,7 +652,8 @@ These widgets make use of the HTML elements ``input`` and ``textarea``.
 .. class:: DateTimeInput
 
     * ``input_type``: ``'text'``
-    * ``template_name``: ``'django/forms/widgets/datetime.html'``
+    * ``template_name``: :sourcefile:`'django/forms/widgets/datetime.html'
+      <django/forms/templates/django/forms/widgets/datetime.html>`
     * Renders as: ``<input type="text" ...>``
 
     Takes same arguments as :class:`TextInput`, with one more optional
@@ -667,7 +678,8 @@ These widgets make use of the HTML elements ``input`` and ``textarea``.
 .. class:: TimeInput
 
     * ``input_type``: ``'text'``
-    * ``template_name``: ``'django/forms/widgets/time.html'``
+    * ``template_name``: :sourcefile:`'django/forms/widgets/time.html'
+      <django/forms/templates/django/forms/widgets/time.html>`
     * Renders as: ``<input type="text" ...>``
 
     Takes same arguments as :class:`TextInput`, with one more optional
@@ -688,7 +700,8 @@ These widgets make use of the HTML elements ``input`` and ``textarea``.
 
 .. class:: Textarea
 
-    * ``template_name``: ``'django/forms/widgets/textarea.html'``
+    * ``template_name``: :sourcefile:`'django/forms/widgets/textarea.html'
+      <django/forms/templates/django/forms/widgets/textarea.html>`
     * Renders as: ``<textarea>...</textarea>``
 
 .. _selector-widgets:
@@ -710,7 +723,8 @@ that specifies the template used to render each choice. For example, for the
 .. class:: CheckboxInput
 
     * ``input_type``: ``'checkbox'``
-    * ``template_name``: ``'django/forms/widgets/checkbox.html'``
+    * ``template_name``: :sourcefile:`'django/forms/widgets/checkbox.html'
+      <django/forms/templates/django/forms/widgets/checkbox.html>`
     * Renders as: ``<input type="checkbox" ...>``
 
     Takes one optional argument:
@@ -725,8 +739,11 @@ that specifies the template used to render each choice. For example, for the
 
 .. class:: Select
 
-    * ``template_name``: ``'django/forms/widgets/select.html'``
-    * ``option_template_name``: ``'django/forms/widgets/select_option.html'``
+    * ``template_name``: :sourcefile:`'django/forms/widgets/select.html'
+      <django/forms/templates/django/forms/widgets/select.html>`
+    * ``option_template_name``:
+      :sourcefile:`'django/forms/widgets/select_option.html'
+      <django/forms/templates/django/forms/widgets/select_option.html>`
     * Renders as: ``<select><option ...>...</select>``
 
     .. attribute:: Select.choices
@@ -740,8 +757,11 @@ that specifies the template used to render each choice. For example, for the
 
 .. class:: NullBooleanSelect
 
-    * ``template_name``: ``'django/forms/widgets/select.html'``
-    * ``option_template_name``: ``'django/forms/widgets/select_option.html'``
+    * ``template_name``: :sourcefile:`'django/forms/widgets/select.html'
+      <django/forms/templates/django/forms/widgets/select.html>`
+    * ``option_template_name``:
+      :sourcefile:`'django/forms/widgets/select_option.html'
+      <django/forms/templates/django/forms/widgets/select_option.html>`
 
     Select widget with options 'Unknown', 'Yes' and 'No'
 
@@ -750,8 +770,11 @@ that specifies the template used to render each choice. For example, for the
 
 .. class:: SelectMultiple
 
-    * ``template_name``: ``'django/forms/widgets/select.html'``
-    * ``option_template_name``: ``'django/forms/widgets/select_option.html'``
+    * ``template_name``: :sourcefile:`'django/forms/widgets/select.html'
+      <django/forms/templates/django/forms/widgets/select.html>`
+    * ``option_template_name``:
+      :sourcefile:`'django/forms/widgets/select_option.html'
+      <django/forms/templates/django/forms/widgets/select_option.html>`
 
     Similar to :class:`Select`, but allows multiple selection:
     ``<select multiple>...</select>``
@@ -761,8 +784,11 @@ that specifies the template used to render each choice. For example, for the
 
 .. class:: RadioSelect
 
-    * ``template_name``: ``'django/forms/widgets/radio.html'``
-    * ``option_template_name``: ``'django/forms/widgets/radio_option.html'``
+    * ``template_name``: :sourcefile:`'django/forms/widgets/radio.html'
+      <django/forms/templates/django/forms/widgets/radio.html>`
+    * ``option_template_name``:
+      :sourcefile:`'django/forms/widgets/radio_option.html'
+      <django/forms/templates/django/forms/widgets/radio_option.html>`
 
     Similar to :class:`Select`, but rendered as a list of radio buttons within
     ``<div>`` tags:
@@ -865,8 +891,12 @@ that specifies the template used to render each choice. For example, for the
 
 .. class:: CheckboxSelectMultiple
 
-    * ``template_name``: ``'django/forms/widgets/checkbox_select.html'``
-    * ``option_template_name``: ``'django/forms/widgets/checkbox_option.html'``
+    * ``template_name``:
+      :sourcefile:`'django/forms/widgets/checkbox_select.html'
+      <django/forms/templates/django/forms/widgets/checkbox_select.html>`
+    * ``option_template_name``:
+      :sourcefile:`'django/forms/widgets/checkbox_option.html'
+      <django/forms/templates/django/forms/widgets/checkbox_option.html>`
 
     Similar to :class:`SelectMultiple`, but rendered as a list of checkboxes:
 
@@ -899,7 +929,8 @@ File upload widgets
 
 .. class:: FileInput
 
-    * ``template_name``: ``'django/forms/widgets/file.html'``
+    * ``template_name``: :sourcefile:`'django/forms/widgets/file.html'
+      <django/forms/templates/django/forms/widgets/file.html>`
     * Renders as: ``<input type="file" ...>``
 
 ``ClearableFileInput``
@@ -907,7 +938,9 @@ File upload widgets
 
 .. class:: ClearableFileInput
 
-    * ``template_name``: ``'django/forms/widgets/clearable_file_input.html'``
+    * ``template_name``:
+      :sourcefile:`'django/forms/widgets/clearable_file_input.html'
+      <django/forms/templates/django/forms/widgets/clearable_file_input.html>`
     * Renders as: ``<input type="file" ...>`` with an additional checkbox
       input to clear the field's value, if the field is not required and has
       initial data.
@@ -922,7 +955,9 @@ Composite widgets
 
 .. class:: MultipleHiddenInput
 
-    * ``template_name``: ``'django/forms/widgets/multiple_hidden.html'``
+    * ``template_name``:
+      :sourcefile:`'django/forms/widgets/multiple_hidden.html'
+      <django/forms/templates/django/forms/widgets/multiple_hidden.html>`
     * Renders as: multiple ``<input type="hidden" ...>`` tags
 
     A widget that handles multiple hidden widgets for fields that have a list
@@ -933,7 +968,8 @@ Composite widgets
 
 .. class:: SplitDateTimeWidget
 
-    * ``template_name``: ``'django/forms/widgets/splitdatetime.html'``
+    * ``template_name``: :sourcefile:`'django/forms/widgets/splitdatetime.html'
+      <django/forms/templates/django/forms/widgets/splitdatetime.html>`
 
     Wrapper (using :class:`MultiWidget`) around two widgets: :class:`DateInput`
     for the date, and :class:`TimeInput` for the time. Must be used with
@@ -962,7 +998,9 @@ Composite widgets
 
 .. class:: SplitHiddenDateTimeWidget
 
-    * ``template_name``: ``'django/forms/widgets/splithiddendatetime.html'``
+    * ``template_name``:
+      :sourcefile:`'django/forms/widgets/splithiddendatetime.html'
+      <django/forms/templates/django/forms/widgets/splithiddendatetime.html>`
 
     Similar to :class:`SplitDateTimeWidget`, but uses :class:`HiddenInput` for
     both date and time.
@@ -972,7 +1010,8 @@ Composite widgets
 
 .. class:: SelectDateWidget
 
-    * ``template_name``: ``'django/forms/widgets/select_date.html'``
+    * ``template_name``: :sourcefile:`'django/forms/widgets/select_date.html'
+      <django/forms/templates/django/forms/widgets/select_date.html>`
 
     Wrapper around three :class:`~django.forms.Select` widgets: one each for
     month, day, and year.
diff --git a/docs/topics/forms/formsets.txt b/docs/topics/forms/formsets.txt
index 28597464a32e..cb1811078b20 100644
--- a/docs/topics/forms/formsets.txt
+++ b/docs/topics/forms/formsets.txt
@@ -899,28 +899,33 @@ Formsets have the following attributes and methods associated with rendering:
 .. attribute:: BaseFormSet.template_name_div
 
     The name of the template used when calling :meth:`.as_div`. By default this
-    is ``"django/forms/formsets/div.html"``. This template renders the
-    formset's management form and then each form in the formset as per the
-    form's :meth:`~django.forms.Form.as_div` method.
+    is :sourcefile:`"django/forms/formsets/div.html"
+    <django/forms/templates/django/forms/formsets/div.html>`. This template
+    renders the formset's management form and then each form in the formset as
+    per the form's :meth:`~django.forms.Form.as_div` method.
 
 .. attribute:: BaseFormSet.template_name_p
 
     The name of the template used when calling :meth:`.as_p`. By default this
-    is ``"django/forms/formsets/p.html"``. This template renders the formset's
-    management form and then each form in the formset as per the form's
-    :meth:`~django.forms.Form.as_p` method.
+    is :sourcefile:`"django/forms/formsets/p.html"
+    <django/forms/templates/django/forms/formsets/p.html>`. This template
+    renders the formset's management form and then each form in the formset as
+    per the form's :meth:`~django.forms.Form.as_p` method.
 
 .. attribute:: BaseFormSet.template_name_table
 
     The name of the template used when calling :meth:`.as_table`. By default
-    this is ``"django/forms/formsets/table.html"``. This template renders the
-    formset's management form and then each form in the formset as per the
-    form's :meth:`~django.forms.Form.as_table` method.
+    this is :sourcefile:`"django/forms/formsets/table.html"
+    <django/forms/templates/django/forms/formsets/table.html>`. This template
+    renders the formset's management form and then each form in the formset as
+    per the form's :meth:`~django.forms.Form.as_table` method.
 
 .. attribute:: BaseFormSet.template_name_ul
 
     The name of the template used when calling :meth:`.as_ul`. By default this
-    is ``"django/forms/formsets/ul.html"``. This template renders the formset's
+    is :sourcefile:`"django/forms/formsets/ul.html"
+    <django/forms/templates/django/forms/formsets/ul.html>`.
+    This template renders the formset's
     management form and then each form in the formset as per the form's
     :meth:`~django.forms.Form.as_ul` method.
 
diff --git a/docs/topics/forms/index.txt b/docs/topics/forms/index.txt
index d74cea445dee..286440eb049d 100644
--- a/docs/topics/forms/index.txt
+++ b/docs/topics/forms/index.txt
@@ -611,8 +611,10 @@ in the required layout. For example:
       {{ form.urgent.as_field_group }}
     </div>
 
-By default Django uses the ``"django/forms/field.html"`` template which is
-designed for use with the default ``"django/forms/div.html"`` form style.
+By default Django uses the :sourcefile:`"django/forms/field.html"
+<django/forms/templates/django/forms/field.html>` template which is designed
+for use with the default :sourcefile:`"django/forms/div.html"
+<django/forms/templates/django/forms/div.html>` form style.
 
 The default template can be customized by setting
 :attr:`~django.forms.renderers.BaseRenderer.field_template_name` in your