VuePress 由两部分组成:第一部分是一个极简静态网站生成器,它包含由 Vue 驱动的主题系统和插件 API,另一个部分是为书写技术文档而优化的默认主题,它的诞生初衷是为了支持 Vue 及其子项目的文档需求。
每一个由 VuePress 生成的页面都带有预渲染好的 HTML,也因此具有非常好的加载性能和搜索引擎优化(SEO)。同时,一旦页面被加载,Vue 将接管这些静态内容,并将其转换成一个完整的单页应用(SPA),其他的页面则会只在用户浏览到的时候才按需加载。
事实上,一个 VuePress 网站是一个由 Vue、Vue Router 和 webpack 驱动的单页应用。如果你以前使用过 Vue 的话,当你在开发一个自定义主题的时候,你会感受到非常熟悉的开发体验,你甚至可以使用 Vue DevTools 去调试你的自定义主题。
在构建时,我们会为应用创建一个服务端渲染(SSR)的版本,然后通过虚拟访问每一条路径来渲染对应的HTML。这种做法的灵感来源于 Nuxt 的 nuxt generate 命令,以及其他的一些项目,比如 Gatsby。
教程以 Node.js 13.9.0 64位为例。 (VuePress⽀持使⽤Yarn和npm来安装,
Node.js版本需要>=8才可以。 这⾥我们使⽤npm。)
登录到ECS之后,执⾏行行如下命令,下载Node.js 13.9.0 64位安装包
wget https://npm.taobao.org/mirrors/node/v13.9.0/node-v13.9.0-linux-x64.tar.xz
sudo mkdir -p /usr/local/lib/nodejs
sudo tar -xJvf node-v13.9.0-linux-x64.tar.xz -C /usr/local/lib/nodejs
cd /usr/local/lib/nodejs/node-v13.9.0-linux-x64/bin
执行:
./node -v
vim ~/.bash_profile
找到 PATH= P A T H : PATH: PATH:HOME/bin,在PATH= P A T H : PATH: PATH:HOME/bin后⾯面添加路路
径:/usr/local/lib/nodejs/node-v13.9.0-linux-x64/bin,结果为:
PATH=$PATH:$HOME/bin:/usr/local/lib/nodejs/node-v13.9.0-linux-x64/bin
source ~/.bash_profile
注意:其中修改保存涉及vim的使用方法,可以搜索vim的相关操作。
cd /
node -v
npm version
npx -v
npm config set registry https://registry.npm.taobao.org
npm install -g vuepress
mkdir try_blogs
cd try_blogs
npm init -y
初始化后会⽣成⼀个package.json⽂件
之后进⼊配置步骤。
vim package.json
修改scripts中的内容如下:
“scripts”: {
“docs:dev”: “vuepress dev docs”,
“docs:build”: “vuepress build docs”
},
mkdir docs
cd docs
mkdir .vuepress
echo '# Hello VuePress - first blog!' >README.md
cd .vuepress
echo >config.js
mkdir public
vuepress dev docs
注: VuePress中有两个命令:
vuepress dev docs命令运⾏本地服务,通过访问(http://localhost:8080)即可预览⽹
站
vuepress build docs 命 令 ⽤ 来 ⽣ 成 静 态 ⽂ 件 , 默 认 情 况 下 , 放 置 在
docs/.vuepress/dist⽬录中,当然你也可以在docs/.vuepress/config.js中的dest字段
来修改默认存放⽬录。在这⾥将两个命令封装成脚本的⽅式,直接使⽤npm run
docs:dev和npm run docs:build即可。
---
home: true
heroText: Vue技术博客初试
tagline: 简洁至上,Vue驱动,高性能
actionText: 快速上手 →
actionLink: /testlink/
features:
- title: 简洁至上
details: 以 Markdown 为中心的项目结构,以最少的配置帮助你专注于写作。
- title: Vue驱动
details: 享受 Vue + webpack 的开发体验,在 Markdown 中使用 Vue 组件,同时可以使用 Vue 来开发自定义主>题。
- title: 高性能
details: VuePress 为每个页面预渲染生成静态的 HTML,同时在页面被加载的时候,将作为 SPA 运行。
footer: MIT Licensed | Copyright ? 2020-present xxxxxx
---