VuePress个人博客搭建
vuepress概述
VuePress 由两部分组成:第一部分是一个极简静态网站生成器 (opens new window),它包含由 Vue 驱动的主题系统和插件 API,另一个部分是为书写技术文档而优化的默认主题,它的诞生初衷是为了支持 Vue 及其子项目的文档需求。
每一个由 VuePress 生成的页面都带有预渲染好的 HTML,也因此具有非常好的加载性能和搜索引擎优化(SEO)。同时,一旦页面被加载,Vue 将接管这些静态内容,并将其转换成一个完整的单页应用(SPA),其他的页面则会只在用户浏览到的时候才按需加载。
官网地址: https://www.vuepress.cn/guide/getting-started.html
node环境和npm支持
VuePress 需要 Node.js 版本 >= 8.6
若已有node.js环境使用命令查看node.js 版本
node -v
安装node.js
下载安装包
本文选择v12.18.4版本
上传解压
tar -zxvf node-v12.18.4-linux-x64.tar.gz -C /usr/local/
重命名
cd /usr/local/
mv node-v12.18.4-linux-x64/ node-v12.18.4
配置环境变量
创建nodejs.sh文件并添加如下内容
vi /etc/profile.d/nodejs.sh
export PATH=/usr/local/node-v12.18.4/bin:$PATH
刷新nodejs.sh文件
[root@localhost local]# source /etc/profile.d/nodejs.sh
查看版本
[root@localhost local]# node --version
v12.18.4
[root@localhost local]# npm --version
6.14.6
VuePress安装步骤
全局安装
创建放项目的文件夹
项目文件夹可以选自任意目录,本文选自在根目录下,
[root@localhost local]# cd /
[root@localhost /]# mkdir vuepress
在项目文件夹中全局安装
[root@localhost /]# cd /vuepress/
[root@localhost vuepress]# npm install -g vuepress
安装过程较慢,请耐心等待,出现如下信息表示安装完成
+ vuepress@1.8.2
added 1221 packages from 547 contributors in 871.19s
项目初始化
执行初始化命令: npm init –y
[root@localhost vuepress]# npm init -y
Wrote to /vuepress/package.json:
{
"name": "vuepress",
"version": "1.0.0",
"description": "",
"main": "index.js",
"scripts": {
"test": "echo \"Error: no test specified\" && exit 1"
},
"keywords": [],
"author": "",
"license": "ISC"
}
初始化后会生成package.json文件
[root@localhost vuepress]# ll
total 4
-rw-r--r--. 1 root root 222 Jun 14 12:34 package.json
配置package.json
编辑package.json文件,在scripts项中添加如下两行
{
"scripts": {
"dev": "vuepress dev docs",
"build": "vuepress build docs"
}
文件完整内容,标红的为添加的内容
{
"name": "vuepress",
"version": "1.0.0",
"description": "",
"main": "index.js",
"scripts": {
"dev": "vuepress dev docs",
"build": "vuepress build docs",
"test": "echo \"Error: no test specified\" && exit 1"
},
"keywords": [],
"author": "",
"license": "ISC"
}
创建主页
创建存放博客文件的docs文件夹
mkdir docs
[root@localhost vuepress]# mkdir docs
[root@localhost vuepress]# ll
total 4
drwxr-xr-x. 2 root root 6 Jun 14 12:40 docs
-rw-r--r--. 1 root root 290 Jun 14 12:38 package.json
进入到docs文件夹中创建README.md文件,这个文件就是博客的首页,在里面添加官网上的例子,也可以自定义其他内容
[root@localhost vuepress]# cd docs
[root@localhost docs]# vi README.md
# 添加如下内容
---
home: true
heroImage: /logo.jpg #主页上显示的logo图片
heroText: 莲藕淹 #主页标题
tagline: 莲藕淹的博客 #主页副标题
actionText: 开始浏览 ->
actionLink: /guide/ #点击开始浏览跳转的路径
features:
- title: 简洁至上
details: 以 Markdown 为中心的项目结构,以最少的配置帮助你专注于写作。
- title: Vue驱动
details: 享受 Vue + webpack 的开发体验,在 Markdown 中使用 Vue 组件,同时可以>使用 Vue 来开发自定义主题。
- title: 高性能
details: VuePress 为每个页面预渲染生成静态的 HTML,同时在页面被加载的时候,将>作为 SPA 运行。
footer: Copyright @ 2018-present Evan You #尾行
---注意: 每个变量名和值之间有一个英文空格,没有会报错,冒号(:)要使用英文符号
启动访问
启动命令
npm run dev
出现如下信息表示启动成功,并监听端口8080
Client
Compiled successfully in 174.56ms
success [12:45:17] Build 8c5288 finished in 175 ms! ( http://localhost:8080/ )
浏览器访问
在浏览器中访问链接http://ip:8080,即可看到上一步创建的主页信息
编译
按ctrl+C结束运行,执行编译命令: npm run build
^C
[root@localhost docs]# npm run build
> vuepress@1.0.0 build /vuepress
> vuepress build docs
出现如下信息表示编译成功
Client
Compiled successfully in 14.65s
Server
Compiled successfully in 10.23s
wait Rendering static HTML...
success Generated static files in docs/.vuepress/dist.
编译完成后在docs文件夹下多了一个.vuepress文件夹
如果在linux系统下,以点. 开头的文件夹会被隐藏,可以直接cd到文件夹下
[root@localhost docs]# ll
total 4
-rw-r--r--. 1 root root 538 Jun 14 12:44 README.md
[root@localhost docs]# cd .vuepress/
[root@localhost .vuepress]# pwd
/vuepress/docs/.vuepress
[root@localhost .vuepress]#
配置网站信息
在.vuepress文件夹下新建一个config.js文件
这个文件是全局配置文件,可以配置网站的标题、描述、主题、导航栏等信息,添加内容如下
module.exports = {
title: '莲藕淹的博客',
description: '莲藕淹的博客',
dest: './dist',
port: '8080',
head: [
['link', {rel: 'icon', href: '/logo.jpg'}]
],
markdown: {
lineNumbers: true
},
themeConfig: {
nav: [{
text: '指南', link: '/guide/'
}],
sidebar: {'/guide/':[
{
title:'hadoop',
collapsable: true,
children:[
'/guide/notes/one',
]
},
{
title:'java',
collapsable: true,
children:[
'/guide/notes/two',
]
}
]
},
sidebarDepth: 2,
lastUpdated: 'Last Updated',
searchMaxSuggestoins: 10,
serviceWorker: {
updatePopup: {
message: "有新的内容.",
buttonText: '更新'
}
},
editLinks: true,
editLinkText: '在 GitHub 上编辑此页 !'
}
}
nav是导航栏,sidebar是侧边栏,详细配置请参考官网文档有更详细的配置:
https://www.vuepress.cn/theme/
导航栏和侧边栏的配置参考博客
https://blog.csdn.net/weixin_34910772/article/details/112240767
默认的侧边栏配置并不友好,可以使用插件自动生成,插件链接
https://github.com/realduang/vuepress-plugin-auto-sidebar
完成了基础搭建后,按照config.js里面配置的目录结构,在docs目录下新增相应的.md文件,一篇文章就是一个.md文件
[root@localhost docs]# pwd
/vuepress/docs
[root@localhost docs]# ll
total 8
drwxr-xr-x. 4 root root 32 Jun 14 13:23 guide
-rw-r--r--. 1 root root 538 Jun 14 12:44 README.md
-rw-r--r--. 1 root root 13 Jun 14 13:27 test.md
[root@localhost docs]# cd guide/
[root@localhost guide]# pwd
/vuepress/docs/guide
[root@localhost guide]# ll
total 0
drwxr-xr-x. 2 root root 28 Jun 14 13:24 hadoop
drwxr-xr-x. 2 root root 26 Jun 14 13:24 java
发布部署
安装部署nginx
- 安装依赖包
yum -y install pcre-devel
yum -y install openssl-devel
yum -y install gcc
yum -y install lrzsz
yum -y install openssh-clients
- 下载安装包
http://nginx.org/en/download.html
本文选择1.18.0版本
- 上传解压
tar -zxvf nginx-1.18.0.tar.gz -C /usr/local/
- 检查安装
cd /usr/local/nginx-1.18.0/
./configure --prefix=/usr/local/nginx --conf-path=/usr/local/nginx/nginx.conf
注:不指定prefix,则可执行文件默认放在/usr/local/bin,库文件默认放在/usr/local/lib,配置文件默认放在/usr/local/etc
出现以下信息表示检查通过完成
Configuration summary
+ using system PCRE library
+ OpenSSL library is not used
+ using system zlib library
nginx path prefix: "/usr/local/nginx"
nginx binary file: "/usr/local/nginx/sbin/nginx"
nginx modules path: "/usr/local/nginx/modules"
nginx configuration prefix: "/usr/local/nginx"
nginx configuration file: "/usr/local/nginx/nginx.conf"
nginx pid file: "/usr/local/nginx/logs/nginx.pid"
nginx error log file: "/usr/local/nginx/logs/error.log"
nginx http access log file: "/usr/local/nginx/logs/access.log"
nginx http client request body temporary files: "client_body_temp"
nginx http proxy temporary files: "proxy_temp"
nginx http fastcgi temporary files: "fastcgi_temp"
nginx http uwsgi temporary files: "uwsgi_temp"
nginx http scgi temporary files: "scgi_temp"
- 编译安装
make && make install
出现以下信息表示安装完成
test -d '/usr/local/nginx/logs' \
|| mkdir -p '/usr/local/nginx/logs'
test -d '/usr/local/nginx/html' \
|| cp -R html '/usr/local/nginx'
test -d '/usr/local/nginx/logs' \
|| mkdir -p '/usr/local/nginx/logs'
make[1]: Leaving directory `/usr/local/nginx-1.18.0'
- 启动
/usr/local/nginx/sbin/nginx
注意,若启动失败请使用命令 netstat –tupln 检查端口是否占用,nginx默认端口是80,若被占用可kill掉占用程序或者修改nginx端口
修改默认端口
cd /usr/local/nginx
vi nginx.conf
server {
listen 80;
server_name localhost;
把listen 80;中的80修改为其他未占用的端口号
- 访问测试
浏览器中输入http://ip:port ,出现如下界面表示nginx服务部署成功
编译vuepress文件
再次执行npm run build
.vuepress下的dist文件夹,就是编译后的文件,将该文件夹通过nginx代理,就可以通过nginx代理访问自己的博客网站
配置Nginx代理
配置nginx.conf文件
cd /usr/local/nginx
vi nginx.conf
server {
listen 8081;
server_name localhost;
#charset koi8-r;
#access_log logs/host.access.log main;
location / {
root /vuepress/docs/.vuepress/dist; # //这里配置编译后的dist路径
try_files $uri $uri/ /index.html
index index.html index.htm;
}
重启nginx
停止nginx [root@localhost nginx]# sbin/nginx -s stop
启动nginx [root@localhost nginx]# sbin/nginx
访问http://192.168.194.56:8081/
Nginx代理配置成功
VuePress个人博客搭建的更多相关文章
- [原创]HEXO博客搭建日记
博客系统折腾了好久,使用过Wordpress,Ghost,Typecho,其中Typecho是我使用起来最舒心的一种,Markdown编辑+轻量化设计,功能不多不少刚好,着实让我这种强迫症患者舒服了好 ...
- Node.js博客搭建
Node.js 博客搭建 一. 学习需求 Node 的安装运行 会安装node,搭建node环境 会运行node. 基础模块的使用 Buffer:二进制数据处理模块 Event:事件模块 fs:文件系 ...
- nodejs环境 + 入门 + 博客搭建
NodeJS:NodeJS是一个使用了Google高性能V8 引擎 的服务器端JavaScript实现.它提供了一个(几乎)完全非阻塞I/O栈,与JavaScript提供的闭包和匿名函数相结合,使之成 ...
- WordPress博客搭建与问题总结
一.WordPress博客搭建 1.安装Apache web服务器 yum install -y httpd systemctl restart httpd systemctl enable ht ...
- 基于Github&Hexo的个人博客搭建过程
大家好,这里是「 从零开始学 Web 系列教程 」,并在下列地址同步更新...... github:https://github.com/Daotin/Web 微信公众号:Web前端之巅 博客园:ht ...
- 个人博客搭建( wordpress )
最近同学买了一台虚机( centos7 系统 ).一个域名,让帮忙搭一个个人博客.本着简单快捷,个人博客采用 wordpress 来搭建.为了以后博客系统的迁移方便,使用 docker 来安装 wor ...
- Hexo博客搭建以及Next主题美化的经验之谈
这并不是一篇博客搭建教程.内容主要包含个人对于Hexo博客搭建的心得,Next6.0主题美化的部分建议,以及摘录一些各种用于博客搭建的link. 在博客园3年6个月,确实也学到了很多,博客园也是目前为 ...
- Hexo博客搭建全解
[原创,转载请附网址:http://dongshuyan.top] 欢迎来到莫与的博客,第一篇记录了一下怎么写一篇博客,以方便之后写博客~ #从配置说起下载安装Git与Node.js略过 1.安装he ...
- GITHUB个人博客搭建-Pelican 在Windows环境下的安装及配置
GITHUB个人博客搭建-Pelican 在Windows环境下的安装及配置 前言 此篇博客主要为Pelican在Windows平台下的配置安装所写,在此过程中主要参考资料烟雨林博客.poem_of_ ...
随机推荐
- Mysql通过Canal同步Elasticsearch
目录 版本管理 Mysql 设置 在MySQL配置文件my.cnf设置: 检查是否开启 增加新用户: 安装 Elasticsearch es 跨域问题 目录挂载 安装 Elasticsearch-He ...
- IDEA中如何导入jar包、IDEA中找不到对应类改怎样解决?(详细图解过程)
今天突然心血来潮.用IDEA运行之前用eclipse编写的项目.发现遇到了一些bug,现在习惯了使用maven管理项目的依赖.一时间忘记了怎样将jar包导入项目中.特此记录一下 文章目录 1.未加入j ...
- C#-等待异步函数执行结果-将调用异步方法的函数变成非异步执行
先来简单了解一下async.await 使用async await 的前提条件:需要C# 5.0以上版本 .NET Framework 4.5以上 Visual Studio 2012以上. asyn ...
- C#中ref和out关键字的应用以及区别(参数修饰符)
ref ref的定义 ref是reference的缩写,通过引用来传递参数的地址,ref基本上是服务于值类型的 ref的使用 //不使用 ref; void Method(int myRefInt) ...
- SpringBoot Starter缘起
SpringBoot通过SpringBoot Starter零配置自动加载第三方模块,只需要引入模块的jar包不需要任何配置就可以启用模块,遵循约定大于配置的思想. 那么如何编写一个SpringBoo ...
- 脚本之一键部署nexus
NEXUS_URL="https://download.sonatype.com/nexus/3/nexus-3.39.0-01-unix.tar.gz" #NEXUS_URL=& ...
- 网络协议之:redis protocol 详解
目录 简介 redis的高级用法 Redis中的pipline Redis中的Pub/Sub RESP protocol Simple Strings Bulk Strings RESP Intege ...
- vue 项目中不更新的问题
在项目中 做矩阵题 嵌套的v-for <!-- 多选矩阵题 --> <template v-if="question.name==='MATRIX_CHECKBOX'&q ...
- JAVA-注解之 TODO、FIXME、XXX
TODO.FIXME.XXX //TODO : 表示待实现的功能 //FIXME: 代码存在Bug,不能Run或运行结果不正确,需要修复 //XXX : 勉强可以工作,但是实现的方 ...
- hashlib加密模块、加密补充说明、subprocess模块、logging日志模块
目录 hashlib加密模块 加密补充说明 subprocess模块 logging日志模块 日志的组成 日志配置字典 hashlib加密模块 1.何为加密 将明文数据处理成密文数据 让人无法看懂 2 ...