VitePress建站教程
小E使用VitePress建立了自己的第一个网站。网上的视频教程很多,纷繁复杂,小E打算从头梳理一个简明的教程,对自己以后书写博客也有好处。
1.本地配置环境
Yarn是一个常见的包管理工具,安装Node环境后使用npm命令或者安装yarn
yarn全局安装命令:
npm i yarn -g
如果不知道如何安装Yarn,可以参考一下这篇文章
2.创建文件夹,搭建脚手架
2.1 项目初始化
本地创建一个文件夹Blog,在VS code中使用终端执行,配置项跳过即可
shell
yarn init
初始化仓库
2.2 安装VitePress包
shell
yarn add --dev vitepress vue
2.3 编辑package.json包添加脚本
点击调试按钮可直接启动项目调试,或直接输入命令执行
shell
yarn docs:dev
2.4 新建docs文件夹 开始构建网页
在根目录创建docs文件夹,docs文件夹里面存放 index.md
文件和 .vitepress
文件夹,.vitePress
文件夹里面放config.js
文件
index.md
文件控制了主页的内容
markdown
---
layout: home
hero:
name: 名称
text: 文本
tagline: 标语
actions:
- theme: brand
text: 开始
link: /guide/what-is-vitepress
- theme: alt
text: View on GitHub
link: https://github.com/vuejs/vitepress
features:
- icon: ⚡️
title: Vite, The DX that can't be beat
details: Lorem ipsum...
- icon: 🖖
title: Power of Vue meets Markdown
details: Lorem ipsum...
- icon: 🛠️
title: Simple and minimal, always
details: Lorem ipsum...
---
<style>
:root {
--vp-home-hero-name-color: transparent;
--vp-home-hero-name-background: -webkit-linear-gradient(120deg, #bd34fe, #41d1ff);
}
</style>
config.js
控制了整个文档的实现和配置
javascript
module.exports = {
title: '标题',
description: 'Just playing around.',
themeConfig: {
nav: [
{
text: '关于',
items: [
{ text: '关于页面1', link: '/about/about1' },
{ text: '关于页面2', link: '/about/about2/' }
]
}
],
// sideber以对象的形式配置的话每个sidebar都是独立的 如果以数组的形式配置那么侧边栏是公共的 进入其他子页面都可以看到
sidebar: {
'/about/': [
{
text: '关于侧边栏',
items: [
{ text: '关于1', link: '/about/about1/' },
{ text: '关于2', link: '/about/about2/' }
]
},
]
}
}
}
终端执行
shell
yarn doc:dev
具体网页构建请参见
你可以通过修改config.js
,添加主页CSS样式,修改主页index.md文件来制作一个优美的网站.你现在应该在我的博客看到了它的实现,如果你感兴趣,也可以访问github仓库看看是怎么实现的:)
博客使用markdown进行书写,图片建议使用PicGo+OSS进行外链图床,可以给用户极致的体验.
3.Github Pages 部署
3.0 在GitHub建立一个<username>.github.io
的仓库
下面是部署好的仓库Repo,欢迎大家来点个Star
https://github.com/Ec3o/Ec3o.github.io
3.1 制作deploy.sh自动部署脚本
bash
#!/usr/bin/env sh
# 忽略错误
set -e #有错误抛出错误
# 构建
yarn run docs:build #然后执行打包命令
# 进入待发布的目录
cd docs/.vitepress/dist #进到dist目录
git init #执行这些git命令
git add -A
git commit -m 'deploy'
git push -f https://github.com/Ec3o/Ec3o.github.io.git master:gh-pages #提交到这个分支
cd -
rm -rf docs/.vitepress/dist #删除dist文件夹
3.2 更新package.json增加部署功能
json
{
"name": "blog",
"version": "1.0.0",
"main": "index.js",
"license": "MIT",
"scripts": {
"deploy":"bash deploy.sh",
"docs:dev": "vitepress dev docs",
"docs:build": "vitepress build docs",
"docs:serve": "vitepress serve docs"
},
"devDependencies": {
"vitepress": "^1.0.2",
"vue": "^3.4.21"
}
}
3.3 部署
shell
yarn run deploy
优雅,无需多言
3.4 Pages&域名Binding
打开Settings
-Pages
界面-Build and Deployment
找到部署界面
可以按照上图进行配置,也可以自定义域名进行访问(可选)
以上,一次简单的博客部署就完成了,感谢观看!