[ENH] add several mkdocs features

Author: Remi-Gau

mkdocs.yml

@@ -4,7 +4,8 @@ repo_url: https://github.com/bids-standard/bids-website/tree/main
 site_url: https://bids.neuroimaging.io/
 
 plugins:
-  - search
+  - search:
+      separator: '[\s\u200b\-_,:!=\[\]()"`/]+|\.(?!\d)|&[lg]t;|(?!\b)(?=[A-Z][a-z])'
   - tags
   # -   social
   - blog
@@ -192,20 +193,25 @@ theme:
   features:
     - announce.dismiss
     - content.action.edit
+    - content.code.annotate
     - content.code.copy
     - content.tabs.link
     - content.tooltips
-    - footnotes
     - header.autohide
+    - navigation.expand
     - navigation.footer
     - navigation.indexes
     - navigation.instant
+    - navigation.instant.progress
+    - navigation.prune
     - navigation.sections
     - navigation.tabs
     - navigation.tabs.sticky
     - navigation.top
-    - search.suggest
+    - navigation.tracking
     - search.highlight
+    - search.share
+    - search.suggest
     - toc.follow
   icon:
     repo: fontawesome/brands/github
@@ -217,15 +223,15 @@ theme:
         icon: material/brightness-auto
         name: Switch to light mode
     - media: "(prefers-color-scheme: light)"
-      primary: teal
-      accent: green
+      primary: custom
+      accent: custom
       scheme: default
       toggle:
         icon: material/brightness-7
         name: Switch to dark mode
     - media: "(prefers-color-scheme: dark)"
-      primary: teal
-      accent: green
+      primary: custom
+      accent: custom
       scheme: slate
       toggle:
         icon: material/brightness-4
@@ -237,29 +243,60 @@ markdown_extensions:
   - abbr
   - admonition
   - attr_list
+  - def_list
+  - footnotes
   - md_in_html
+  - pymdownx.arithmatex:
+      generic: true
+  - pymdownx.betterem:
+      smart_enable: all
+  - pymdownx.caret
   - pymdownx.details
   - pymdownx.emoji:
       emoji_generator: !!python/name:material.extensions.emoji.to_svg
       emoji_index: !!python/name:material.extensions.emoji.twemoji
   - pymdownx.snippets:
       auto_append:
         - includes/abbreviations.md
+  - pymdownx.highlight:
+      anchor_linenums: true
+      line_spans: __span
+      pygments_lang_class: true
+  - pymdownx.inlinehilite
+  - pymdownx.keys
+  - pymdownx.magiclink:
+      normalize_issue_symbols: true
+      repo_url_shorthand: true
+      user: bids-standard
+      repo: bids-website
+  - pymdownx.mark
+  - pymdownx.smartsymbols
   - pymdownx.superfences:
       custom_fences:
         - name: mermaid
           class: mermaid
           format: !!python/name:pymdownx.superfences.fence_code_format
   - pymdownx.tabbed:
       alternate_style: true
+      combine_header_slug: true
+      slugify: !!python/object/apply:pymdownx.slugs.slugify
+        kwds:
+          case: lower
+  - pymdownx.tasklist:
+      custom_checkbox: true
+  - pymdownx.tilde
   - tables
   - toc:
+      permalink: true
       anchorlink: true
       toc_depth: 3
 
 extra_javascript:
   - https://unpkg.com/[email protected]/dist/tablesort.min.js
   - javascripts/tablesort.js
+  - javascripts/mathjax.js
+  - https://polyfill.io/v3/polyfill.min.js?features=es6
+  - https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js
 
 extra_css:
   - stylesheets/extra.css