Update ImageDraw docs formatting and links

Author: hugovk

docs/reference/ImageDraw.rst

@@ -81,13 +81,13 @@ Example: Draw Partial Opacity Text
 
     from PIL import Image, ImageDraw, ImageFont
     # get an image
-    base = Image.open('Pillow/Tests/images/hopper.png').convert('RGBA')
+    base = Image.open("Pillow/Tests/images/hopper.png").convert("RGBA")
 
     # make a blank image for the text, initialized to transparent text color
-    txt = Image.new('RGBA', base.size, (255,255,255,0))
+    txt = Image.new("RGBA", base.size, (255,255,255,0))
 
     # get a font
-    fnt = ImageFont.truetype('Pillow/Tests/fonts/FreeMono.ttf', 40)
+    fnt = ImageFont.truetype("Pillow/Tests/fonts/FreeMono.ttf", 40)
     # get a drawing context
     d = ImageDraw.Draw(txt)
 
@@ -280,25 +280,25 @@ Methods
 
     :param xy: Top left corner of the text.
     :param text: Text to be drawn. If it contains any newline characters,
-                 the text is passed on to multiline_text()
+                 the text is passed on to ``multiline_text()``
     :param fill: Color to use for the text.
     :param font: An :py:class:`~PIL.ImageFont.ImageFont` instance.
-    :param spacing: If the text is passed on to multiline_text(),
+    :param spacing: If the text is passed on to ``multiline_text()``,
                     the number of pixels between lines.
-    :param align: If the text is passed on to multiline_text(),
+    :param align: If the text is passed on to ``multiline_text()``,
                   "left", "center" or "right".
-    :param direction: Direction of the text. It can be 'rtl' (right to
-                      left), 'ltr' (left to right) or 'ttb' (top to bottom).
+    :param direction: Direction of the text. It can be ``"rtl"`` (right to
+                      left), ``"ltr"`` (left to right) or ``"ttb"`` (top to bottom).
                       Requires libraqm.
 
                       .. versionadded:: 4.2.0
 
     :param features: A list of OpenType font features to be used during text
                      layout. This is usually used to turn on optional
                      font features that are not enabled by default,
-                     for example 'dlig' or 'ss01', but can be also
-                     used to turn off default font features for
-                     example '-liga' to disable ligatures or '-kern'
+                     for example ``"dlig"`` or ``"ss01"``, but can be also
+                     used to turn off default font features, for
+                     example ``"-liga"`` to disable ligatures or ``"-kern"``
                      to disable kerning.  To get all supported
                      features, see
                      https://docs.microsoft.com/en-us/typography/opentype/spec/featurelist
@@ -310,8 +310,7 @@ Methods
                      different glyph shapes or ligatures. This parameter tells
                      the font which language the text is in, and to apply the
                      correct substitutions as appropriate, if available.
-                     It should be a `BCP 47 language code
-                     <https://www.w3.org/International/articles/language-tags/>`
+                     It should be a `BCP 47 language code`_.
                      Requires libraqm.
 
                      .. versionadded:: 6.0.0
@@ -334,19 +333,19 @@ Methods
     :param fill: Color to use for the text.
     :param font: An :py:class:`~PIL.ImageFont.ImageFont` instance.
     :param spacing: The number of pixels between lines.
-    :param align: "left", "center" or "right".
-    :param direction: Direction of the text. It can be 'rtl' (right to
-                      left), 'ltr' (left to right) or 'ttb' (top to bottom).
+    :param align: ``"left"``, ``"center"`` or ``"right"``.
+    :param direction: Direction of the text. It can be ``"rtl"`` (right to
+                      left), ``"ltr"`` (left to right) or ``"ttb"`` (top to bottom).
                       Requires libraqm.
 
                       .. versionadded:: 4.2.0
 
     :param features: A list of OpenType font features to be used during text
                      layout. This is usually used to turn on optional
                      font features that are not enabled by default,
-                     for example 'dlig' or 'ss01', but can be also
-                     used to turn off default font features for
-                     example '-liga' to disable ligatures or '-kern'
+                     for example ``"dlig"`` or ``"ss01"``, but can be also
+                     used to turn off default font features, for
+                     example ``"-liga"`` to disable ligatures or ``"-kern"``
                      to disable kerning.  To get all supported
                      features, see
                      https://docs.microsoft.com/en-us/typography/opentype/spec/featurelist
@@ -358,8 +357,7 @@ Methods
                      different glyph shapes or ligatures. This parameter tells
                      the font which language the text is in, and to apply the
                      correct substitutions as appropriate, if available.
-                     It should be a `BCP 47 language code
-                     <https://www.w3.org/International/articles/language-tags/>`
+                     It should be a `BCP 47 language code`_.
                      Requires libraqm.
 
                      .. versionadded:: 6.0.0
@@ -369,21 +367,21 @@ Methods
     Return the size of the given string, in pixels.
 
     :param text: Text to be measured. If it contains any newline characters,
-                 the text is passed on to multiline_textsize()
+                 the text is passed on to ``multiline_textsize()``
     :param font: An :py:class:`~PIL.ImageFont.ImageFont` instance.
-    :param spacing: If the text is passed on to multiline_textsize(),
+    :param spacing: If the text is passed on to ``multiline_textsize()``,
                     the number of pixels between lines.
-    :param direction: Direction of the text. It can be 'rtl' (right to
-                      left), 'ltr' (left to right) or 'ttb' (top to bottom).
+    :param direction: Direction of the text. It can be ``"rtl"`` (right to
+                      left), ``"ltr"`` (left to right) or ``"ttb"`` (top to bottom).
                       Requires libraqm.
 
                       .. versionadded:: 4.2.0
     :param features: A list of OpenType font features to be used during text
                      layout. This is usually used to turn on optional
                      font features that are not enabled by default,
-                     for example 'dlig' or 'ss01', but can be also
-                     used to turn off default font features for
-                     example '-liga' to disable ligatures or '-kern'
+                     for example ``"dlig"`` or ``"ss01"``, but can be also
+                     used to turn off default font features, for
+                     example ``"-liga"`` to disable ligatures or ``"-kern"``
                      to disable kerning.  To get all supported
                      features, see
                      https://docs.microsoft.com/en-us/typography/opentype/spec/featurelist
@@ -394,8 +392,7 @@ Methods
                      different glyph shapes or ligatures. This parameter tells
                      the font which language the text is in, and to apply the
                      correct substitutions as appropriate, if available.
-                     It should be a `BCP 47 language code
-                     <https://www.w3.org/International/articles/language-tags/>`
+                     It should be a `BCP 47 language code`_.
                      Requires libraqm.
 
                      .. versionadded:: 6.0.0
@@ -411,18 +408,18 @@ Methods
     :param text: Text to be measured.
     :param font: An :py:class:`~PIL.ImageFont.ImageFont` instance.
     :param spacing: The number of pixels between lines.
-    :param direction: Direction of the text. It can be 'rtl' (right to
-                      left), 'ltr' (left to right) or 'ttb' (top to bottom).
+    :param direction: Direction of the text. It can be ``"rtl"`` (right to
+                      left), ``"ltr"`` (left to right) or ``"ttb"`` (top to bottom).
                       Requires libraqm.
 
                       .. versionadded:: 4.2.0
 
     :param features: A list of OpenType font features to be used during text
                      layout. This is usually used to turn on optional
                      font features that are not enabled by default,
-                     for example 'dlig' or 'ss01', but can be also
-                     used to turn off default font features for
-                     example '-liga' to disable ligatures or '-kern'
+                     for example ``"dlig"`` or ``"ss01"``, but can be also
+                     used to turn off default font features, for
+                     example ``"-liga"`` to disable ligatures or ``"-kern"``
                      to disable kerning.  To get all supported
                      features, see
                      https://docs.microsoft.com/en-us/typography/opentype/spec/featurelist
@@ -434,8 +431,7 @@ Methods
                      different glyph shapes or ligatures. This parameter tells
                      the font which language the text is in, and to apply the
                      correct substitutions as appropriate, if available.
-                     It should be a `BCP 47 language code
-                     <https://www.w3.org/International/articles/language-tags/>`
+                     It should be a `BCP 47 language code`_.
                      Requires libraqm.
 
                      .. versionadded:: 6.0.0
@@ -472,3 +468,5 @@ Methods
         tolerable difference of a pixel value from the 'background' in
         order for it to be replaced. Useful for filling regions of non-
         homogeneous, but similar, colors.
+
+.. _BCP 47 language code: https://www.w3.org/International/articles/language-tags/