Start conversion to markdown

.gitignore

@@ -45,3 +45,6 @@ airfares.txt
 wages.txt
 ScientificPythonLectures-simple.pdf
 ScientificPythonLectures.pdf
+junk.txt
+sg_execution_times.rst
+test.pkl

advanced/mathematical_optimization/index.rst

@@ -540,23 +540,12 @@ each step an approximation of the Hessian.
 .. |bfgs_gauss_icond_conv| image:: auto_examples/images/sphx_glr_plot_gradient_descent_032.png
    :scale: 75%
 
-Full code examples
-==================
-
-.. include the gallery. Skip the first line to avoid the "orphan"
-   declaration
-
-.. include:: auto_examples/index.rst
-   :start-line: 1
-
-
 .. |bfgs_rosen_icond| image:: auto_examples/images/sphx_glr_plot_gradient_descent_014.png
    :scale: 90%
 
 .. |bfgs_rosen_icond_conv| image:: auto_examples/images/sphx_glr_plot_gradient_descent_033.png
    :scale: 75%
 
-
 .. list-table::
    :widths: 1 1 1
 

conf.py

@@ -9,7 +9,12 @@
 # General configuration
 # ---------------------
 
-exclude_patterns = ["README.rst"]
+exclude_patterns = [
+    "README.rst",
+    ".jupyter_cache",
+    "jupyter_execute",
+    "pyximages/README.md",
+]
 
 # Add any Sphinx extension module names here, as strings. They can be extensions
 # coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
@@ -23,6 +28,7 @@
     "sphinx.ext.extlinks",
     "sphinx_gallery.gen_gallery",
     "sphinx_copybutton",
+    "myst_nb",
 ]
 
 # See https://sphinx-copybutton.readthedocs.io/en/latest/use.html#automatic-exclusion-of-prompts-from-the-copies
@@ -72,7 +78,7 @@
 templates_path = ["_templates"]
 
 # The suffix of source filenames.
-source_suffix = ".rst"
+source_suffix = [".rst", ".md"]
 
 # General information about the project.
 project = "Scientific Python Lectures"
@@ -91,6 +97,17 @@
 # The name of the Pygments (syntax highlighting) style to use.
 pygments_style = "sphinx"
 
+# Enable executable .md files support
+myst_enable_extensions = [
+    "colon_fence",
+    "dollarmath",
+    "substitution",
+    "tasklist",
+    "attrs_inline",
+]
+
+nb_output_stderr = "show"
+
 # Monkey-patch sphinx to set the lineseparator option of pygment, to
 # have indented line wrapping
 
@@ -288,6 +305,8 @@ def add_per_page_js(app, pagename, templatename, context, doctree):
 
 
 def setup(app):
+    # Do not execute .ipynb files generated by the gallery
+    app.registry.source_suffix.pop(".ipynb", None)
     app.add_js_file("https://code.jquery.com/jquery-3.7.0.min.js")
     app.add_js_file("scroll_highlight_toc.js")