DOC/projections: Simplify links in the projection table by using the titles of the examples (#3407)

yvonnefroehlich · seisman · web-flow · commit 5f96b77203da · 2024-09-24T15:14:18.000+08:00
Co-authored-by: Dongdong Tian &lt;seisman.info@gmail.com&gt;
diff --git a/doc/techref/projections.md b/doc/techref/projections.md
@@ -16,34 +16,34 @@ The table below shows the projection codes for the 31 GMT map projections:
 
 | PyGMT Projection Argument | Projection Name |
 | --- | --- |
-| **A**{{ lon0 }}/{{ lat0 }}[/*horizon*]/*width*              | {doc}`Lambert azimuthal equal area </projections/azim/azim_lambert>` |
-| **B**{{ lon0 }}/{{ lat0 }}/{{ lat1 }}/{{ lat2 }}/*width*    | {doc}`Albers conic equal area </projections/conic/conic_albers>` |
-| **C**{{ lon0 }}/{{ lat0 }}/*width*                          | {doc}`Cassini cylindrical </projections/cyl/cyl_cassini>` |
-| **Cyl_stere**/[{{ lon0 }}/[{{ lat0 }}/]]*width*             | {doc}`Cylindrical stereographic </projections/cyl/cyl_stereographic>` |
-| **D**{{ lon0 }}/{{ lat0 }}/{{ lat1 }}/{{ lat2 }}/*width*    | {doc}`Equidistant conic </projections/conic/conic_equidistant>` |
-| **E**{{ lon0 }}/{{ lat0 }}[/*horizon*]/*width*              | {doc}`Azimuthal equidistant </projections/azim/azim_equidistant>` |
-| **F**{{ lon0 }}/{{ lat0 }}[/*horizon*]/*width*              | {doc}`Azimuthal gnomonic </projections/azim/azim_gnomonic>` |
-| **G**{{ lon0 }}/{{ lat0 }}[/*horizon*]/*width*              | {doc}`Azimuthal orthographic </projections/azim/azim_orthographic>` |
-| **G**{{ lon0 }}/{{ lat0 }}/*width*[**+a***azimuth*][**+t***tilt*][**+v***vwidth*/*vheight*][**+w***twist*][**+z***altitude*] | {doc}`General perspective </projections/azim/azim_general_perspective>` |
-| **H**[{{ lon0 }}/]*width*                                   | {doc}`Hammer equal area </projections/misc/misc_hammer>` |
-| **I**[{{ lon0 }}/]*width*                                   | {doc}`Sinusoidal equal area </projections/misc/misc_sinusoidal>` |
-| **J**[{{ lon0 }}/]*width*                                   | {doc}`Miller cylindrical </projections/cyl/cyl_miller>` |
-| **Kf**[{{ lon0 }}/]*width*                                  | {doc}`Eckert IV equal area </projections/misc/misc_eckertIV>` |
-| **Ks**[{{ lon0 }}/]*width*                                  | {doc}`Eckert VI equal area </projections/misc/misc_eckertVI>` |
-| **L**{{ lon0 }}/{{ lat0 }}/{{ lat1 }}/{{ lat2 }}/*width*    | {doc}`Lambert conic conformal </projections/conic/conic_lambert>` |
-| **M**[{{ lon0 }}/[{{ lat0 }}/]]*width*                      | {doc}`Mercator cylindrical </projections/cyl/cyl_mercator>` |
-| **N**[{{ lon0 }}/]*width*                                   | {doc}`Robinson </projections/misc/misc_robinson>` |
-| **Oa**{{ lon0 }}/{{ lat0 }}/*azimuth*/*width*[**+v**]       | {doc}`Oblique Mercator, 1: origin and azimuth </projections/cyl/cyl_oblique_mercator_1>` |
-| **Ob**{{ lon0 }}/{{ lat0 }}/{{ lon1 }}/{{ lat1 }}/*width*[**+v**] | {doc}`Oblique Mercator, 2: two points </projections/cyl/cyl_oblique_mercator_2>` |
-| **Oc**{{ lon0 }}/{{ lat0 }}/{{ lonp }}/{{ latp }}/*width*[**+v**] | {doc}`Oblique Mercator, 3: origin and pole </projections/cyl/cyl_oblique_mercator_3>` |
-| **P***width*[**+a**][**+f**[**e**\|**p**\|*radius*]][**+r***offset*][**+t***origin*][**+z**[**p**\|*radius*]] | {doc}`Polar </projections/nongeo/polar>` [azimuthal] ({math}`\theta, r`) (or cylindrical) |
-| **Poly**/[{{ lon0 }}/[{{ lat0 }}/]]*width*                  | {doc}`Polyconic </projections/conic/polyconic>` |
-| **Q**[{{ lon0 }}/[{{ lat0 }}/]]*width*                      | {doc}`Equidistant cylindrica </projections/cyl/cyl_equidistant>` |
-| **R**[{{ lon0 }}/]*width*                                   | {doc}`Winkel Tripel </projections/misc/misc_winkel_tripel>` |
-| **S**{{ lon0 }}/{{ lat0 }}[/*horizon*]/*width*              | {doc}`General stereographic </projections/azim/azim_general_stereographic>` |
-| **T**{{ lon0 }}[/{{ lat0 }}]/*width*                        | {doc}`Transverse Mercator </projections/cyl/cyl_transverse_mercator>` |
-| **U***zone*/*width*                                         | {doc}`Universal Transverse Mercator (UTM) </projections/cyl/cyl_universal_transverse_mercator>` |
-| **V**[{{ lon0 }}/]*width*                                   | {doc}`Van der Grinten </projections/misc/misc_van_der_grinten>` |
-| **W**[{{ lon0 }}/]*width*                                   | {doc}`Mollweide </projections/misc/misc_mollweide>` |
-| **X***width*[**l**\|**p***exp*\|**T**\|**t**][/*height*[**l**\|**p***exp*\|**T**\|**t**]][**d**] | {doc}`Linear </projections/nongeo/cartesian_linear>`, {doc}`logarithmic </projections/nongeo/cartesian_logarithmic>`, {doc}`power </projections/nongeo/cartesian_power>`, and time |
-| **Y**{{ lon0 }}/{{ lat0 }}/*width*                          | {doc}`Cylindrical equal area </projections/cyl/cyl_equal_area>` |
+| **A**{{ lon0 }}/{{ lat0 }}[/*horizon*]/*width*              | {doc}`/projections/azim/azim_lambert` |
+| **B**{{ lon0 }}/{{ lat0 }}/{{ lat1 }}/{{ lat2 }}/*width*    | {doc}`/projections/conic/conic_albers` |
+| **C**{{ lon0 }}/{{ lat0 }}/*width*                          | {doc}`/projections/cyl/cyl_cassini` |
+| **Cyl_stere**/[{{ lon0 }}/[{{ lat0 }}/]]*width*             | {doc}`/projections/cyl/cyl_stereographic` |
+| **D**{{ lon0 }}/{{ lat0 }}/{{ lat1 }}/{{ lat2 }}/*width*    | {doc}`/projections/conic/conic_equidistant` |
+| **E**{{ lon0 }}/{{ lat0 }}[/*horizon*]/*width*              | {doc}`/projections/azim/azim_equidistant` |
+| **F**{{ lon0 }}/{{ lat0 }}[/*horizon*]/*width*              | {doc}`/projections/azim/azim_gnomonic` |
+| **G**{{ lon0 }}/{{ lat0 }}[/*horizon*]/*width*              | {doc}`/projections/azim/azim_orthographic` |
+| **G**{{ lon0 }}/{{ lat0 }}/*width*[**+a***azimuth*][**+t***tilt*][**+v***vwidth*/*vheight*][**+w***twist*][**+z***altitude*] | {doc}`/projections/azim/azim_general_perspective` |
+| **H**[{{ lon0 }}/]*width*                                   | {doc}`/projections/misc/misc_hammer` |
+| **I**[{{ lon0 }}/]*width*                                   | {doc}`/projections/misc/misc_sinusoidal` |
+| **J**[{{ lon0 }}/]*width*                                   | {doc}`/projections/cyl/cyl_miller` |
+| **Kf**[{{ lon0 }}/]*width*                                  | {doc}`/projections/misc/misc_eckertIV` |
+| **Ks**[{{ lon0 }}/]*width*                                  | {doc}`/projections/misc/misc_eckertVI` |
+| **L**{{ lon0 }}/{{ lat0 }}/{{ lat1 }}/{{ lat2 }}/*width*    | {doc}`/projections/conic/conic_lambert` |
+| **M**[{{ lon0 }}/[{{ lat0 }}/]]*width*                      | {doc}`/projections/cyl/cyl_mercator` |
+| **N**[{{ lon0 }}/]*width*                                   | {doc}`/projections/misc/misc_robinson` |
+| **Oa**{{ lon0 }}/{{ lat0 }}/*azimuth*/*width*[**+v**]       | {doc}`/projections/cyl/cyl_oblique_mercator_1` |
+| **Ob**{{ lon0 }}/{{ lat0 }}/{{ lon1 }}/{{ lat1 }}/*width*[**+v**] | {doc}`/projections/cyl/cyl_oblique_mercator_2` |
+| **Oc**{{ lon0 }}/{{ lat0 }}/{{ lonp }}/{{ latp }}/*width*[**+v**] | {doc}`/projections/cyl/cyl_oblique_mercator_3` |
+| **P***width*[**+a**][**+f**[**e**\|**p**\|*radius*]][**+r***offset*][**+t***origin*][**+z**[**p**\|*radius*]] | Polar {doc}`azimuthal </projections/nongeo/polar>` ({math}`\theta, r`) or cylindrical |
+| **Poly**/[{{ lon0 }}/[{{ lat0 }}/]]*width*                  | {doc}`/projections/conic/polyconic` |
+| **Q**[{{ lon0 }}/[{{ lat0 }}/]]*width*                      | {doc}`/projections/cyl/cyl_equidistant` |
+| **R**[{{ lon0 }}/]*width*                                   | {doc}`/projections/misc/misc_winkel_tripel` |
+| **S**{{ lon0 }}/{{ lat0 }}[/*horizon*]/*width*              | {doc}`/projections/azim/azim_general_stereographic` |
+| **T**{{ lon0 }}[/{{ lat0 }}]/*width*                        | {doc}`/projections/cyl/cyl_transverse_mercator` |
+| **U***zone*/*width*                                         | {doc}`/projections/cyl/cyl_universal_transverse_mercator` |
+| **V**[{{ lon0 }}/]*width*                                   | {doc}`/projections/misc/misc_van_der_grinten` |
+| **W**[{{ lon0 }}/]*width*                                   | {doc}`/projections/misc/misc_mollweide` |
+| **X***width*[**l**\|**p***exp*\|**T**\|**t**][/*height*[**l**\|**p***exp*\|**T**\|**t**]][**d**] | Cartesian {doc}`linear </projections/nongeo/cartesian_linear>`, {doc}`logarithmic </projections/nongeo/cartesian_logarithmic>`, {doc}`power </projections/nongeo/cartesian_power>`, and time |
+| **Y**{{ lon0 }}/{{ lat0 }}/*width*                          | {doc}`/projections/cyl/cyl_equal_area` |
diff --git a/examples/projections/azim/azim_equidistant.py b/examples/projections/azim/azim_equidistant.py
@@ -1,6 +1,6 @@
 r"""
-Azimuthal Equidistant
-=====================
+Azimuthal equidistant projection
+================================
 
 The main advantage of this projection is that distances from the projection
 center are displayed in correct proportions. Also directions measured from the
diff --git a/examples/projections/azim/azim_general_perspective.py b/examples/projections/azim/azim_general_perspective.py
@@ -1,8 +1,8 @@
 r"""
-General Perspective
-===================
+Perspective projection
+======================
 
-The general perspective projection imitates the view of the Earth from a finite
+The perspective projection imitates the view of the Earth from a finite
 point in space. In a full view of the earth one third of its surface area can
 be seen.
 
diff --git a/examples/projections/azim/azim_general_stereographic.py b/examples/projections/azim/azim_general_stereographic.py
@@ -1,6 +1,6 @@
 r"""
-General Stereographic
-=====================
+General stereographic projection
+================================
 
 This map projection is a conformal, azimuthal projection. It is mainly used
 with a projection center in one of the poles. Then meridians appear as straight
diff --git a/examples/projections/azim/azim_gnomonic.py b/examples/projections/azim/azim_gnomonic.py
@@ -1,6 +1,6 @@
 r"""
-Gnomonic
-========
+Gnomonic projection
+===================
 
 The point of perspective of the gnomonic projection lies at the center of the
 Earth. As a consequence great circles (orthodromes) on the surface of the Earth
diff --git a/examples/projections/azim/azim_lambert.py b/examples/projections/azim/azim_lambert.py
@@ -1,6 +1,6 @@
 r"""
-Lambert Azimuthal Equal Area
-============================
+Lambert azimuthal equal-area projection
+=======================================
 
 This projection was developed by Johann Heinrich Lambert in 1772 and is
 typically used for mapping large regions like continents and hemispheres. It is
diff --git a/examples/projections/azim/azim_orthographic.py b/examples/projections/azim/azim_orthographic.py
@@ -1,6 +1,6 @@
 r"""
-Orthographic
-============
+Orthographic projection
+=======================
 
 This is a perspective projection like the general perspective, but with the
 difference that the point of perspective lies in infinite distance.
diff --git a/examples/projections/conic/conic_albers.py b/examples/projections/conic/conic_albers.py
@@ -1,6 +1,6 @@
 r"""
-Albers Conic Equal Area
-=======================
+Albers conic equal-area projection
+==================================
 
 This projection, developed by Heinrich C. Albers in 1805, is predominantly used
 to map regions of large east-west extent, in particular the United States. It
diff --git a/examples/projections/conic/conic_equidistant.py b/examples/projections/conic/conic_equidistant.py
@@ -1,6 +1,6 @@
 r"""
-Equidistant conic
-=================
+Equidistant conic projection
+============================
 
 The equidistant conic projection was described by the Greek philosopher
 Claudius Ptolemy about A.D. 150. It is neither conformal or equal-area, but
diff --git a/examples/projections/conic/conic_lambert.py b/examples/projections/conic/conic_lambert.py
@@ -1,5 +1,5 @@
 r"""
-Lambert Conic Conformal Projection
+Lambert conic conformal projection
 ==================================
 
 This conic projection was designed by the Alsatian mathematician Johann
diff --git a/examples/projections/conic/polyconic.py b/examples/projections/conic/polyconic.py
@@ -1,5 +1,5 @@
 r"""
-Polyconic Projection
+Polyconic projection
 ====================
 
 The polyconic projection, in Europe usually referred to as the American
diff --git a/examples/projections/cyl/cyl_cassini.py b/examples/projections/cyl/cyl_cassini.py
@@ -1,6 +1,6 @@
 r"""
-Cassini Cylindrical
-============================
+Cassini cylindrical projection
+==============================
 
 This cylindrical projection was developed in 1745 by César-François Cassini de
 Thury for the survey of France. It is occasionally called Cassini-Soldner since
diff --git a/examples/projections/cyl/cyl_equal_area.py b/examples/projections/cyl/cyl_equal_area.py
@@ -1,6 +1,6 @@
 r"""
-Cylindrical equal-area
-======================
+Cylindrical equal-area projection
+=================================
 
 This cylindrical projection is actually several projections, depending on what
 latitude is selected as the standard parallel. However, they are all equal area
diff --git a/examples/projections/cyl/cyl_equidistant.py b/examples/projections/cyl/cyl_equidistant.py
@@ -1,6 +1,6 @@
 r"""
-Cylindrical equidistant
-=======================
+Cylindrical equidistant projection
+==================================
 
 This simple cylindrical projection is really a linear scaling of longitudes and
 latitudes. The most common form is the Plate Carrée projection, where the
diff --git a/examples/projections/cyl/cyl_mercator.py b/examples/projections/cyl/cyl_mercator.py
@@ -1,6 +1,6 @@
 r"""
-Mercator
-========
+Mercator projection
+===================
 
 The Mercator projection takes its name from the Flemish cartographer Gheert
 Cremer, better known as Gerardus Mercator, who presented it in 1569. The
diff --git a/examples/projections/cyl/cyl_miller.py b/examples/projections/cyl/cyl_miller.py
@@ -1,6 +1,6 @@
 r"""
-Miller cylindrical
-==================
+Miller cylindrical projection
+=============================
 
 This cylindrical projection, presented by Osborn Maitland Miller of the
 American Geographic Society in 1942, is neither equal nor conformal. All
diff --git a/examples/projections/cyl/cyl_oblique_mercator_1.py b/examples/projections/cyl/cyl_oblique_mercator_1.py
@@ -1,6 +1,6 @@
 r"""
-Oblique Mercator, 1: origin and azimuth
-=======================================
+Oblique Mercator projection, 1: origin and azimuth
+==================================================
 
 Oblique configurations of the cylinder give rise to the oblique Mercator
 projection. It is particularly useful when mapping regions of large lateral
diff --git a/examples/projections/cyl/cyl_oblique_mercator_2.py b/examples/projections/cyl/cyl_oblique_mercator_2.py
@@ -1,6 +1,6 @@
 r"""
-Oblique Mercator, 2: two points
-===============================
+Oblique Mercator projection, 2: two points
+==========================================
 
 Oblique configurations of the cylinder give rise to the oblique Mercator
 projection. It is particularly useful when mapping regions of large lateral
diff --git a/examples/projections/cyl/cyl_oblique_mercator_3.py b/examples/projections/cyl/cyl_oblique_mercator_3.py
@@ -1,6 +1,6 @@
 r"""
-Oblique Mercator, 3: origin and pole
-====================================
+Oblique Mercator projection, 3: origin and pole
+===============================================
 
 Oblique configurations of the cylinder give rise to the oblique Mercator
 projection. It is particularly useful when mapping regions of large lateral
diff --git a/examples/projections/cyl/cyl_stereographic.py b/examples/projections/cyl/cyl_stereographic.py
@@ -1,6 +1,6 @@
 r"""
-Cylindrical Stereographic
-=========================
+Cylindrical stereographic projection
+====================================
 
 The cylindrical stereographic projections are certainly not as notable as other
 cylindrical projections, but are still used because of their relative
diff --git a/examples/projections/cyl/cyl_transverse_mercator.py b/examples/projections/cyl/cyl_transverse_mercator.py
@@ -1,6 +1,6 @@
 r"""
-Transverse Mercator
-===================
+Transverse Mercator projection
+==============================
 
 The transverse Mercator was invented by Johann Heinrich Lambert in 1772. In
 this projection the cylinder touches a meridian along which there is no
diff --git a/examples/projections/cyl/cyl_universal_transverse_mercator.py b/examples/projections/cyl/cyl_universal_transverse_mercator.py
@@ -1,6 +1,6 @@
 r"""
-Universal Transverse Mercator
-=============================
+Universal Transverse Mercator projection
+========================================
 
 A particular subset of the
 :doc:`transverse Merctor </projections/cyl/cyl_transverse_mercator>`
diff --git a/examples/projections/misc/misc_eckertIV.py b/examples/projections/misc/misc_eckertIV.py
@@ -1,6 +1,6 @@
 r"""
-Eckert IV
-=========
+Eckert IV equal-area projection
+===============================
 
 The Eckert IV projection, presented by the German cartographer Max
 Eckert-Greiffendorff in 1906, is a pseudo-cylindrical equal-area projection.
diff --git a/examples/projections/misc/misc_eckertVI.py b/examples/projections/misc/misc_eckertVI.py
@@ -1,6 +1,6 @@
 r"""
-Eckert VI
-=========
+Eckert VI equal-area projection
+===============================
 
 The Eckert VI projections, presented by the German cartographer Max
 Eckert-Greiffendorff in 1906, is a pseudo-cylindrical equal-area projection.
diff --git a/examples/projections/misc/misc_hammer.py b/examples/projections/misc/misc_hammer.py
@@ -1,6 +1,6 @@
 r"""
-Hammer
-======
+Hammer projection
+=================
 
 The equal-area Hammer projection, first presented by the German mathematician
 Ernst von Hammer in 1892, is also known as Hammer-Aitoff (the Aitoff projection
diff --git a/examples/projections/misc/misc_mollweide.py b/examples/projections/misc/misc_mollweide.py
@@ -1,6 +1,6 @@
 r"""
-Mollweide
-=========
+Mollweide projection
+====================
 
 This pseudo-cylindrical, equal-area projection was developed by the German
 mathematician and astronomer Karl Brandan Mollweide in 1805. Parallels are
diff --git a/examples/projections/misc/misc_robinson.py b/examples/projections/misc/misc_robinson.py
@@ -1,6 +1,6 @@
 r"""
-Robinson
-========
+Robinson projection
+===================
 
 The Robinson projection, presented by the American geographer and cartographer
 Arthur H. Robinson in 1963, is a modified cylindrical projection that is
diff --git a/examples/projections/misc/misc_sinusoidal.py b/examples/projections/misc/misc_sinusoidal.py
@@ -1,6 +1,6 @@
 r"""
-Sinusoidal
-==========
+Sinusoidal projection
+=====================
 
 The sinusoidal projection is one of the oldest known projections, is
 equal-area, and has been used since the mid-16th century. It has also been
diff --git a/examples/projections/misc/misc_van_der_grinten.py b/examples/projections/misc/misc_van_der_grinten.py
@@ -1,6 +1,6 @@
 r"""
-Van der Grinten
-===============
+Van der Grinten projection
+==========================
 
 The Van der Grinten projection, presented by Alphons J. van der Grinten in
 1904, is neither equal-area nor conformal. Central meridian and Equator are
diff --git a/examples/projections/misc/misc_winkel_tripel.py b/examples/projections/misc/misc_winkel_tripel.py
@@ -1,6 +1,6 @@
 r"""
-Winkel Tripel
-=============
+Winkel Tripel projection
+========================
 
 In 1921, the German mathematician Oswald Winkel made a projection that was to
 strike a compromise between the properties of three elements (area, angle and
