安装与使用

主页 | vuepress-theme-hope (vuejs.press)

安装

# 使用模板构建
pnpm create vuepress-theme-hope my-dir-name
# 更新
pnpm dlx vp-update

运行

pnpm run docs:dev
pnpm run docs:build

• 建议使用 pnpm 管理依赖。

主题配置坑

请勿设置：theme.hostname，不然访问设置的 hostname 时会出现页面重复。

部署到 Cloudflare Pages 使用 pages 分配的域名访问正常，如果使用 CNAME 则出现页面重复，暂时不知解决方法。

image-20240610093012018

image-20240610092934302

项目结构

.
├── .github (可选的) → GitHub 配置文件存放路径
│    └── workflow → GitHub 工作流配置
│         └── docs-deploy.yml → 自动部署文档的工作流
│
├── src → 文档文件夹
│    │
│    ├── .vuepress (可选的) → VuePress 配置文件夹
│    │    │
│    │    ├── dist (默认的) → 构建输出目录
│    │    │
│    │    ├── public (可选的) → 静态资源目录
│    │    │
│    │    ├── styles (可选的) → 用于存放样式相关的文件
│    │    │
│    │    ├── config.{js,ts} (可选的) → 配置文件的入口文件
│    │    │
│    │    └── client.{js,ts} (可选的) → 客户端文件
│    │
│    ├── ... → 其他项目文档
│    │
│    └── README.md → 项目主页
│
└── package.json → Nodejs 配置文件