loading

通过vuepress + travis-cl + github pages 搭建个人博客

# 通过VuePress构建博客页面

  1. 通过包管理工具初始化项目
yarn init # npm init
1
  1. 将vuepress安装为本地依赖
yarn add -D vuepress # npm install -D vuepress
1
  1. 创建第一篇文档
mkdir docs && echo '# Hello VuePress' > docs/README.md
1
  1. package.json中添加一些script
{
  "scripts": {
    "dev": "vuepress dev docs",
    "build": "vuepress build docs"
  }
}
1
2
3
4
5
6
  1. 启动本地服务器
yarn dev #npm run dev
1

此时效果如下:

6.在docs目录下建立.vuepress并在改目录下新建config.js文件可以实现网站的各项配置。 此时目录结构为:

.
├─ docs
│  ├─ README.md
│  └─ .vuepress
│     └─ config.js
└─ package.json
1
2
3
4
5
6

具体配置详见vuepress官网 (opens new window)

实现博客基础布局:

从图中可以看出vuepress本身很简洁,如果我们想要实现更加美观的页面而又嫌配置麻烦,很幸运我们站在了前人的肩膀上,vuepress本身也支持配置主题,所以我们可以引用喜欢的主题,当然你也可以自己开发主题来为后人乘凉,本人使用的主题是vuepress-theme-reco (opens new window)

# 建立github仓库

  1. 使用github创建项目[name].github.io。 仓库如此命名的原因是,在此目录下可以直接使用https://[name].github.io/域名访问你的博客。

  2. 使用git remote add origin [你的仓库]将本地代码与远程库关联

  3. 通过git checkout -b切换到新分支,该分支存放文档源码,master分支用来存放打包好的 HTML 等文件 之所以在master分支存放打包后的文件,是因为如果存放的不是打包后的文件,那么通过https://[name].github.io的域名访问,得到的将是是README自述文件,也可以通过Github Pages改变来源,本质上还是将打包文件放到你要访问的来源上。

# 通过travis-cl实现自动化打包部署

  1. 首先我们需要在项目的根目录下建立.travis.yml文件,并写如如下配置
language: node_js
node_js:
    - 10
cache: yarn
install:
    - yarn
script:
    - yarn build
after_success:
    - cd docs/.vuepress/dist
    - git init
    - git config --global user.name "${U_NAME}"
    - git config --global user.email "${U_EMAIL}"
    - git add -A
    - git commit -m 'deploy'
    - git push --quiet --force "https://${GH_TOKEN}@${GH_REF}" master:${P_BRANCH}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

  • language: 语言选择 这里用node
  • node_js:使用的node版本
  • cache: yarn缓存
  • install: 安装依赖使用的包管理工具,yarn和npm均可 yarn更快
  • script: 一切就绪后通过yarn install安装依赖
  • after_success: 安装完成后执行的后续操作,将打包文件自动发布到你配置的对应仓库分支,这里的${}是在travis-cl中配置的环境变量,后文再说
  1. 为travis-cl创建一个Personal access tokens,地址 (opens new window),权限根据自己的需要授权,不必全选。

  2. 访问travis-cl (opens new window),使用github账号登录,再进入dashboard (opens new window),此时就可以看见你的git仓库了。

  3. 启动进入github.io这个项目,再通过setting,来配置上文提到的环境变量。

  • GH_REF: 项目地址(github.com/[name]/[name].github.io.git)注意去掉 https://
  • GH_TOKEN: 上面提到的Personal access tokens
  • U_NAME:你的github用户名
  • U_EMAIL: 你的github邮箱
  1. 进入github.io仓库的setting页面修改GitHub Pages的值为上面.travis.yml中配置的分支,也可以直接使用master分支。

到这里,travis-ci部署已经完成,我们下一次提交代码到github,就会触发travis-ci自动构建,将打包文件上传到指定分支,上传完成后,就可以通过https://[name].github.io/来访问你的博客了。

# 总结

其实,目前网络上搭建博客的框架有很多比如我这次使用的vuepress,另外还有hexojekyll等等,搭建博客也变的很简单,难的其实是搭建完成后,持之以恒的发布博文,记录自己的技术积累,希望自己能坚持下去。

这次的博客其实是运行在GitHub Page上的,使用的是github提供的服务器,希望未来学习node等服务端语言后,搭建自己的服务器后再将博客搬到自己的服务器上。

最近更新时间: 2021/08/13 15:27:23
最近更新
01
2021/10/23 00:00:00
02
2021/08/18 17:00:03
03
2021/07/04 15:26:36