VuePress-v2-hope主题上手指南

摘要: VuePress-v2-hope主题上手指南


环境

nodejs版本>=20.18.1

官网: https://theme-hope.vuejs.press/zh/get-started/

创建项目

1
npm init vuepress-theme-hope@latest vuepress-hope-demo

默认配置下, README.mdindex.md 都会被转换成 index.html ,并且其对应的路由路径都是由斜杠结尾的。然而,如果你想同时保留这两个文件,就可能会造成冲突。

在这种情况下,你可以设置 pagePatterns 来避免某个文件被 VuePress 处理,例如使用 ['**/*.md', '!**/README.md', '!.vuepress', '!node_modules'] 来排除所有的 README.md 文件。

此外,一些符号如 :+ 可能对 vue-router 有特殊含义,因此你应该避免使用它们,请参阅 vue-router 文档 了解更多详情。

启动

1
2
3
npm run docs:dev 启动开发服务器
npm run docs:build 构建项目并输出
npm run docs:clean-dev 清除缓存并启动开发服务器

如何升级

1
npx vp-update

资源文件夹

1
\src\.vuepress\public

部署到cloudflare pages

1
2
3
pnpm docs:build
src/.vuepress/dist
注意src代码是根目录 可能不一样