Reducing size and installation time

[Mister-Hope]

From beta238 to beta241, we mark a lot of deps as "optional peers", this means plugins and theme install size can be greatly reduced.

For earlier version like beta238, a demo deps size can be 372MB with 783 packages:

While this is not happening now, beta241 only have 113MB with 600 packages:

We are shrinking 70% size!🎉

This also means you should install packages you need manually when using some complicated features.

减小尺寸与安装时间

从 beta238 到 beta241，我们将很多 deps 标记为“可选依赖”，这意味着插件和主题安装大小可以大大减少。

对于像 beta238 这样的早期版本，演示站大小可达 372MB，有 783 个软件包：

现在，beta241 只有 113MB 和 600 个软件包：

我们正在缩小70%的尺寸！ 🎉

当然，这也意味着在使用一些复杂的功能时，您应该手动安装所需的软件包。

[JeremieLitzler]

Hi @Mister-Hope

regarding that topic, why do I need to install mathjaxfull when I'm using the following MdEnhance options in theme.ts:

    mdEnhance: {
      checkLinks: 'always',
      //See https://vuepress-theme-hope.github.io/v2/guide/markdown/align.html
      align: true,
      //See https://vuepress-theme-hope.github.io/v2/guide/markdown/attrs.html
      attrs: true,
      //See https://vuepress-theme-hope.github.io/v2/guide/markdown/chart.html
      //chart: true,
      //See https://vuepress-theme-hope.github.io/v2/guide/markdown/container.html
      container: true,
      //See https://vuepress-theme-hope.github.io/v2/guide/markdown/echarts.html
      echarts: true,
      //See https://vuepress-theme-hope.github.io/v2/guide/markdown/footnote.html
      //See also https://echarts.apache.org/en/index.html
      footnote: true,
      //use the figure, figureCaption to wrap an image
      figure: true,
      //load image lazily with native method
      imgLazyload: true,
      //Syntax: ==this text is marked==
      //See https://vuepress-theme-hope.github.io/v2/guide/markdown/mark.html
      mark: true,
      //Supports RevealJS
      //See https://vuepress-theme-hope.github.io/v2/guide/markdown/presentation.html
      //presentation: true,
      //See https://vuepress-theme-hope.github.io/v2/guide/markdown/stylize.html
      //I'm not sure I need it for now
      //stylize: []
      //See https://vuepress-theme-hope.github.io/v2/guide/markdown/tabs.html
      tabs: true,

I understand that I need to add echarts for example.

Source repo: https://github.com/Puzzlout/TemplateVuepress

Also, why does waline is complaining when I do not use it while upgrading to beta.241 and up?

[vite]: Rollup failed to resolve import "@waline/client/pageview" from "D:/Git/GitHub/mon-site-demo-tutoriel.madebyjeremie.fr/node_modules/vuepress-plugin-comment2/lib/client/pageview.js".
This is most likely unintended because it can break your application at runtime.
If you do want to externalize this module explicitly add it to
`build.rollupOptions.external`
× Compiling with vite - failed in 3.37s
Error: [vite]: Rollup failed to resolve import "@waline/client/pageview" from "D:/Git/GitHub/mon-site-demo-tutoriel.madebyjeremie.fr/node_modules/vuepress-plugin-comment2/lib/client/pageview.js".
This is most likely unintended because it can break your application at runtime.
If you do want to externalize this module explicitly add it to
`build.rollupOptions.external`
    at viteWarn (file:///D:/Git/GitHub/mon-site-demo-tutoriel.madebyjeremie.fr/node_modules/vite/dist/node/chunks/dep-df561101.js:48142:27)
    at onRollupWarning (file:///D:/Git/GitHub/mon-site-demo-tutoriel.madebyjeremie.fr/node_modules/vite/dist/node/chunks/dep-df561101.js:48174:9)
    at onwarn (file:///D:/Git/GitHub/mon-site-demo-tutoriel.madebyjeremie.fr/node_modules/vite/dist/node/chunks/dep-df561101.js:47902:13)
    at file:///D:/Git/GitHub/mon-site-demo-tutoriel.madebyjeremie.fr/node_modules/vite/node_modules/rollup/dist/es/shared/node-entry.js:24271:13
    at Object.logger [as onLog] (file:///D:/Git/GitHub/mon-site-demo-tutoriel.madebyjeremie.fr/node_modules/vite/node_modules/rollup/dist/es/shared/node-entry.js:25945:9)
    at ModuleLoader.handleInvalidResolvedId (file:///D:/Git/GitHub/mon-site-demo-tutoriel.madebyjeremie.fr/node_modules/vite/node_modules/rollup/dist/es/shared/node-entry.js:24857:26)
    at ModuleLoader.resolveDynamicImport (file:///D:/Git/GitHub/mon-site-demo-tutoriel.madebyjeremie.fr/node_modules/vite/node_modules/rollup/dist/es/shared/node-entry.js:24915:58)
    at async file:///D:/Git/GitHub/mon-site-demo-tutoriel.madebyjeremie.fr/node_modules/vite/node_modules/rollup/dist/es/shared/node-entry.js:24802:32

Thanks for your insights on those.

[Mister-Hope]

@wozsun We don't support yarn1 (yarn4 is already released). Pnpm8 is working, an example here: https://github.com/mdit-plugins/mdit-plugins.

We are expecting everything works well on npm >= 8, pnpm >= 7 and yarn >= 2.

If you are running into the same issue with package manager above, a new issue with a minimal reproduction is welcomed.

[JeremieLitzler]

@wozsun

Upgrading to yarn 4 solved the issue. See Puzzlout/TemplateVuepress#6

Thanks @Mister-Hope

[Mister-Hope]

I will upgrade the docs to make sure that the requirements is correct

[Mister-Hope]

The mathjax problem should be solved in 244

[JeremieLitzler]

Ok @Mister-Hope , I'll test soon.

Thanks.