docs: add custom hooks for rendering jupyter notebooks (#2067)

docs/mkdocs.yml

@@ -77,15 +77,6 @@ plugins:
             options:
               filters:
                 - "!^_"
-  - mkdocs-jupyter:
-      ignore_h1_titles: true
-      execute: false
-      include_source: True
-      include_requirejs: true
-  - exclude:
-      glob:
-        - tutorials/llm-compiler/math_tools.py
-        - tutorials/llm-compiler/output_parser.py
 nav:
   - "index.md"
   - Tutorials:
@@ -326,9 +317,8 @@ markdown_extensions:
   - markdown_include.include:
       base_path: ./
   - github-callouts
-extra_css:
-  - css/mkdocstrings.css
-
+hooks:
+  - _scripts/notebook_hooks.py
 extra:
   social:
     - icon: fontawesome/brands/js
@@ -357,4 +347,8 @@ validation:
   omitted_files: warn
   absolute_links: warn
   unrecognized_links: warn
-  anchors: warn
+  # TODO: figure out how to enable 'warn' for this
+  # it's only an issue for tutorials/storm/storm.ipynb
+  # because it creates anchors in the generated report
+  # and those anchors are not available in the actual doc
+  anchors: info