Add Nolebase enhanced readabilities plugin#338
Conversation
There was a problem hiding this comment.
Code Review
This pull request integrates the @nolebase/vitepress-plugin-enhanced-readabilities plugin into the VitePress project, configuring Vite's SSR settings to process the plugin and registering its menu components in the theme. The feedback recommends explicitly adding less to devDependencies in package.json to avoid potential build failures, as the plugin uses Less for styling and is compiled on the fly.
Important
The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.
| "epub": "bun run course/.vitepress/epub/build.ts" | ||
| }, | ||
| "devDependencies": { | ||
| "@nolebase/vitepress-plugin-enhanced-readabilities": "^2.18.2", |
There was a problem hiding this comment.
Since @nolebase/vitepress-plugin-enhanced-readabilities and @nolebase/ui use Less for styling and are configured under ssr.noExternal (meaning Vite compiles their Vue components and styles on the fly), Vite requires the less preprocessor to be available in the host project. Relying on transitive dependencies for Vite preprocessors can lead to build failures in environments with strict package managers (like pnpm) or certain CI/CD pipelines. It is highly recommended to explicitly add less to your devDependencies.
| "@nolebase/vitepress-plugin-enhanced-readabilities": "^2.18.2", | |
| "@nolebase/vitepress-plugin-enhanced-readabilities": "^2.18.2", | |
| "less": "^4.6.7", |
Integrates @nolebase/vitepress-plugin-enhanced-readabilities to enhance documentation readability.
Changes
@nolebase/vitepress-plugin-enhanced-readabilitiesdependencylang: zh-CNconfigurationWhy
Improves documentation readability and user experience by providing layout switching and related readability features that benefit all site visitors.