Skip to content

快速开始

推荐使用主题提供的模板,也可以手动开始。

⭐ 一键启动(推荐)

bash
# my-blog 替换为你的项目名
npm create @velonor/blog my-blog

🛠️ 手动开始

先初始化 VitePress 项目,然后安装主题:

shell
yarn add -D @velonor/theme
shell
npm i @velonor/theme -D
shell
pnpm add -D @velonor/theme

在主题入口中启用主题与 UnoCSS:

js
// .vitepress/theme/index.js
import Theme from '@velonor/theme'
import 'virtual:uno.css'
export default Theme

在配置中启用 UnoCSS 插件:

ts
// .vitepress/config.ts
import type { ThemeConfig } from '@velonor/theme/config'
import { defineConfigWithTheme } from 'vitepress'
import UnoCSS from 'unocss/vite'

export default defineConfigWithTheme<ThemeConfig>({
  vite: {
    plugins: [UnoCSS()],
    ssr: {
      noExternal: ['@velonor/engine', '@velonor/theme'],
    },
  },
  themeConfig: {
    // 你的主题配置
  }
})

安装依赖并启动:

bash
npm i
npm run dev