Figure.text: Support passing in a list of angle/font/justify values

[seisman]

Description of proposed changes

Address an old feature request #483.

Example:

import pygmt
fig = pygmt.Figure()
fig.basemap(region=[0, 5, 0., 2.5], projection="X5c/2.5c", frame=True)
fig.text(
    x=[2.5, 2.5],
    y=[1.0, 2.0],
    angle=[30, 50],
    justify=["TL", "BR"],
    font=["15p,Helvetica-Bold,red", "5p,Times-Italic,blue"],
    text=["TEXT1", "TEXT2 with spaces"],
)
fig.show()

Preview:

Note: Need to fix the bug in #2719 first.

Closes #483.

Reminders

• Run make format and make check to make sure the code follows the style guide.
• Add tests for new features or tests that would have caught the bug that you're fixing.
• Add new public functions/methods/classes to doc/api/index.rst.
• Write detailed docstrings for all functions/methods.
• If wrapping a new module, open a 'Wrap new GMT module' issue and submit reasonably-sized PRs.
• If adding new functionality, add an example to docstrings or tutorials.
• Use underscores (not hyphens) in names of Python files and directories.

Slash Commands

You can write slash commands (/command) in the first line of a comment to perform
specific operations. Supported slash commands are:

• /format: automatically format and lint the code
• /test-gmt-dev: run full tests on the latest GMT development version

[github-actions]

Summary of changed images

This is an auto-generated report of images that have changed on the DVC remote

Status	Path
added	pygmt/tests/baseline/test_text_angle_justify_font_arrays.png

Image diff(s)

Added images

• test_text_angle_justify_font_arrays.png

Modified images

Path	Old	New

Report last updated at commit c39f196

[seisman]

These lines were initially added in #321, but they should NOT be like this.

[yvonnefroehlich]

This is a nice improvement of the pygmt.Figure.text method @seisman! I am wondering whether it makes sense to expand the tutorial Plotting text to show this possibility? Additionally, to the option of Plotting from a text file to adjust angle, font, and justify individually,

[seisman]

Yes, please do it if you're interested.