8000 Cleanup code blocks and branch names in docs · codingjoe/django-mail-auth@ac9c631 · GitHub
[go: up one dir, main page]

Skip to content

Commit ac9c631

Browse files
committed
Cleanup code blocks and branch names in docs
1 parent b618eb9 commit ac9c631

File tree

2 files changed

+20
-9
lines changed

2 files changed

+20
-9
lines changed

README.rst

Lines changed: 14 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,9 @@ Run this command to install ``django-mail-auth``::
4343
Setup
4444
-----
4545

46-
First add ``mailauth`` to you installed apps::
46+
First add ``mailauth`` to you installed apps:
47+
48+
.. code-block:: python
4749
4850
INSTALLED_APPS = [
4951
# Django's builtin apps…
@@ -64,7 +66,8 @@ First add ``mailauth`` to you installed apps::
6466
with token based authentication too.
6567

6668
``mailauth.contrib.user`` is optional and provides a new Django User model.
67-
The new User model needs to be enabled via the ``AUTH_USER_MODEL`` setting::
69+
The new User model needs to be enabled via the ``AUTH_USER_MODEL`` setting:
70+
.. code-block:: python
6871
6972
# This setting should be either "EmailUser" or
7073
# any custom subclass of "AbstractEmailUser"
@@ -74,7 +77,9 @@ The new User model needs to be enabled via the ``AUTH_USER_MODEL`` setting::
7477
WAGTAILUSERS_PASSWORD_ENABLED = False
7578
7679
77-
Next you will need to add the new authentication backend::
80+
Next you will need to add the new authentication backend:
81+
82+
.. code-block:: python
7883
7984
AUTHENTICATION_BACKENDS = (
8085
# default, but now optional
@@ -89,7 +94,9 @@ Next you will need to add the new authentication backend::
8994
Django's ``ModelBackend`` is only needed, if you still want to support
9095
password based authentication. If you don't, simply remove it from the list.
9196

92-
Last but not least, go to your URL root configuration ``urls.py`` and add the following::
97+
Last but not least, go to your URL root configuration ``urls.py`` and add the following:
98+
99+
.. code-block:: python
93100
94101
from django.urls import path
95102
@@ -107,12 +114,12 @@ That's it!
107114

108115
.. |version| image:: https://img.shields.io/pypi/v/django-mail-auth.svg
109116
:target: https://pypi.python.org/pypi/django-mail-auth/
110-
.. |ci| image:: https://travis-ci.com/codingjoe/django-mail-auth.svg?branch=master
117+
.. |ci| image:: https://travis-ci.com/codingjoe/django-mail-auth.svg?branch=main
111118
:target: https://travis-ci.com/codingjoe/django-mail-auth
112-
.. |coverage| image:: https://codecov.io/gh/codingjoe/django-mail-auth/branch/master/graph/badge.svg
119+
.. |coverage| image:: https://codecov.io/gh/codingjoe/django-mail-auth/branch/main/graph/badge.svg
113120
:target: https://codecov.io/gh/codingjoe/django-mail-auth
114121
.. |license| image:: https://img.shields.io/badge/license-MIT-blue.svg
115-
:target: :target: https://raw.githubusercontent.com/codingjoe/django-mail-auth/master/LICENSE
122+
:target: :target: https://raw.githubusercontent.com/codingjoe/django-mail-auth/main/LICENSE
116123
.. |docs| image:: https://readthedocs.org/projects/django-mail-auth/badge/?version=latest
117124
:target: https://django-mail-auth.readthedocs.io/en/latest/?badge=latest
118125
:alt: Documentation Status

docs/customizing.rst

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,9 @@ Custom login forms need to inherit from :class:`.BaseLoginForm` and override
1616
the :meth:`save<.BaseLoginForm.save>` method.
1717

1818
The following example is for a login SMS. This will require a
19-
custom user model with a unique ``phone_number`` field::
19+
custom user model with a unique ``phone_number`` field:
20+
21+
.. code-block:: python
2022
2123
from django import forms
2224
from django.contrib.auth import get_user_model
@@ -59,7 +61,9 @@ custom user model with a unique ``phone_number`` field::
5961
6062
6163
To add the new login form, simply add a new login view to your URL configuration with
62-
the custom form::
64+
the custom form:
65+
66+
.. code-block:: python
6367
6468
from django.urls import path
6569
from mailauth.views import LoginView

0 commit comments

Comments
 (0)
0