Merge pull request #494 from JuliaDataCubes/la/docs

up versions

Author: lazarusA

docs/package.json

@@ -5,12 +5,13 @@
     "docs:preview": "vitepress preview build/.documenter"
   },
   "devDependencies": {
+    "@nolebase/vitepress-plugin-enhanced-readabilities": "^2.14.0",
     "@types/d3-format": "^3.0.4",
-    "@types/node": "^22.10.1",
+    "@types/node": "^22.13.4",
     "markdown-it-mathjax3": "^4.3.2",
-    "rollup-plugin-delete": "^2.0.0",
-    "vitepress": "^1.5.0",
-    "vitepress-plugin-tabs": "^0.5.0"
+    "rollup-plugin-delete": "^3.0.0",
+    "vitepress": "^1.6.3",
+    "vitepress-plugin-tabs": "^0.6.0"
   },
   "dependencies": {
     "d3-format": "^3.1.0",

docs/src/.vitepress/config.mts

@@ -90,7 +90,25 @@ export default defineConfig({
     ['script', {src: `${baseTemp.base}siteinfo.js`}]
   ],
   // ignoreDeadLinks: true,
-
+  vite: {
+    build: {
+      assetsInlineLimit: 0, // so we can tell whether we have created inlined images or not, we don't let vite inline them
+    },
+    optimizeDeps: {
+      exclude: [ 
+        '@nolebase/vitepress-plugin-enhanced-readabilities/client',
+        'vitepress',
+        '@nolebase/ui',
+      ], 
+    }, 
+    ssr: { 
+      noExternal: [ 
+        // If there are other packages that need to be processed by Vite, you can add them here.
+        '@nolebase/vitepress-plugin-enhanced-readabilities',
+        '@nolebase/ui',
+      ], 
+    },
+  },
   markdown: {
     math: true,
     config(md) {

docs/src/.vitepress/theme/index.ts

@@ -1,24 +1,41 @@
 // .vitepress/theme/index.ts
 import { h } from 'vue'
-import type { Theme } from 'vitepress'
 import DefaultTheme from 'vitepress/theme'
+import type { Theme as ThemeConfig } from 'vitepress'
+
+import { 
+  NolebaseEnhancedReadabilitiesMenu, 
+  NolebaseEnhancedReadabilitiesScreenMenu, 
+} from '@nolebase/vitepress-plugin-enhanced-readabilities/client'
+
 import AsideTrustees from '../../components/AsideTrustees.vue'
 import VersionPicker from "../../components/VersionPicker.vue"
 import StarUs from '../../components/StarUs.vue'
-
+import AuthorBadge from '../../components/AuthorBadge.vue'
+import Authors from '../../components/Authors.vue'
 import { enhanceAppWithTabs } from 'vitepress-plugin-tabs/client'
+
+import '@nolebase/vitepress-plugin-enhanced-readabilities/client/style.css'
 import './style.css'
 
-export default {
+export const Theme: ThemeConfig = {
   extends: DefaultTheme,
   Layout() {
     return h(DefaultTheme.Layout, null, {
       'aside-ads-before': () => h(AsideTrustees),
-      'nav-bar-content-after': () => h(StarUs),
+      'nav-bar-content-after': () => [
+        h(StarUs),
+        h(NolebaseEnhancedReadabilitiesMenu), // Enhanced Readabilities menu
+      ],
+      // A enhanced readabilities menu for narrower screens (usually smaller than iPad Mini)
+      'nav-screen-content-after': () => h(NolebaseEnhancedReadabilitiesScreenMenu),
     })
   },
   enhanceApp({ app, router, siteData }) {
     enhanceAppWithTabs(app);
     app.component('VersionPicker', VersionPicker);
+    app.component('AuthorBadge', AuthorBadge)
+    app.component('Authors', Authors)
   }
-} satisfies Theme
+}
+export default Theme

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

@@ -37,19 +37,19 @@ This is pretty bad for Julia folks reading even though copy+paste retains the sa
 */
 /* Target elements with class 'mono' */
 .mono-no-substitutions {
-  font-family: "JuliaMono-Light", monospace;
+  font-family: "JuliaMono-Regular", monospace;
   font-feature-settings: "calt" off;
 }
 
 /* Alternatively, you can use the following if you prefer: */
 .mono-no-substitutions-alt {
-  font-family: "JuliaMono-Light", monospace;
+  font-family: "JuliaMono-Regular", monospace;
   font-variant-ligatures: none;
 }
 
 /* If you want to apply this globally to all monospace text: */
 pre, code {
-  font-family: "JuliaMono-Light", monospace;
+  font-family: "JuliaMono-Regular", monospace;
   font-feature-settings: "calt" off;
 }
 
@@ -200,36 +200,15 @@ mjx-container > svg {
   --vitest-c-sponsor-hover: #e51370;
 }
 
-.VPDoc.has-aside .content-container {
-  max-width: 100% !important;
-}
-.aside {
-  max-width: 200px !important;
-  padding-left: 0 !important;
-}
-.VPDoc {
-  padding-top: 15px !important;
-  padding-left: 5px !important;
-
-}
-/* This one does the right menu */
-
-.VPDocOutlineItem li {
-  text-overflow: ellipsis;
-  overflow: hidden;
-  white-space: nowrap;
-  max-width: 200px;
-}
-
-.VPNavBar .title {
-  text-overflow: ellipsis;
-  overflow: hidden;
-  white-space: nowrap;
+@media (min-width: 640px) {
+  :root {
+    --vp-home-hero-image-filter: blur(56px);
+  }
 }
 
-@media (max-width: 960px) {
-  .VPDoc {
-    padding-left: 25px !important;  
+@media (min-width: 960px) {
+  :root {
+    --vp-home-hero-image-filter: blur(72px);
   }
 }
 
@@ -278,4 +257,8 @@ mjx-container > svg {
   cursor: pointer;
   user-select: none;
   margin: 0 0 8px;
+}
+
+.jldocstring.custom-block summary a {
+  pointer-events: none;
 }