Merge branch 'main' into alias-system

Author: seisman

.github/workflows/check-links.yml

@@ -35,7 +35,7 @@ jobs:
 
     - name: Link Checker
       id: lychee
-      uses: lycheeverse/lychee-action@v2.2.0
+      uses: lycheeverse/lychee-action@v2.3.0
       with:
         fail: false  # Don't fail action on broken links
         output: /tmp/lychee-out.md

.github/workflows/ci_docs.yml

@@ -139,6 +139,24 @@ jobs:
       - name: Build the PDF documentation
         run:  make -C doc pdf
 
+      - name: Create the HTML ZIP archive and rename the PDF file
+        run: |
+          cd doc/_build/
+          cp -r html/ pygmt-docs/
+          zip -r pygmt-docs.zip pygmt-docs/
+          mv latex/pygmt.pdf pygmt-docs.pdf
+          cd ../..
+
+      - name: Copy the HTML ZIP archive and PDF to the html folder for dev version
+        run: cp -v doc/_build/pygmt-docs.zip doc/_build/pygmt-docs.pdf doc/_build/html/
+        if: github.event_name == 'push' && matrix.os == 'ubuntu-latest'
+
+      - name: Upload the HTML ZIP archive and PDF as release assets
+        run: gh release upload ${{ github.ref_name }} doc/_build/pygmt-docs.zip doc/_build/pygmt-docs.pdf
+        if: github.event_name == 'release' && matrix.os == 'ubuntu-latest'
+        env:
+          GH_TOKEN: ${{ github.token }}
+
       - name: Checkout the gh-pages branch
         uses: actions/[email protected]
         with:

.github/workflows/format-command.yml

@@ -11,7 +11,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       # Generate token from GenericMappingTools bot
-      - uses: actions/[email protected].1
+      - uses: actions/[email protected].3
         id: generate-token
         with:
           app-id: ${{ secrets.APP_ID }}

.readthedocs.yaml

@@ -36,8 +36,8 @@ sphinx:
    configuration: doc/conf.py
 
 # If using Sphinx, optionally build your docs in additional formats such as PDF
-formats:
-   - pdf
+# formats:
+#   - pdf
 
 # Optionally declare the Python requirements required to build your docs
 conda:

CITATION.cff

@@ -76,9 +76,9 @@ authors:
   family-names: Wessel
   affiliation: University of Hawaiʻi at Mānoa, USA
   orcid: https://orcid.org/0000-0001-5708-7336
-date-released: 2025-02-01
-doi: 10.5281/zenodo.14742338
+date-released: 2025-02-15
+doi: 10.5281/zenodo.14868324
 license: BSD-3-Clause
 repository-code: https://github.com/GenericMappingTools/pygmt
 type: software
-version: 0.14.1
+version: 0.14.2

README.md

@@ -137,7 +137,7 @@ Feel free to cite our work in your research using the following BibTeX:
 
 ```
 @software{
-  pygmt_2025_14742338,
+  pygmt_2025_14868324,
   author       = {Tian, Dongdong and
                   Uieda, Leonardo and
                   Leong, Wei Ji and
@@ -160,9 +160,9 @@ Feel free to cite our work in your research using the following BibTeX:
   month        = feb,
   year         = 2025,
   publisher    = {Zenodo},
-  version      = {0.14.1},
-  doi          = {10.5281/zenodo.14742338},
-  url          = {https://doi.org/10.5281/zenodo.14742338}
+  version      = {0.14.2},
+  doi          = {10.5281/zenodo.14868324},
+  url          = {https://doi.org/10.5281/zenodo.14868324}
 }
 ```
 

doc/_static/version_switch.js

@@ -12,6 +12,7 @@
   var all_versions = {
     'latest': 'latest',
     'dev': 'dev',
+    'v0.14.2': 'v0.14.2',
     'v0.14.1': 'v0.14.1',
     'v0.14.0': 'v0.14.0',
     'v0.13.0': 'v0.13.0',

doc/changes.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## Release v0.14.2 (2025/02/15)
+
+[![Digital Object Identifier for PyGMT v0.14.2](https://zenodo.org/badge/DOI/10.5281/zenodo.14868324.svg)](https://doi.org/10.5281/zenodo.14868324)
+
+
+### Bug Fixes
+
+- **Patch release fixing a critical bug introduced in PyGMT v0.14.1**
+- Fix the bug for passing text strings with numeric values ([#3804](https://github.com/GenericMappingTools/pygmt/pull/3804))
+
+**Full Changelog**: <https://github.com/GenericMappingTools/pygmt/compare/v0.14.1...v0.14.2>
+
+### Contributors
+
+* [Dongdong Tian](https://github.com/seisman)
+
+---
+
 ## Release v0.14.1 (2025/02/01)
 
 [![Digital Object Identifier for PyGMT v0.14.1](https://zenodo.org/badge/DOI/10.5281/zenodo.14742338.svg)](https://doi.org/10.5281/zenodo.14742338)

doc/conf.py

@@ -9,7 +9,6 @@
 from pygmt import __commit__, __version__
 from pygmt.clib import required_gmt_version
 from pygmt.sphinx_gallery import PyGMTScraper
-from sphinx_gallery.sorting import ExampleTitleSortKey, ExplicitOrder
 
 # Dictionary for dependency name and minimum required versions
 requirements = {
@@ -112,34 +111,32 @@
     ],
     # Set paths where to save the generated examples
     "gallery_dirs": ["intro", "tutorials", "gallery", "projections"],
-    "subsection_order": ExplicitOrder(
-        [
-            "../examples/intro",
-            "../examples/tutorials/basics",
-            "../examples/tutorials/advanced",
-            "../examples/gallery/maps",
-            "../examples/gallery/lines",
-            "../examples/gallery/symbols",
-            "../examples/gallery/images",
-            "../examples/gallery/3d_plots",
-            "../examples/gallery/seismology",
-            "../examples/gallery/basemaps",
-            "../examples/gallery/histograms",
-            "../examples/gallery/embellishments",
-            "../examples/projections/azim",
-            "../examples/projections/conic",
-            "../examples/projections/cyl",
-            "../examples/projections/misc",
-            "../examples/projections/nongeo",
-            "../examples/projections/table",
-        ]
-    ),
+    "subsection_order": [
+        "../examples/intro",
+        "../examples/tutorials/basics",
+        "../examples/tutorials/advanced",
+        "../examples/gallery/maps",
+        "../examples/gallery/lines",
+        "../examples/gallery/symbols",
+        "../examples/gallery/images",
+        "../examples/gallery/3d_plots",
+        "../examples/gallery/seismology",
+        "../examples/gallery/basemaps",
+        "../examples/gallery/histograms",
+        "../examples/gallery/embellishments",
+        "../examples/projections/azim",
+        "../examples/projections/conic",
+        "../examples/projections/cyl",
+        "../examples/projections/misc",
+        "../examples/projections/nongeo",
+        "../examples/projections/table",
+    ],
     # Pattern to search for example files
     "filename_pattern": r"\.py",
     # Remove the "Download all examples" button from the top level gallery
     "download_all_examples": False,
     # Sort gallery examples by the file names instead of number of lines [Default]
-    "within_subsection_order": ExampleTitleSortKey,
+    "within_subsection_order": "ExampleTitleSortKey",
     # Directory where function granular galleries are stored
     "backreferences_dir": "api/generated/backreferences",
     # Modules for which function level galleries are created (given as tuple of strings)

doc/minversions.md

@@ -41,6 +41,7 @@ compatibility reasons.
 | PyGMT Version | GMT | Python | NumPy | pandas | Xarray |
 |---|---|---|---|---|---|
 | [Dev][]* [<doc:dev>] | {{ requires.gmt }} | {{ requires.python }} | {{ requires.numpy }} | {{ requires.pandas }} | {{ requires.xarray }} |
+| <tag:v0.14.2> [<doc:v0.14.2>] | >=6.4.0 | >=3.11 | >=1.25 | >=2.0 | >=2023.04 |
 | <tag:v0.14.1> [<doc:v0.14.1>] | >=6.4.0 | >=3.11 | >=1.25 | >=2.0 | >=2023.04 |
 | <tag:v0.14.0> [<doc:v0.14.0>] | >=6.4.0 | >=3.11 | >=1.25 | >=2.0 | >=2023.04 |
 | <tag:v0.13.0> [<doc:v0.13.0>] | >=6.3.0 | >=3.10 | >=1.24 | >=1.5 | >=2022.09 |