documentation: change to myst-parser (#102)

No longer use abandoned `recommonmark`

Author: plakrisenko

doc/conf.py

@@ -50,7 +50,7 @@
     'sphinx.ext.autosummary',
     'sphinx.ext.intersphinx',
     'sphinx.ext.viewcode',
-    'recommonmark',
+    'myst_parser',
     'sphinx_markdown_tables',
     'nbsphinx',
 ]
@@ -99,10 +99,6 @@
 # ignore numpy warnings
 warnings.filterwarnings("ignore", message="numpy.dtype size changed")
 warnings.filterwarnings("ignore", message="numpy.ufunc size changed")
-# ignore recommonmark warnings
-#  https://github.com/readthedocs/recommonmark/issues/177
-warnings.filterwarnings("ignore",
-                        message="Container node skipped: type=document")
 
 # -- Options for HTML output -------------------------------------------------
 

setup.py

@@ -78,7 +78,7 @@ def absolute_links(txt):
               'sphinxcontrib-napoleon>=0.7',
               'sphinx-markdown-tables>=0.0.15',
               'sphinx-rtd-theme>=0.5.1',
-              'recommonmark>=0.7.1',
+              'myst-parser>=0.16.1',
               'nbsphinx>=0.8.2',
               'm2r>=0.2.1',
               'ipython>=7.21.0',