add support to include markdown files in tutorials

Author: ifenty

doc/Downloading_the_ECCO_v4_state_estimate.rst

@@ -46,7 +46,8 @@
     'sphinx.ext.autosummary',
     'sphinx.ext.extlinks',
     'sphinx.ext.napoleon',
-    'nbsphinx'
+    'nbsphinx',
+    'myst_parser'
 ]
 # Napoleon settings
 napoleon_google_docstring = True
@@ -68,6 +69,9 @@
 numpydoc_class_members_toctree = True
 numpydoc_show_class_members = False
 
+#html_math_renderer = 'imgmath'
+#imgmath_image_format = 'svg'
+#imgmath_font_size = 14
 
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']
@@ -91,16 +95,16 @@
 # built documents.
 #
 # The short X.Y version.
-version = u'4.4-20221215'
+version = u'4.4'
 # The full version, including alpha/beta/rc tags.
-release = u'4.4-20221215'
+release = u'4.4.1'
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.
 #
 # This is also used if you do content translation via gettext catalogs.
 # Usually you set "language" from the command line for these cases.
-language = None
+language ='en' 
 
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.

…oading_ECCO_Datasets_from_PODAAC_wget.md …Downloading_ECCO_Datasets_from_PODAAC.mddoc/Downloading_ECCO_Datasets_from_PODAAC_wget.md renamed to doc/Tutorial_wget_Command_Line_HTTPS_Downloading_ECCO_Datasets_from_PODAAC.md doc/Downloading_ECCO_Datasets_from_PODAAC_wget.md renamed to doc/Tutorial_wget_Command_Line_HTTPS_Downloading_ECCO_Datasets_from_PODAAC.md

@@ -29,7 +29,7 @@ The `ecco_v4_py`_ package used in this tutorial was inspired by the `xmitgcm`_ p
    fields
    Installing_Python_and_Python_Packages
    Downloading_ECCO_Datasets_from_PODAAC_Python.ipynb
-   Downloading_ECCO_Datasets_from_PODAAC_wget.md
+   Tutorial_wget_Command_Line_HTTPS_Downloading_ECCO_Datasets_from_PODAAC
    Tutorial_Introduction
 
 .. toctree::

doc/conf.py

@@ -25,10 +25,14 @@ jinja2==3.1.2
     # via sphinx
 markupsafe==2.1.1
     # via jinja2
+myst-parser==1.0.0
+    # to include markdown file
 nbsphinx==0.9.1
     # from readthedocs log file
 packaging==22.0
     # via sphinx
+pandoc==2.3  
+    # from sphinx website
 pygments==2.13.0
     # via sphinx
 pytz==2022.7