Used :rfc: role in various docs.

This commit is contained in:
Mariusz Felisiak 2020-04-15 13:11:13 +02:00
parent 71c4fb7beb
commit f1a808a502
8 changed files with 21 additions and 32 deletions

View file

@ -143,11 +143,12 @@ from then on, you can treat the result as always being a string.
URI and IRI handling
~~~~~~~~~~~~~~~~~~~~
Web frameworks have to deal with URLs (which are a type of IRI_). One
Web frameworks have to deal with URLs (which are a type of IRI). One
requirement of URLs is that they are encoded using only ASCII characters.
However, in an international environment, you might need to construct a
URL from an IRI_ -- very loosely speaking, a URI_ that can contain Unicode
characters. Use these functions for quoting and converting an IRI to a URI:
URL from an :rfc:`IRI <3987>` -- very loosely speaking, a :rfc:`URI <2396>`
that can contain Unicode characters. Use these functions for quoting and
converting an IRI to a URI:
* The :func:`django.utils.encoding.iri_to_uri()` function, which implements the
conversion from IRI to URI as required by :rfc:`3987#section-3.1`.
@ -213,9 +214,6 @@ following is always true::
So you can safely call it multiple times on the same URI/IRI without risking
double-quoting problems.
.. _URI: https://www.ietf.org/rfc/rfc2396.txt
.. _IRI: https://www.ietf.org/rfc/rfc3987.txt
Models
======