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

[4.2.x] Added meaningful titles to ..admonition:: directives.

Browse Source 
Backport of c487634c10 from main
This commit is contained in:
Mariusz Felisiak
2023-04-21 12:03:59 +02:00
parent d1eb9b2994
commit a4f7d935a2
5 changed files with 10 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files

10
docs/ref/contrib/admin/index.txt
View File

@@ -327,7 +327,7 @@ subclass::
class FlatPageAdmin(admin.ModelAdmin):
fields = [("url", "title"), "content"]
.. admonition:: Note
.. admonition:: Possible confusion with the ``ModelAdmin.fieldsets`` option
This ``fields`` option should not be confused with the ``fields``
dictionary key that is within the :attr:`~ModelAdmin.fieldsets` option,
@@ -466,7 +466,7 @@ subclass::
For an example see the section :ref:`admin-custom-validation`.
.. admonition:: Note
.. admonition:: Omit the ``Meta.model`` attribute
If you define the ``Meta.model`` attribute on a
:class:`~django.forms.ModelForm`, you must also define the
@@ -480,7 +480,7 @@ subclass::
``fields = []`` in the ``Meta`` class to satisfy the validation on the
``ModelForm``.
.. admonition:: Note
.. admonition:: ``ModelAdmin.exclude`` takes precedence
If your ``ModelForm`` and ``ModelAdmin`` both define an ``exclude``
option then ``ModelAdmin`` takes precedence::
@@ -1770,7 +1770,7 @@ templates used by the :class:`ModelAdmin` views:
kwargs["choices"].append(("ready", "Ready for deployment"))
return super().formfield_for_choice_field(db_field, request, **kwargs)
.. admonition:: Note
.. admonition:: ``choices`` limitations
Any ``choices`` attribute set on the formfield will be limited to the
form field only. If the corresponding field on the model has choices
@@ -1801,7 +1801,7 @@ templates used by the :class:`ModelAdmin` views:
def get_changelist_form(self, request, **kwargs):
return MyForm
.. admonition:: Note
.. admonition:: Omit the ``Meta.model`` attribute
If you define the ``Meta.model`` attribute on a
:class:`~django.forms.ModelForm`, you must also define the