This guide helps you migrate from V1 to V2.
Reasons to update to V2
V2 brings great performance improvements and many new features, see V2 Highlights for details.
Upgrade to the latest version of V1
Upgrading to the latest version V1 is the first step in the migration. During the upgrade to the latest version V1, you can check the V1 Changelog to adapt the changes made in V1.
Start migrating from V1
Now, in most cases you should be able to update
vuepress-theme-hope to latest v2 version, and run your v1 project directly.
The migration helper automatically converts your v1 config to v2 config, and gives you hints about deprecated options it converted and not-supported options it dropped. Also frontmatter of all pages will be converted from v1 syntax to v2.
All you need to do is:
Try to start the project, and read the logs;
Change your page frontmatter one by one according to logs;
Change your config file according to logs.
If you start importing
hopeThemeand call it during migration, you should call it with
hopeTheme(themeOptions, true)as the second argument means running in V1 legacy mode.
index.scss, and your
.vuepress/stylesas v2 style system is built with SCSS.
Covert your components under
.vuepress/componentsto Vue3 syntax, and register them using
After you successfully clear all hints, remove the second argument
V2 Migration Guide
The following pages list the changes between V1 and V2, respectively.