reStructuredText Cheatsheet¶
The GMT documentations are written in reStructureText (ReST) and built by Sphinx. Here is a quick and dirty cheat sheet for some common ReST stuff used in GMT documentations. You can see the literal source code of the ReST file on the right, and the rendered web page on the left.
Note
Try a online reStructuredText editor (e.g. http://rst.ninjs.org/), if you want to preview texts written in ReST.
For a more complete description of ReST syntax, please visit the Sphinx documentation.
Formatting text¶
Paragraphs are simply chunks of text separated by one or more blank lines.
It’s simple to use inline markup to have italic text,
bold text, and inline source codes
.
It’s a little complicated to write a GMT option. You need to use backslash + pipe to have a pipe (|) and backslash + whitespace to separate inline markups.
-Avalue[+wpen][+a|b|c]
Lists¶
Bullet list:
- Point A
- Point B
- Point C
- Point D
Numbered list:
- Point 1
- Point 2
- Point 3
- Point 4
Definition list:
- term1
- Definition of term1
- term2
- Definition of term2
Table¶
ReST supports multiple ways to make a table.
Simple Table¶
A | B | A and B |
---|---|---|
False | False | False |
True | False | False |
False | True | False |
True | True | True |
Grid Table¶
Header row, column 1 | Header 2 | Header 3 | Header 4 |
---|---|---|---|
body row 1, column 1 | column 2 | column 3 | column 4 |
body row 2 | … | … |
Links¶
Internal links¶
Link to the a module with plot or plot.
Link to a section title with Lists.
Link to a target with Link to a table.
Codes¶
gmt begin map
gmt basemap -R0/10/0/10 -JX10c/10c -Baf
gmt end
Formatting text
===============
Paragraphs are simply chunks of text separated by one or
more blank lines.
It's simple to use inline markup to have *italic text*,
**bold text**, and ``inline source codes``.
It's a little complicated to write a GMT option.
You need to use backslash + pipe to have a pipe (|) and
backslash + whitespace to separate inline markups.
**-A**\ *value*\ [**+w**\ *pen*][**+a**\|\ **b**\|\ **c**]
Lists
=====
**Bullet list:**
- Point A
- Point B
- Point C
- Point D
**Numbered list**:
#. Point 1
#. Point 2
#. Point 3
#. Point 4
**Definition list**:
term1
Definition of term1
term2
Definition of term2
Table
=====
ReST supports multiple ways to make a table.
Simple Table
------------
===== ===== =======
A B A and B
===== ===== =======
False False False
True False False
False True False
True True True
===== ===== =======
Grid Table
----------
.. _tbl-grid:
+----------------------+------------+----------+----------+
| Header row, column 1 | Header 2 | Header 3 | Header 4 |
| | | | |
+======================+============+==========+==========+
| body row 1, column 1 | column 2 | column 3 | column 4 |
+----------------------+------------+----------+----------+
| body row 2 | ... | ... | |
+----------------------+------------+----------+----------+
Links
=====
External links
--------------
https://generic-mapping-tools.org
`GMT Forum <https://forum.generic-mapping-tools.org/>`_
Internal links
--------------
Link to the a module with :doc:`plot` or :doc:`/plot`.
Link to a section title with `Lists`_.
Link to a target with :ref:`Link to a table <tbl-grid>`.
Codes
=====
::
gmt begin map
gmt basemap -R0/10/0/10 -JX10c/10c -Baf
gmt end
Images
======
Use the ``figure`` directive to include images:
.. figure:: /_images/GMT_coverlogo.png
:width: 90%
Figure caption