docs(rtd): fix tutorials section (#2621)

I broke the tutorial RTD page when trying to add the new mfusg transport tutorials in #2617. Fix it. Correctly ignore the two new notebooks needing attention. And remove examples.rst and tutorials.rst, they're generated when the rtd assets are built.

Author: wpbonelli

…fusg_transport_tutorial07c_ChainDecay.py …ks/mfusg_transport_07c_ChainDecay_dev.py.docs/Notebooks/mfusg_transport_tutorial07c_ChainDecay.py renamed to .docs/Notebooks/mfusg_transport_07c_ChainDecay_dev.py .docs/Notebooks/mfusg_transport_tutorial07c_ChainDecay.py renamed to .docs/Notebooks/mfusg_transport_07c_ChainDecay_dev.py

@@ -92,13 +92,15 @@
 print(" ".join(cmd))
 os.system(" ".join(cmd))
 
-# -- convert tutorial scripts and run example notebooks ----------------------
+# -- convert and run tutorial and example notebooks ----------------------
 if not on_rtd:
-    nbs_py = Path("Notebooks").glob("*.py")
-    for py in nbs_py:
+    for py in Path("Notebooks").glob("*.py"):
+        if not ("tutorial" in py.name or "example" in py.name):
+            print(f"skipping {py}")
+            continue
         ipynb = py.with_suffix(".ipynb")
         if ipynb.exists():
-            print(f"{ipynb} already exists, skipping")
+            print(f"Notebook {ipynb} already exists, skipping")
             continue
         cmd = ("jupytext", "--to", "ipynb", "--execute", str(py))
         print(" ".join(cmd))

…books/mfusg_transport_tutorial08_Lake.py …Notebooks/mfusg_transport_08_Lake_dev.py.docs/Notebooks/mfusg_transport_tutorial08_Lake.py renamed to .docs/Notebooks/mfusg_transport_08_Lake_dev.py .docs/Notebooks/mfusg_transport_tutorial08_Lake.py renamed to .docs/Notebooks/mfusg_transport_08_Lake_dev.py

@@ -50,6 +50,7 @@ def create_tutorials_rst():
             "mf2005": {"title": "MODFLOW-2005", "files": []},
             "lgr": {"title": "MODFLOW-LGR", "files": []},
             "nwt": {"title": "MODFLOW-NWT", "files": []},
+            "mfusg": {"title": "MODFLOW USG", "files": []},
             "mt3dms": {"title": "MT3DMS", "files": []},
             "pest": {"title": "PEST", "files": []},
             "misc": {"title": "Miscellaneous", "files": []},

.docs/conf.py

@@ -8,7 +8,7 @@ FloPy
 
 .. image:: _images/flopylogo.png
 
-**Documentation for version 3.6.0.dev0**
+**Documentation for version 3.10.0.dev4**
 
 Documentation is generated with Sphinx from the `FloPy repository <https://github.com/modflowpy/flopy>`_.
 

.docs/create_rstfiles.py

@@ -10,8 +10,8 @@
 
 EXCLUDE = [
     "mf6_lgr",
-    "mfusg_transport_tutorial07c_ChainDecay",
-    "mfusg_transport_tutorial08_Lake",
+    "mfusg_transport_07c_ChainDecay",
+    "mfusg_transport_08_Lake",
 ]
 # skip pyvista notebooks on windows/mac in CI due to persistent issues
 # first with offscreen rendering, then with finding pyvista even after