updates for DVpress 0.3 (#225)

* updates for DVpress 0.3

* no math entry

Author: lazarusA

docs/Project.toml

@@ -16,4 +16,4 @@ EasyHybrid = {path = ".."}
 
 [compat]
 Documenter = "1"
-DocumenterVitepress = "0.2"
+DocumenterVitepress = "0.3"

docs/package.json

@@ -5,11 +5,12 @@
     "docs:preview": "vitepress preview build/.documenter"
   },
   "dependencies": {
-    "@nolebase/vitepress-plugin-enhanced-readabilities": "^2.17.1",
+    "@nolebase/vitepress-plugin-enhanced-readabilities": "^2.18.2",
     "markdown-it": "^14.1.0",
     "markdown-it-footnote": "^4.0.0",
-    "markdown-it-mathjax3": "^4.3.2",
-    "vitepress": "^1.6.3",
+    "vitepress": "^1.6.4",
+    "@mdit/plugin-mathjax": "^0.25.0",
+    "@mdit/plugin-tex": "^0.23.1",
     "vitepress-plugin-tabs": "^0.6.0"
   }
-}
+}

docs/src/.vitepress/config.mts

@@ -1,10 +1,11 @@
 import { defineConfig } from 'vitepress'
 import { tabsMarkdownPlugin } from 'vitepress-plugin-tabs'
-import mathjax3 from "markdown-it-mathjax3";
+import { mathjaxPlugin } from './mathjax-plugin'
 import footnote from "markdown-it-footnote";
 import path from 'path'
 
 // console.log(process.env)
+const mathjax = mathjaxPlugin()
 
 function getBaseRepository(base: string): string {
   if (!base || base === '/') return '/';
@@ -41,7 +42,21 @@ export default defineConfig({
     // ['script', {src: '/versions.js'], for custom domains, I guess if deploy_url is available.
     ['script', {src: `${baseTemp.base}siteinfo.js`}]
   ],
+  markdown: {
+    config(md) {
+      md.use(tabsMarkdownPlugin);
+      md.use(footnote);
+      mathjax.markdownConfig(md);
+    },
+    theme: {
+      light: "github-light",
+      dark: "github-dark"
+    },
+  },
   vite: {
+    plugins: [
+      mathjax.vitePlugin,
+    ],
     define: {
       __DEPLOY_ABSPATH__: JSON.stringify('REPLACE_ME_DOCUMENTER_VITEPRESS_DEPLOY_ABSPATH'),
     },
@@ -68,19 +83,6 @@ export default defineConfig({
       ], 
     },
   },
-
-  markdown: {
-    math: true,
-    config(md) {
-      md.use(tabsMarkdownPlugin),
-      md.use(mathjax3),
-      md.use(footnote)
-    },
-    theme: {
-      light: "github-light",
-      dark: "github-dark"
-    },
-  },
   themeConfig: {
     outline: 'deep',
     // https://vitepress.dev/reference/default-theme-config

docs/src/.vitepress/theme/style.css

@@ -15,6 +15,7 @@ https://github.com/vuejs/vitepress/blob/main/src/client/theme-default/styles/var
 }
 
 :root {
+scroll-behavior: smooth;
 /* Typography */
 --vp-font-family-base: "Barlow", "Inter var experimental", "Inter var",
   -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Oxygen, Ubuntu,
@@ -145,25 +146,52 @@ font-feature-settings: "calt" off;
     --vp-home-hero-image-filter: blur(72px);
   }
 }
-/* Component: MathJax */
 
-mjx-container > svg {
+/* plugin-mathjax overwrites */
+.mjx-scroll-wrapper {
   display: block;
-  margin: auto;
+  max-width: 100%;
+  overflow-x: auto;
+  overflow-y: hidden;
+  text-align: center;
 }
 
 mjx-container {
+  display: inline-block;
   padding: 0.5rem 0;
-}
-
-mjx-container {
-  display: inline;
   margin: auto 2px -2px;
+  overflow: visible !important;  /* Override MathJax's overflow */
+  text-align: left;
 }
 
 mjx-container > svg {
-  margin: auto;
   display: inline-block;
+  height: auto;
+}
+
+mjx-container > svg[data-labels="true"] {
+  position: absolute;
+  left: 0;
+  top: 0;
+  width: 100%;
+  height: 100%;
+  pointer-events: none;
+}
+
+/* @mdit/plugin-mathjax theming refs */
+
+mjx-container svg path {
+  fill: currentColor !important;
+  stroke: currentColor !important;
+}
+
+.MathJax_ref {
+  color: var(--vp-c-brand-1);
+}
+
+.MathJax_ref:hover {
+  color: var(--vp-c-brand-2);
+  cursor: pointer;
 }
 
 .highlight-link {