介绍
在之前为了搭建 VuePress 的文档，顺带制作了视频教程，如今准备再次搭建一个 VuePress 的项目，一看自己的视频竟然有五个小时，天呐，我只是需要过一遍而已，所以重新整理成文档吧，万一将来又要用呢……
当然，如果您觉得文字版不够直观，可以前往观看视频版：【☛ 视频地址 ☚】，当时录制完本地测试后觉得声音大小还可以，结果一套录完了才发现声音很小，所以推荐带上耳机。
VuePress 文档示例
插件列表
为了方便的统一管理 plugin，需要对 docs/.vuepress/config.js 进行配置：
// docs/.vuepress/config.js
const pluginConf = require(‘../../config/pluginConf.js’);
module.exports = {
plugins: pluginConf,
}
插件的很多服务都需要对 head 标签进行修改：
// docs/.vuepress/config.js
const headConf = require(‘../../config/headConf.js’);
module.exports = {
head: headConf,
}
之后就可以去修改 config/pluginConf.js 和 config/headConf.js 文件了。
1. PWA
具体的 PWA 配置介绍可以看 官方文档，对应的 视频（8:20）。
VuePress 的版本会导致使用方式不一致，此处仅介绍 1.x 版本：
安装：
yarn add -D @vuepress/plugin-pwa@next
# OR npm install -D @vuepress/plugin-pwa@next
使用：
module.exports = {
‘@vuepress/pwa’: {
serviceWorker: true,
updatePopup: {
message: “ 发现新内容可用.”,
buttonText: “ 刷新 ”,
// 自定义弹窗
// popupComponent: ‘MySWUpdatePopup’,
}
},
};
PWA NOTES：
serviceWorker 选项仅仅用来控制 service worker，为了让你的网站完全地兼容 PWA，你需要在 .vuepress/public 提供 Manifest 和 icons，更多细节，请参见 MDN docs about the Web App Manifest. 此外，只有您能够使用 SSL 部署您的站点时才能启用此功能，因为 service worker 只能在 HTTPs 的 URL 下注册。 — VuePress 官网
因为使用的 Github Pages 服务，所以即使使用 CNAME 后也依然保持 SSL 状态。
Manifest 第六个视频其实存在一些问题，在第九个 视频 中解决了，利用 App Manifest Generator 直接生成即可。
参考示例：
{
“name”: “ 飞跃高山与大洋的鱼 ”,
“short_name”: “ 山与海 ”,
“description”: “ 飞跃高山与大洋的鱼的文档 ”,
“theme_color”: “#2196f3”,
“background_color”: “#2196f3”,
“display”: “standalone”,
“start_url”: “index.html”,
“icons”: [
{
“src”: “/icons/icon-72×72.png”,
“sizes”: “72×72”,
“type”: “image/png”
},
{
“src”: “/icons/icon-96×96.png”,
“sizes”: “96×96”,
“type”: “image/png”
},
{
“src”: “/icons/icon-128×128.png”,
“sizes”: “128×128”,
“type”: “image/png”
},
{
“src”: “/icons/icon-144×144.png”,
“sizes”: “144×144”,
“type”: “image/png”
},
{
“src”: “/icons/icon-152×152.png”,
“sizes”: “152×152”,
“type”: “image/png”
},
{
“src”: “/icons/icon-192×192.png”,
“sizes”: “192×192”,
“type”: “image/png”
},
{
“src”: “/icons/icon-384×384.png”,
“sizes”: “384×384”,
“type”: “image/png”
},
{
“src”: “/icons/icon-512×512.png”,
“sizes”: “512×512”,
“type”: “image/png”
}
]
}
还需要获取一下 favicons 等：
// config/headConf.js
module.exports = [
[‘link’, { rel: ‘apple-touch-icon’, href: ‘/apple-touch-icon.png’}],
[‘link’, { rel: ‘icon’, href: ‘/favicon-32×32.png’}],
[‘link’, { rel: ‘manifest’, href: ‘/manifest.json’}],
[‘meta’, { name: ‘theme-color’, content: ‘#ffffff’}],
];
2. 评论（待修改）
评论需要按照你的需求来：如果你希望所有评论可以在 Github 可见，那么使用 Gitalk 吧，正好有一篇新鲜出炉的文章；如果你想要所有非 Github 用户也可以评论的话可以使用 Valine，视频 地址。
这边利用的其实 主题的继承，通过修改 VuePress 的默认主题来实现需要的功能，在制作视频的时候官网还没有对这个详细的描述，这次更新发现有了新的介绍，由于时间关系及下一个项目不需要评论所以暂时延期处理：
首先修改默认主题下的 Page 组件（这意味着你不能随便使用 npm install 了）：
<!– node_modules/@vuepress/theme-default/components/Page.vue –>
</p>
</div>
<slot name=”bottom”/>
<Valine></Valine>
</main>
</template>
接着创建 Valine 组件，对于评论组件有以下要求：
在 README.md 文件中可以关闭评论；
在不同的路由显示不同的评论
<!– docs/.vuepress/components/Valine.vue –>
<template>
<div class=”ValineComment” v-if=”comment”>
<hr>
<span :id=”page.path” class=”leancloud-visitors” :data-flag-title=”page.title”>
<em class=”post-meta-item-text”> 文章阅读量 </em>
<i class=”leancloud-visitors-count”>1000000+</i>
</span>
<div id=”vcomments”></div>
</div>
</template>
<script>
export default {
computed: {
comment: function () {
let {comment} = this.$frontmatter;
if (typeof comment === ‘undefined’) {
return true;
}
return comment;
},
page: function () {
let {path = ‘/’, title = ‘ 首页 ’} = this.$page;
return {path, title};
}
},
mounted() {
this.renderValine()
},
watch: {
‘$route’: {
handler: function (to, from) {
if (to.path !== from.path) {
this.$nextTick(() => {
this.renderValine();
})
}
}
}
},
methods: {
renderValine() {
if (typeof window !== ‘undefined’) {
this.window = window;
window.AV = require(‘leancloud-storage’);
}
const secretKeyConf = require(‘../../../config/secretKeyConf.js’);
const Valine = require(‘valine’);
new Valine({
el: ‘#vcomments’ ,
appId: secretKeyConf.appId,
appKey: secretKeyConf.appKey,
notify:false,
verify:false,
avatar:’retro’,
path: window.location.pathname,
meta: [‘nick’,’mail’,’link’],
pageSize: 10,
visitor: true,
placeholder: ‘ 欢迎留言 …’
});
}
}
}
</script>
<style lang=”stylus” scoped>
.ValineComment {
padding 0 2rem;
}
.leancloud-visitors {
display inline-block
margin-bottom 1rem;
}
</style>
3. Back-to-top
具体的 Back-to-top 配置介绍可以看 官方文档。
安装：
yarn add -D @vuepress/plugin-back-to-top@next
# OR npm install -D @vuepress/plugin-back-to-top@next
使用：
// config/pluginConf.js
module.exports = {
‘@vuepress/back-to-top’: true,
};
效果图：
4. google-analytics
具体的 google-analytics 配置介绍可以看 官方文档。
你需要去 Google 获取对应的 key。
安装：
yarn add -D @vuepress/plugin-google-analytics@next
# OR npm install -D @vuepress/plugin-google-analytics@next
使用：
// config/pluginConf.js
// 此处引申出的隐私问题在最后有说明
const secretKeyConf = require(‘./secretKeyConf.js’);
module.exports = {
‘@vuepress/google-analytics’: {
‘ga’: secretKeyConf.ga
}
};
效果：
0. 隐藏私密信息
按理说，会了 git 基本上都知道这个功能，然而依然有很多人把自己的私密信息（如密码）上传到 Github 仓库，对应 视频（29:00）。
主要是使用 .gitignore 文件来忽略你要上传的文件，举个例子：
// config/secretKeyConf.js
module.exports = secretKeyConf = {
appId: ‘xxxxxx’,
appKey: ‘xxxxxx’,
ga: ‘xxxxxx’,
googleSearchConsole: ‘xxxxxx’,
}
将 config/secretKeyConf.js 追加到 .gitignore 文件中
# secretKeyConf
secretKeyConf.js
最后
为了方便阅读，所以将内容进行了划分：
VuePress 初始化及发布
VuePress 插件系列
VuePress 自动化
参考资料
VuePress 官网
Valine 官网