Add Figure.paragraph to typeset one or multiple paragraph of text strings

[seisman]

Initial implementation for the Figure.paragraph method, which wraps the text module's -M option.

Related to #3710.

Preview:

• https://pygmt-dev--3709.org.readthedocs.build/en/3709/api/generated/pygmt.Figure.paragraph.html
• https://pygmt-dev--3709.org.readthedocs.build/en/3709/api/generated/pygmt.Figure.text.html

Example

import pygmt

fig = pygmt.Figure()
fig.basemap(region=[0, 10, 0, 10], projection="X10c/10c", frame=True)
fig.paragraph(
    x=4,
    y=4,
    text="This is a long paragraph. " * 10,
    parwidth="5c",
    linespacing="12p",
    font="12p",
)
fig.show()

[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_paragraph.png
added	pygmt/tests/baseline/test_paragraph_multiple_paragraphs_blankline.png
added	pygmt/tests/baseline/test_paragraph_multiple_paragraphs_list.png

Image diff(s)

Details

Added images

• test_paragraph.png

• test_paragraph_multiple_paragraphs_blankline.png

• test_paragraph_multiple_paragraphs_list.png

Modified images

Path	Old	New

Report last updated at commit 6e362aa