Migration from 0.x

Site Config

ga replaced

GA has been separated into a standalone plugin @vuepress/plugin-google-analytics.

Upgrade Path

  • Install @vuepress/plugin-google-analytics:
  1. yarn add -D @vuepress/plugin-google-analytics@next
  2. # OR npm install -D @vuepress/plugin-google-analytics@next
  • Update vuepress/config.js:
  1. module.exports = {
  2. -  ga: 'UA-12345678-9'
  3. +  plugins: [
  4. +    ['@vuepress/google-analytics', {
  5. +      ga: 'UA-12345678-9'
  6. +    }]
  7. + ]
  8. }

markdown.config renamed

Using extendMarkdown：。

Upgrade Path

Update vuepress/config.js:

  1. // vuepress/config.js
  2. module.exports = {
  3. -  markdown: {
  4. -    config(md) { /* ... */ }
  5. -  },
  6. +  extendMarkdown(md) { /* ... */ }
  7. }

serviceWorker replaced

Service Worker related features have been separated into a standalone plugin @vuepress/plugin-pwa.

Upgrade Path

See: @vuepress/plugin-pwa > Migration from 0.x

Default Theme Config

.vuepress/override.styl replaced

Replaced by .vuepress/styles/palette.styl.

Upgrade Path

See: Config > palette.styl

.vuepress/style.styl replaced

Replaced by .vuepress/styles/index.styl.

Upgrade Path

See: Config > index.styl