vuepress 是 Vue 驱动的静态站点生成工具
本文仅介绍,搭建静态博客的过程,具体教程及文档请点击进入 vuepress中文网
点击查看项目代码
vuepress初始化
下面初始化
# 将 github 新创建的仓库克隆到本地 git clone git@github.com:zhb333/readme-blog.git # 进入项目 cd readme-blog # npm 初始化, 按照提示回车 npm init # 安装 vuepress npm i vuepress -D # 安装 gh-pages npm i gh-pages -D # 创建一个 docs 目录 mkdir docs # 创建一个 markdown 文件 echo '# Hello VuePress' > docs/README.md
npm 脚本
然后,给 package.json 添加一些 scripts 脚本:
{ "scripts": { "dev": "vuepress dev docs", "build": "vuepress build docs", "deploy": "npm run build && gh-pages -d docs/.vuepress/dist" } }
运行本地开发环境
运行 vurepress 的本地开发环境
npm run dev
访问 localhost:8080 , 已经成功开启
基础配置
生成静态资源
执行下面的命令,生成静态资源
npm run build
默认情况下,构建的文件会位于 docs/.vuepress/dist 中,该文件可以通过 docs/.vuepress/config.js 中的 dest 字段进行配置。
配置
创建 docs/.vuepress/config.js, 并进行简单配置
var config = { // 静态网站部署的目录 base: '/readme-blog/', // 网站标题 title: '标 の 博客', // <meta name="description" content="..."> description: '种一棵树最好的时间是十年前,其次是现在', markdown: { // 显示代码行号 lineNumbers: true } } module.exports = config
博客首页
公共文件
创建 docs/.vuepress/public 用于存放公共文件
我在 public/ , 存在了 favicon.ico 图标, 以及 zlx.jpg 首页的头像图片
简单的首页编写
将 docs/README.md设置为首页, 修改代码为:
--- home: true heroImage: /zlx.jpg footer: MIT Licensed | Copyright © 2018 ZhangHuanbiao ---
设置网站 ico 图标
配置网站的 ico 图标, 修改 .vuepress/config.js:
const config = { head: [ ['link', { rel: 'icon', href: '/favicon.ico' }] ] }
导航栏
配置导航栏
使用 vuepress 的默认主题配置导航栏 .vuepress/config.js:
const nav = [ { text: '前端栈', items: [ { text: 'Vue', link: '/WEB/Vue/vuepress-blog' }, { text: 'React', link: '/WEB/React/react-router' } ] } ] const config = { themeConfig: { // 项目的 github 地址 repo: 'zhb333/readme-blog', // github 地址的链接名 repoLabel: '代码', // 配置导航栏 nav, }, }
创建有效的导航资源
为了使得导航栏的链接点击有效, 我们创建两个文件:
docs/WEB/Vue/vuepress-blog.md
# 使用`vuepress`搭建静态博客 ## vuepress初始化 ## 基础配置 ## 博客首页 ## 导航栏
docs/WEB/React/react-router.md
# react-router
侧边栏
侧边栏配置
使用 vuepress 的默认主题配置侧边栏 .vuepress/config.js:
const sidebar = { '/WEB/': [ { title: 'Vue', children: [ 'Vue/vuepress-blog' ] }, { title: 'React', children: [ 'React/react-router' ] } ] } const nav = [ { text: '前端栈', items: [ { text: 'Vue', link: '/WEB/' + sidebar['/WEB/'][0]['children'][0] }, { text: 'React', link: '/WEB/' + sidebar['/WEB/'][1]['children'][0] } ] } ] var config = { themeConfig: { // 当前 markdown 的 github 代码链接 editLinks: true, // 链接显示的文本 editLinkText: '查看原文|编辑此页', nav, sidebar, }, }
侧边栏效果
访问: http://localhost:8080/readme-blog/WEB/Vue/vuepress-blog.html, 可以看到侧边栏已经生成
将静态博客网站部署到外网
使用 gh-pages 进行项目部署
npm run deploy
过几分钟后,访问 https://zhb333.github.io/readme-blog/, 便可以看到在外网成功部署的静态博客
评论功能
我们使用 valine 来实现评论功能:
Valine - 一款快速、简洁且高效的无后端评论系统。
点击进入 Valine官网 ,需要先注册才能食用
安装 Valine
# Install leancloud's js-sdk npm install leancloud-storage --save # Install valine npm install valine --save
注册 vuepress 全局组件
创建 .vuepress/components/Valine.vue
<template> <div id="vcomments"></div> </template> <script> export default { name: 'Valine', mounted: function(){ // require window const Valine = require('valine'); if (typeof window !== 'undefined') { this.window = window window.AV = require('leancloud-storage') } new Valine({ el: '#vcomments' , appId: '',// your appId appKey: '', // your appKey notify:false, verify:false, avatar:'mm', placeholder: 'just go go' }); }, } </script>
使用 Valine
只需要在 markdown 中调用即可
<Valine></Valine>
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持。
免责声明:本站资源来自互联网收集,仅供用于学习和交流,请遵循相关法律法规,本站一切资源不代表本站立场,如有侵权、后门、不妥请联系本站删除!
更新日志
- 黄乙玲1988-无稳定的爱心肝乱糟糟[日本东芝1M版][WAV+CUE]
- 群星《我们的歌第六季 第3期》[320K/MP3][70.68MB]
- 群星《我们的歌第六季 第3期》[FLAC/分轨][369.48MB]
- 群星《燃!沙排少女 影视原声带》[320K/MP3][175.61MB]
- 乱斗海盗瞎6胜卡组推荐一览 深暗领域乱斗海盗瞎卡组分享
- 炉石传说乱斗6胜卡组分享一览 深暗领域乱斗6胜卡组代码推荐
- 炉石传说乱斗本周卡组合集 乱斗模式卡组最新推荐
- 佟妍.2015-七窍玲珑心【万马旦】【WAV+CUE】
- 叶振棠陈晓慧.1986-龙的心·俘虏你(2006复黑限量版)【永恒】【WAV+CUE】
- 陈慧琳.1998-爱我不爱(国)【福茂】【WAV+CUE】
- 咪咕快游豪礼放送,百元京东卡、海量欢乐豆就在咪咕咪粉节!
- 双11百吋大屏焕新“热”,海信AI画质电视成最大赢家
- 海信电视E8N Ultra:真正的百吋,不止是大!
- 曾庆瑜1990-曾庆瑜历年精选[派森][WAV+CUE]
- 叶玉卿1999-深情之选[飞图][WAV+CUE]