How to use Django specific markup in the docstrings.

[Anuj Sharma]

I am using Sphinx to generate documentation from the docstrings defined in the models, views, etc files.

At a few places, I have used Django specific markup for creating reference link. Same is documented in the [writing-documentation](​https://docs.djangoproject.com/en/dev/internals/contributing/writing-documentation/#django-specific-markup)

Ex.

The length is defined in the :setting:`URL_ID_LENGTH`

But while generating the documentation using

make html

it gives an error as

:docstring of app.models.Class.function:4: WARNING: Unknown interpreted text role "setting".

How to use the Django specific markups? This should be added to the documentation as well.

Here is an issue on StackOverflow: ​https://stackoverflow.com/q/56803854/3719167