Alias offset(D) for text

Author: weiji14

pygmt/base_plotting.py

@@ -813,7 +813,15 @@ def legend(self, spec=None, position="JTR+jTR+o0.2c", box="+gwhite+p1p", **kwarg
             lib.call_module("legend", arg_str)
 
     @fmt_docstring
-    @use_alias(R="region", J="projection", B="frame", C="clearance", G="fill", W="pen")
+    @use_alias(
+        R="region",
+        J="projection",
+        B="frame",
+        C="clearance",
+        D="offset",
+        G="fill",
+        W="pen",
+    )
     @kwargs_to_strings(
         R="sequence",
         textfiles="sequence_space",
@@ -907,6 +915,16 @@ def text(
             Sets the shade or color used for filling the text box [Default is
             no fill].
             instead.
+        offset : str
+            ``[j|J]dx[/dy][+v[pen]]``
+            Offsets the text from the projected (x,y) point by dx,dy [0/0]. If
+            dy is not specified then it is set equal to dx. Use offset='j' to
+            offset the text away from the point instead (i.e., the text
+            justification will determine the direction of the shift). Using
+            offset='J' will shorten diagonal offsets at corners by sqrt(2).
+            Optionally, append '+v' which will draw a line from the original
+            point to the shifted point; append a pen to change the attributes
+            for this line.
         pen : str
             Sets the pen used to draw a rectangle around the text string
             (see *clearance*) [Default is width = default, color = black,

pygmt/tests/baseline/test_text_position_offset_with_line.png

@@ -121,6 +121,25 @@ def test_text_xy_with_position_fails(region, projection):
         )
 
 
+@pytest.mark.mpl_image_compare
+def test_text_position_offset_with_line(region):
+    """
+    Print text at four corners (top left/right, bottom left/right) of map,
+    offset by 0.5 cm, with a line drawn from the original to the shifted point.
+    """
+    fig = Figure()
+    for position in ("TL", "TR", "BL", "BR"):
+        fig.text(
+            region=region,
+            projection="x1c",
+            frame="a",
+            position=position,
+            text=position,
+            offset="j0.5c+v",
+        )
+    return fig
+
+
 @pytest.mark.mpl_image_compare
 def test_text_angle_30(region, projection):
     """