Changes in V2 version

[Mister-Hope]

Details

V2 will come together with VuePress@v2, with the power of vite@v2 webpack@v5 and vue@v3.

V2 will be a totally rewrite including:

• All the components will be rewrite with composition api in vue3
• All the styles will be mirgate to sass

Also we are going to make sure the rewrite one has a better performance!🚀 (no less than 25% increasement)

---

Below is a list of changes.

Note: All plugin names are in PascalCase and without vuepress-plugin- prefix, you should change to kebab-case and add the prefix yourself to get the correct plugin name.

AddThis💌

We are just making this plugin compatable with V2. This plugin will no longer under maintainment.

Why❔

AdBlockers are blocking addThis link heavily, and in most cases this plugin won't work.

Solution💡

We will provide a new share plugin in v2.

Comment2💬

Renamed from @mr-hope/vuepress-plugin-comment to vuepress-plugin-comment2. ⚠

Changes

• Drop Valine support!

  Valine is lack of maintainence and can leak your privacy. You should use Waline instead.

• Option hint (default true) for handling page info hints.

• Allow I18N Customize

• Muti categories support

Note

Vssue is currently being dropped because vssue has not support v2 yet. We will add it back after it supports v2.

CopyCode2📋

Renamed from @mr-hope/vuepress-plugin-copy-code to vuepress-plugin-copy-code2. ⚠

Changes

• Option delay (default 500) for handling the page swtiching transition.

• Option pure (default false) for handling fancy styles.

• Allow I18N Customize

Feed2

Renamed from @mr-hope/vuepress-plugin-feed to vuepress-plugin-feed2. ⚠

Changes

• Better log output.

• Muti categories support

MdEnhance

Changes

• Auto inject cdn links for markdown demo

• Option delay (default 500) for handling the page swtiching transition.

• Drop flowchart support

  We are adding mermaid support, and mermaid support flowchart.

• Move SlidePage layout from theme to the plugin

  This will allow other theme to provided a similar layout easily.

• Allow I18N Title in details block

• Allow I18N Customize

LightGallery

• Build a photo preview plugin using lightGallary

Pwa2

Renamed from @mr-hope/vuepress-plugin-pwa to vuepress-plugin-pwa2. ⚠

Changes

• Allow I18N Customize

PhotoSwipe

Changes

• Option delay (default 500) for handling the page swtiching transition.

• Allow I18N Customize

ReadingTime2

Renamed from @mr-hope/vuepress-plugin-reading-time to vuepress-plugin-reading-time2. ⚠

• Allow I18N Customize

SassPalette

• A new palette handling config and palette across theme and plugins using sass

Options:

export interface PaletteOptions {
  /** identifier for palette */
  id: string;

  /**
   * user config file path, relative to source dir
   *
   * @default ".vuepress/styles/config.scss"
   */
  config?: string;

  /**
   * default config file path, should be absolute path
   *
   * This is the file you should use to provide default values with `!default`
   *
   * @default "vuepress-plugin-sass-palette/styles/default/config.scss"
   */
  defaultConfig?: string;

  /**
   * user palette file path, relative to source dir
   *
   * @default ".vuepress/styles/palette.scss"
   */
  palette?: string;

  /**
   * default palette file path, should be absolute path
   *
   * This is the file you should use to provide default values with `!default`
   *
   * @default "vuepress-plugin-sass-palette/styles/default/palette.scss"
   */

  defaultPalette?: string;

  /**
   * user style file path, relative to source dir
   *
   * @default ".vuepress/styles/palette.scss"
   */
  style?: string;
}

SEO2

Renamed from @mr-hope/vuepress-plugin-seo to vuepress-plugin-seo2. ⚠

Changes

• JSON-LD support

• Better log output.

• Muti categories support

Share2

• A new share plugin providing page share.

SimpleBlog

• Build a own blog plugin to support blog with better performance

Sitemap2

Renamed from @mr-hope/vuepress-plugin-sitemap to vuepress-plugin-sitemap2. ⚠

Changes

• Better log output.

• Muti categories support

VuepressThemeHope

• Pure Mode in theme and all plugins [Feature Request] Pure feature #438

• Dim non focused area [Query] Dim non focused area. #168

• Code block theme config Allow users to config the hightlight theme for code blocks #189

• Muti categories support

• Drop fullscreen feature, or make it a optional feature (disabled by default).

  Most visitors do not use this feature.

• Drop themecolor feature, or make it a optional feature (disabled by default).

  Most visitors do not use this feature.

• Allow I18N Customize

[loctran016]

Hi there, your lightbox is great, but it will be better if you add lightGallery as lightGallery has even more features (and it have a Vue version, too)

[Mister-Hope]

Some feedback about lightGallery:

• Extra deps: See Remove vue-class-component from vue component sachinchoolur/lightGallery#1047

• It's mainly usage is wrapping a set of images, but our images are listed sperately in the whole docs content. Which I need extra codes and performance lost to make it compatable.

• It's size is much more bigger than phowo-swipe. It's core function is probably the same size as the whole photoswipe, but it's even spliting lots of features in to plugins, e.g.: fullscreen, zoom, thumbnail. Which means it will be finally 1.5 - 2 times big comparing to photoswipe

• Nearly 0 benifit with photoswipe. Expect some improvements in UIs,

  I don't think people will use rotate or tranverse function on the pics every offen. And we cannot write photographer, location and such info in markdown image alt.

  Videos support is great, but the plugin is much bigger than I expected, and it's not a common need, so even I build this plugin, this will probably not enabled by default.

We think this project is awesome, mainly because the ui is awesome. So I think it's time to rethink whether I should build this plugin.

[Mister-Hope]

It will be dropped. It's a big time waste for me. I almost finish writing the plugin, then I found this:

It's open souce but actually not free.

https://github.com/sachinchoolur/lightGallery/blob/master/LICENSE

See, you can only use it in GNU GPL license v3 projects for free, otherwise you must purchase a license. And that's very expensive.

My project will stay on MIT, that's unaccpetable for me.

Just a recommandation, please check if it's something I can use next time you recommand something to me 🤔

[Mister-Hope]

Update: see sachinchoolur/lightGallery#1048

[loctran016]

I'm truly sorry about this inconvenience, I used to think this project is GNU GPL license v3 project. I'm reallyyyyyyy sorry for this!!!!!!! 😭

[Mister-Hope]

It's ok, jsut a recommandation, I should watch the license first.

[dimaslanjaka]

[Mister-Hope]

Setting home as default makes no sense because there are situations where people forget to add a title in a simple page, and in that case,the breadcrumb should break (omit by search engines) rather then let search engines read a incorrect one, e.g: bar/home/foo

[Mister-Hope]

how to develop when no debug ?

If you mean how to debug an output code, please open a new dicussion under Q&A category. It's not related to v2, and the conversation list is long enough scrolling down each time. Opening a new dicussion each time makes it easier to track.

[Mister-Hope]

Additional: if you insist, you can open a PR setting the breadcrumb default to 'Unknown', That's okey to me. @dimaslanjaka

[Mister-Hope]

Just to be clear, here is what you are missing:

https://github.com/vuepress-theme-hope/vuepress-theme-hope/blame/2b2e40eea9a920b88685edf2f9b7a0278e428c58/docs/theme/src/readme.md#L4

[Mister-Hope]

For debugging, make sure you are serving a project using local theme, e.g: demo or docs.

Besides, you should run yarn dev under root folder. And node side changes requires you to stop current devServer and start a new one.