GenericMappingTools · seisman · Nov 14, 2021 · Oct 23, 2021 · Nov 1, 2021 · Nov 1, 2021
diff --git a/doc/conf.py b/doc/conf.py
@@ -87,6 +87,9 @@
             "../examples/projections/misc",
             "../examples/projections/nongeo",
             "../examples/projections/table",
+            "../examples/tutorials/beginner",
+            "../examples/tutorials/intermediate",
+            "../examples/tutorials/advanced",
         ]
     ),
     # Patter to search for example files

diff --git a/doc/index.rst b/doc/index.rst
@@ -20,36 +20,17 @@
 
     overview.rst
     install.rst
-    tutorials/first_figure.rst
-
-.. toctree::
-    :maxdepth: 2
-    :hidden:
-    :caption: Examples
-
-    gallery/index.rst
-    external_resources.md
+    tutorials/beginner/first_figure.rst
 
 .. toctree::
     :maxdepth: 2
     :hidden:
     :caption: User Guide
 
-    tutorials/frames.rst
+    gallery/index.rst
     projections/index.rst
-    tutorials/coastlines.rst
-    tutorials/regions.rst
-    tutorials/plot.rst
-    tutorials/lines.rst
-    tutorials/vectors.rst
-    tutorials/date_time_charts.rst
-    tutorials/text.rst
-    tutorials/contour_map.rst
-    tutorials/earth_relief.rst
-    tutorials/3d_perspective_image.rst
-    tutorials/insets.rst
-    tutorials/subplots.rst
-    tutorials/configuration.rst
+    tutorials/index.rst
+    external_resources.md
 
 .. toctree::
     :maxdepth: 2

diff --git a/examples/tutorials/README.txt b/examples/tutorials/README.txt
@@ -1,2 +1,6 @@
+.. _tutorials:
+
 Tutorials
 =========
+
+These tutorials teach how to complete various tasks using PyGMT.
diff --git a/examples/tutorials/advanced/README.txt b/examples/tutorials/advanced/README.txt
@@ -0,0 +1,2 @@
+Advanced Tutorials
+------------------
diff --git a/examples/tutorials/date_time_charts.py → ...es/tutorials/advanced/date_time_charts.py b/examples/tutorials/date_time_charts.py → ...es/tutorials/advanced/date_time_charts.py
@@ -285,7 +285,7 @@
 # Starting off with ``WS``, adding this string means that only
 # Western/Left (**W**) and Southern/Bottom (**S**) borders of
 # the plot will be shown. For more information on this, please
-# refer to :doc:`frame instructions </tutorials/frames>`.
+# refer to :doc:`frame instructions </tutorials/beginner/frames>`.
 #
 # The other important item in the ``frame`` list is
 # ``"sxa1Of1D"``. This string modifies the secondary

diff --git a/examples/tutorials/vectors.py → examples/tutorials/advanced/vectors.py b/examples/tutorials/vectors.py → examples/tutorials/advanced/vectors.py
diff --git a/examples/tutorials/beginner/README.txt b/examples/tutorials/beginner/README.txt
@@ -0,0 +1,2 @@
+Beginner Tutorials
+------------------
diff --git a/examples/tutorials/coastlines.py → examples/tutorials/beginner/coastlines.py b/examples/tutorials/coastlines.py → examples/tutorials/beginner/coastlines.py
diff --git a/examples/tutorials/first_figure.py → examples/tutorials/beginner/first_figure.py b/examples/tutorials/first_figure.py → examples/tutorials/beginner/first_figure.py
diff --git a/examples/tutorials/frames.py → examples/tutorials/beginner/frames.py b/examples/tutorials/frames.py → examples/tutorials/beginner/frames.py
diff --git a/examples/tutorials/lines.py → examples/tutorials/beginner/lines.py b/examples/tutorials/lines.py → examples/tutorials/beginner/lines.py
diff --git a/examples/tutorials/plot.py → examples/tutorials/beginner/plot.py b/examples/tutorials/plot.py → examples/tutorials/beginner/plot.py
diff --git a/examples/tutorials/regions.py → examples/tutorials/beginner/regions.py b/examples/tutorials/regions.py → examples/tutorials/beginner/regions.py
diff --git a/examples/tutorials/text.py → examples/tutorials/beginner/text.py b/examples/tutorials/text.py → examples/tutorials/beginner/text.py
diff --git a/examples/tutorials/3d_perspective_image.py → ...ials/intermediate/3d_perspective_image.py b/examples/tutorials/3d_perspective_image.py → ...ials/intermediate/3d_perspective_image.py
diff --git a/examples/tutorials/intermediate/README.txt b/examples/tutorials/intermediate/README.txt
@@ -0,0 +1,2 @@
+Intermediate Tutorials
+----------------------
diff --git a/examples/tutorials/configuration.py → ...s/tutorials/intermediate/configuration.py b/examples/tutorials/configuration.py → ...s/tutorials/intermediate/configuration.py
diff --git a/examples/tutorials/contour_map.py → ...les/tutorials/intermediate/contour_map.py b/examples/tutorials/contour_map.py → ...les/tutorials/intermediate/contour_map.py
diff --git a/examples/tutorials/earth_relief.py → ...es/tutorials/intermediate/earth_relief.py b/examples/tutorials/earth_relief.py → ...es/tutorials/intermediate/earth_relief.py
diff --git a/examples/tutorials/insets.py → examples/tutorials/intermediate/insets.py b/examples/tutorials/insets.py → examples/tutorials/intermediate/insets.py
diff --git a/examples/tutorials/subplots.py → examples/tutorials/intermediate/subplots.py b/examples/tutorials/subplots.py → examples/tutorials/intermediate/subplots.py
diff --git a/pygmt/helpers/decorators.py b/pygmt/helpers/decorators.py
@@ -18,7 +18,7 @@
     "R": r"""
         region : str or list
             *xmin/xmax/ymin/ymax*\ [**+r**][**+u**\ *unit*].
-            Specify the :doc:`region </tutorials/regions>` of interest.""",
+            Specify the :doc:`region </tutorials/beginner/regions>` of interest.""",
     "J": r"""
         projection : str
             *projcode*\[*projparams*/]\ *width*.
@@ -34,7 +34,7 @@
     "B": r"""
         frame : bool or str or list
             Set map boundary
-            :doc:`frame and axes attributes </tutorials/frames>`. """,
+            :doc:`frame and axes attributes </tutorials/beginner/frames>`. """,
     "U": """\
         timestamp : bool or str
             Draw GMT time stamp logo on plot.""",

diff --git a/pygmt/src/grdview.py b/pygmt/src/grdview.py
@@ -61,10 +61,10 @@ def grdview(self, grid, **kwargs):
         DataArray.
     region : str or list
         *xmin/xmax/ymin/ymax*\ [**+r**][**+u**\ *unit*].
-        Specify the :doc:`region </tutorials/regions>` of interest. When used
-        with ``perspective``, optionally append */zmin/zmax* to indicate the
-        range to use for the 3-D axes [Default is the region in the input
-        grid].
+        Specify the :doc:`region </tutorials/beginner/regions>` of interest.
+        When used with ``perspective``, optionally append */zmin/zmax* to
+        indicate the range to use for the 3-D axes [Default is the region in
+        the input grid].
     {J}
     zscale/zsize : float or str
         Set z-axis scaling or z-axis size.
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,2 @@
		Beginner Tutorials
		------------------
maxrjones marked this conversation as resolved. Show resolved Hide resolved