Migrate all ReST files to MyST Markdown format

about/index.rst → about/index.md

@@ -1,7 +1,8 @@
-.. title:: About
+---
+title: About
+---
 
-About
-=====
+# About
 
 GMT is an open-source collection of command-line tools for manipulating geographic and
 Cartesian data sets (including filtering, trend fitting, gridding, projecting, etc.) and
@@ -11,46 +12,43 @@ projections and transformations and includes supporting data such as coastlines,
 and political boundaries and optionally country polygons.
 
 
-The Steering Committee
-----------------------
+## The Steering Committee
 
 As of August 2024, the GMT development and maintenance is being guided by a GMT Steering
 Committee, with members David Caress, Dongdong Tian, Federico Esteban, Joaquim Luis,
 Remko Scharroo, Walter Smith, and Xiaohua (Eric) Xu.
 
-Support
--------
+## Support
 
 GMT could not have been designed without the generous support of several people:
 
-* The founders (Wessel and Smith) gratefully acknowledge A. B. Watts and the late W. F.
+- The founders (Wessel and Smith) gratefully acknowledge A. B. Watts and the late W. F.
   Haxby for supporting their efforts on the original version 1.0 while they were Watts'
   and Haxby's graduate students at Lamont-Doherty Earth Observatory.
-* Doug Shearer and Roger Davis patiently answered many questions over e-mail.
-* The subroutine ``gauss`` was written and supplied by Bill Menke.
+- Doug Shearer and Roger Davis patiently answered many questions over e-mail.
+- The subroutine `gauss` was written and supplied by Bill Menke.
 
 Further development was made possible by grants and fellowships:
 
-* National Science Foundation grants
-  `EAR-1948602 <https://www.nsf.gov/awardsearch/showAward?AWD_ID=1948602>`__,
-  `OCE-1841660 <https://www.nsf.gov/awardsearch/showAward?AWD_ID=1841660>`__,
-  `EAR-1829371 <https://www.nsf.gov/awardsearch/showAward?AWD_ID=1829371>`__,
-  `OCE-1558403 <https://www.nsf.gov/awardsearch/showAward?AWD_ID=1558403>`__,
-  `EAR-1347184 <https://www.nsf.gov/awardsearch/showAward?AWD_ID=1347184>`__,
-  `OCE-1029874 <https://www.nsf.gov/awardsearch/showAward?AWD_ID=1029874>`__,
-  `OCE-0452126 <https://www.nsf.gov/awardsearch/showAward?AWD_ID=0452126>`__,
-  `OCE-0082552 <https://www.nsf.gov/awardsearch/showAward?AWD_ID=0082552>`__,
-  `OCE-9529431 <https://www.nsf.gov/awardsearch/showAward?AWD_ID=9529431>`__,
+- National Science Foundation grants
+  [EAR-1948602](https://www.nsf.gov/awardsearch/showAward?AWD_ID=1948602),
+  [OCE-1841660](https://www.nsf.gov/awardsearch/showAward?AWD_ID=1841660),
+  [EAR-1829371](https://www.nsf.gov/awardsearch/showAward?AWD_ID=1829371),
+  [OCE-1558403](https://www.nsf.gov/awardsearch/showAward?AWD_ID=1558403),
+  [EAR-1347184](https://www.nsf.gov/awardsearch/showAward?AWD_ID=1347184),
+  [OCE-1029874](https://www.nsf.gov/awardsearch/showAward?AWD_ID=1029874),
+  [OCE-0452126](https://www.nsf.gov/awardsearch/showAward?AWD_ID=0452126),
+  [OCE-0082552](https://www.nsf.gov/awardsearch/showAward?AWD_ID=0082552),
+  [OCE-9529431](https://www.nsf.gov/awardsearch/showAward?AWD_ID=9529431),
   and
-  `EAR-9302272 <https://www.nsf.gov/awardsearch/showAward?AWD_ID=9302272>`__.
-* Versions 2.0–2.1 would not have been possible without the support from the HIGP/SOEST
+  [EAR-9302272](https://www.nsf.gov/awardsearch/showAward?AWD_ID=9302272).
+- Versions 2.0–2.1 would not have been possible without the support from the HIGP/SOEST
   Post-Doctoral Fellowship program to Paul Wessel.
-* Walter H. F. Smith gratefully acknowledges the generous support of the C. H. and I. M.
+- Walter H. F. Smith gratefully acknowledges the generous support of the C. H. and I. M.
   Green Foundation for Earth Sciences at the Institute of Geophysics and Planetary
   Physics, Scripps Institution of Oceanography, University of California at San Diego.
 
-History
--------
+## History
 
 The GMT system was initiated in late 1987 at Lamont-Doherty Earth Observatory, Columbia
 University by graduate students Paul Wessel and Walter H. F. Smith.  Version 1 was
@@ -67,17 +65,17 @@ worldwide in a broad range of disciplines.
 
 More detail on the history of GMT:
 
-* Listen to this interview of Paul Wessel and Leonardo Uieda on the *Don't Panic
+- Listen to this interview of Paul Wessel and Leonardo Uieda on the *Don't Panic
   Geocast* episode
-  `"You are headed to a warm and sunny place" <http://www.dontpanicgeocast.com/?p=638>`__.
-* Walter Smith was also interviewed by *Don't Panic* on episode
-  `"Take the toaster apart" <https://www.dontpanicgeocast.com/?p=742>`__ where he talks
+  ["You are headed to a warm and sunny place"](http://www.dontpanicgeocast.com/?p=638).
+- Walter Smith was also interviewed by *Don't Panic* on episode
+  ["Take the toaster apart"](https://www.dontpanicgeocast.com/?p=742) where he talks
   about the early history of GMT and other topics.
-* Read Paul Wessel's article `"The Origins of the Generic Mapping Tools: From Table Tennis to Geoscience" <https://doi.org/10.1029/2023CN000231>`__ from 2024.
-* Watch this recorded talk by Paul Wessel on the 20th anniversary of the first release (`original version <https://doi.org/10.5446/19869>`__):
-
-.. raw:: html
-
-   <div class="embed-responsive embed-responsive-16by9">
-      <iframe width="560" height="315" scrolling="no" src="//av.tib.eu/player/19869" frameborder="0" allowfullscreen></iframe>
-   </div>
+- Read Paul Wessel's article ["The Origins of the Generic Mapping Tools: From Table Tennis to Geoscience"](https://doi.org/10.1029/2023CN000231) from 2024.
+- Watch this recorded talk by Paul Wessel on the 20th anniversary of the first release ([original version](https://doi.org/10.5446/19869)):
+
+```{raw} html
+<div class="embed-responsive embed-responsive-16by9">
+   <iframe width="560" height="315" scrolling="no" src="//av.tib.eu/player/19869" frameborder="0" allowfullscreen></iframe>
+</div>
+```

cite/index.md

@@ -0,0 +1,107 @@
+---
+title: Citing
+---
+
+# Citing GMT
+
+If you feel it is appropriate, you may consider paying us back by citing our articles on
+GMT and technical papers on algorithms when you publish papers containing results or
+illustrations obtained using GMT. **When in doubt, please cite the latest paper.**
+Furthermore, you are welcome to cite the specific version you have used in your work.
+
+The GMT releases are:
+
+| | |
+|---|---|
+| **latest / all** | [![](https://zenodo.org/badge/DOI/10.5281/zenodo.3407865.svg)](https://doi.org/10.5281/zenodo.3407865) |
+| **6.7.0** | [![](https://zenodo.org/badge/DOI/10.5281/zenodo.19398868.svg)](https://doi.org/10.5281/zenodo.19398868) |
+| **6.6.0** | [![](https://zenodo.org/badge/DOI/10.5281/zenodo.16448627.svg)](https://doi.org/10.5281/zenodo.16448627) |
+| **6.5.0** | [![](https://zenodo.org/badge/DOI/10.5281/zenodo.10119499.svg)](https://doi.org/10.5281/zenodo.10119499) |
+| **6.4.0** | [![](https://zenodo.org/badge/DOI/10.5281/zenodo.6623271.svg)](https://doi.org/10.5281/zenodo.6623271) |
+| **6.3.0** | [![](https://zenodo.org/badge/DOI/10.5281/zenodo.5708769.svg)](https://doi.org/10.5281/zenodo.5708769) |
+| **6.2.0** | [![](https://zenodo.org/badge/DOI/10.5281/zenodo.4900001.svg)](https://doi.org/10.5281/zenodo.4900001) |
+| **6.1.1** | [![](https://zenodo.org/badge/DOI/10.5281/zenodo.4010996.svg)](https://doi.org/10.5281/zenodo.4010996) |
+| **6.1.0** | [![](https://zenodo.org/badge/DOI/10.5281/zenodo.3924517.svg)](https://doi.org/10.5281/zenodo.3924517) |
+| **6.0.0** | [![](https://zenodo.org/badge/DOI/10.5281/zenodo.3407866.svg)](https://doi.org/10.5281/zenodo.3407866) |
+
+The articles on GMT are:
+
+- **PyGMT**:
+  Tian, D., Fröhlich, Y., Leong, W. J., Grund, M., Schlitzer, W., Jones, M., Uieda, L., Luis, J. M. F. (2026).
+  PyGMT: Bridging Python and the Generic Mapping Tools for Geospatial Visualization and Analysis.
+  *Geochemistry, Geophysics, Geosystems*, 27(7), e2026GC013105.
+  https://doi.org/10.1029/2026GC013105
+- **GMT 6**:
+  Wessel, P., Luis, J. F., Uieda, L., Scharroo, R., Wobbe, F., Smith, W. H. F., & Tian, D. (2019).
+  The Generic Mapping Tools Version 6.
+  *Geochemistry, Geophysics, Geosystems*, 20(11), 5556–5564.
+  https://doi.org/10.1029/2019GC008515
+- **GMT Animation**:
+  Wessel, P., Esteban, F., & Delaviel-Anger, G. (2024).
+  The Generic Mapping Tools and Animations for the Masses.
+  *Geochemistry, Geophysics, Geosystems*, 25(6).
+  https://doi.org/10.1029/2024GC011545
+- **Origin of GMT**:
+  Wessel, P. (2024).
+  The origins of the generic mapping tools: From table tennis to geoscience.
+  *Perspectives of Earth and Space Scientists*, 5(1), e2023CN000231.
+  https://doi.org/10.1029/2023CN000231
+- **GMT/MATLAB**:
+  Wessel, P., & Luis, J. F. (2017).
+  The GMT/MATLAB Toolbox.
+  *Geochemistry, Geophysics, Geosystems*, 18(2), 811–823.
+  https://doi.org/10.1002/2016GC006723
+- **GMT 5**:
+  Wessel, P., Smith, W. H. F., Scharroo, R., Luis, J., & Wobbe, F. (2013).
+  Generic Mapping Tools: Improved Version Released.
+  *EOS, Transactions American Geophysical Union*, 94(45), 409–410.
+  https://doi.org/10.1002/2013EO450001
+- **GMT 3.1**:
+  Wessel, P., & Smith, W. H. F. (1998).
+  New, improved version of generic mapping tools released.
+  *EOS, Transactions American Geophysical Union*, 79(47), 579–579.
+  https://doi.org/10.1029/98EO00426
+- **GMT 3.0**:
+  Wessel, P., & Smith, W. H. F. (1995).
+  New version of the generic mapping tools.
+  *EOS, Transactions American Geophysical Union*, 76(33), 329–329.
+  https://doi.org/10.1029/95EO00198
+- **GMT 2**:
+  Wessel, P., & Smith, W. H. F. (1991).
+  Free software helps map and display data.
+  *EOS, Transactions American Geophysical Union*, 72(41), 441–446.
+  https://doi.org/10.1029/90EO00319
+
+Some GMT modules are based on algorithms we have developed and published separately,
+such as:
+
+- Kim, S.-S., & Wessel, P. (2008).
+  Directional median filtering for regional‐residual separation of bathymetry.
+  *Geochemistry, Geophysics, Geosystems*, 9(3), 2007GC001850.
+  https://doi.org/10.1029/2007GC001850
+  [`dimfilter`]
+- Luis, J. F., & Miranda, J. M. (2008).
+  Reevaluation of magnetic chrons in the North Atlantic between 35°N and 47°N: Implications for the formation of the Azores Triple Junction and associated plateau.
+  *Journal of Geophysical Research: Solid Earth*, 113(B10), 2007JB005573.
+  https://doi.org/10.1029/2007JB005573
+  [`grdredpol`, **potential** supplement]
+- Smith, W. H. F., & Wessel, P. (1990).
+  Gridding with continuous curvature splines in tension.
+  *Geophysics*, 55(3), 293–305.
+  https://doi.org/10.1190/1.1442837
+  [`surface`]
+- Wessel, P. (2010).
+  Tools for analyzing intersecting tracks: The x2sys package.
+  *Computers & Geosciences*, 36(3), 348–354.
+  https://doi.org/10.1016/j.cageo.2009.05.009
+  [**x2sys** supplement]
+- Wessel, P. (2009).
+  A general-purpose Green's function-based interpolator.
+  *Computers & Geosciences*, 35(6), 1247–1254.
+  https://doi.org/10.1016/j.cageo.2008.08.012
+  [`greenspline`]
+- Wessel, P., & Becker, J. M. (2008).
+  Interpolation using a generalized Green's function for a spherical surface spline in tension.
+  *Geophysical Journal International*, 174(1), 21–28.
+  https://doi.org/10.1111/j.1365-246X.2008.03829.x
+  [`greenspline`]

conf.py

@@ -4,7 +4,10 @@
 # Sphinx project configuration
 templates_path = ["_templates"]
 exclude_patterns = ["_build"]
-source_suffix = ".rst"
+source_suffix = {
+    ".rst": "restructuredtext",
+    ".md": "markdown",
+}
 master_doc = "index"
 
 # General information about the project
@@ -15,9 +18,12 @@
 
 # Sphinx extensions
 extensions = [
-    "sphinx.ext.githubpages"
+    "sphinx.ext.githubpages",
+    "myst_parser",
 ]
 
+myst_enable_extensions = ["colon_fence"]
+
 html_title = project
 html_short_title = ""
 html_logo = "_static/gmt-logo.png"

documentation/index.md

@@ -0,0 +1,20 @@
+---
+title: Documentation
+---
+
+# Documentation
+
+Documentation for GMT is available online in different versions (if in doubt, use the
+**latest stable** version):
+
+- [Latest stable release](https://docs.generic-mapping-tools.org/latest)
+- [Current development version (unstable nightly builds)](https://docs.generic-mapping-tools.org/dev/)
+- [GMT 6.6.0](https://docs.generic-mapping-tools.org/6.6/)
+- [GMT 6.5.0](https://docs.generic-mapping-tools.org/6.5/)
+- [GMT 6.4.0](https://docs.generic-mapping-tools.org/6.4/)
+- [GMT 6.3.0](https://docs.generic-mapping-tools.org/6.3/)
+- [GMT 6.2.0](https://docs.generic-mapping-tools.org/6.2/)
+- [GMT 6.1.1](https://docs.generic-mapping-tools.org/6.1/)
+- [GMT 6.0.0](https://docs.generic-mapping-tools.org/6.0/)
+- [GMT 5.4.5](https://docs.generic-mapping-tools.org/5.4/)
+- [GMT 4.5.18](https://docs.generic-mapping-tools.org/4/)