Vue 驱动的静态网站生成器

Vue 驱动的静态网站生成器

这是一个仿照 VuePress 官网(v2.0.0-beta.67)的演示网站,默认中文语言

快速上手 项目简介

Vue 驱动

以 Markdown 为中心的项目结构,享受 Vue 的开发体验,可以在 Markdown 中使用 Vue 组件,又可以使用 Vue 来开发自定义主题。

渲染机制

打包工具是 Vite(默认)、Webpack;VuePress 会为每个页面预渲染生成静态的 HTML,每个页面被加载时作为 SPA 运行。

主题插件

提供了一个开箱即用的默认主题;灵活的插件API,使得插件可以为你的站点提供许多即插即用的功能。

在项目中集成

# 在你的项目中安装
pnpm add -D vuepress@next @vuepress/client@next vue

# 新建一个 markdown 文件
echo '# Hello VuePress' > README.md

# 开始写作
pnpm vuepress dev

# 构建静态文件
pnpm vuepress build
# 在你的项目中安装
yarn add -D vuepress@next

# 新建一个 markdown 文件
echo '# Hello VuePress' > README.md

# 开始写作
yarn vuepress dev

# 构建静态文件
yarn vuepress build
# 在你的项目中安装
npm install -D vuepress@next

# 新建一个 markdown 文件
echo '# Hello VuePress' > README.md

# 开始写作
npx vuepress dev

# 构建静态文件
npx vuepress build

插件(补充)

问题记录

  • 1.node_modules 中 @vuepress 下缺少部分插件或文件,导致引入一些文件时失败。——已解决(√)
    ⠙ Initializing and preparing dataerror Import file @vuepress/theme-default/src/client/styles/_variables.scss not found
    error Import file @vuepress/theme-default/src/client/styles/vars.scss not found
    error Import file @vuepress/theme-default/src/client/styles/vars-dark.scss not found
    error Import file @vuepress/plugin-back-to-top/src/client/styles/vars.css not found
    error Import file @vuepress/plugin-medium-zoom/src/client/styles/vars.css not found
    error Import file @vuepress/plugin-external-link-icon/src/client/styles/vars.css not found
    error Import file @vuepress/plugin-nprogress/src/client/styles/vars.css not found
    error Import file @vuepress/plugin-pwa-popup/src/client/styles/vars.css not found
    error Import file @vuepress/plugin-search/src/shared/hotKey.ts not found
    error Import file @vuepress/plugin-search/src/client/styles/vars.css not found
    error Import file @vuepress/plugin-back-to-top/src/client/styles/vars.css not found
    error Import file @vuepress/theme-default/src/client/styles/_variables.scss not found
    error Import file @vuepress/theme-default/src/client/styles/vars.scss not found
    error Import file @vuepress/theme-default/src/client/styles/vars-dark.scss not found
    error Import file @vuepress/plugin-external-link-icon/src/client/styles/vars.css not found
    error Import file @vuepress/plugin-medium-zoom/src/client/styles/vars.css not found
    error Import file @vuepress/plugin-nprogress/src/client/styles/vars.css not found
    error Import file @vuepress/plugin-search/src/shared/hotKey.ts not found
    error Import file @vuepress/plugin-search/src/client/styles/vars.css not found
    ⠹ Initializing and preparing dataerror Import file @vuepress/plugin-pwa-popup/src/client/styles/vars.css not found
    
    解决过程:
    1. 引入 ecosystem 目录到项目下;
    2. vuepress/config.js,添加内容:markdown->importCode。
    
  • 2.自定义组件时使用 import.meta 报错,或使用其它方法定义 dirname ——已解决(√)
    yarn add -D @vuepress/plugin-register-components
    yarn add path