使用vuepress+github page搭建网络收藏夹

使用vuepress+github page搭建收藏夹

在开发学习过程中总会遇到各种各样的问题,当时解决之后,如果没能做好笔记,过一段时间之后很容易遗忘。养成了做笔记的习惯之后,就期望有一个很好的平台来保存笔记。我尝试过博客园,有道云笔记,象印笔记,语雀笔记等。有的平台确实比较好用,但是每次写笔记要么在浏览器中找网址,要么在电脑里找软件,等待打开,无形中增加了自己做这件事的时间成本。有的时候可能只是需要记录一句话。最终我选择了Typora。简介。方便。下一步就是解决多平台同步的问题,github page是一个很好的选择。搭配vuepress做成可以在线阅读的笔记本。

https://codeniu.github.io/lanbitou/

参考文章:

1.github pages与travis ci运作原理 - 陌上兮月 - 博客园

2.PanJiaChen/awesome-bookmarks: A curated list of awesome things

文档模板:

1.A magical documentation site generator. docsify

2.Document Everythin.gitbook

3.Vue 驱动的静态网站生成器. vuepress

为什么选择vuepress:

1.使用vue的时候比较多

2.vuepress的界面比较符合我的审美

开工

1.创建仓库并设置仓库开启github page

setting->GitHub Pages下做如下配置:

Source栏目下:

Branch:gh-pages /root

gh-pages分支是我们构建好的静态vue页面。这个分支在我们第一次提交代码后才会被创建,当然你也可以提前创建。

2.克隆这个库在你本地

使用vuepress进行初始化。

官方文档做了很详尽的说明https://vuepress.vuejs.org/zh/guide/getting-started.html

3.完成构建后,可以在本地运行一下看下效果

4.部署

1.手动部署

# 生成静态文件
npm run docs:build

# 进入生成的文件夹
cd docs/.vuepress/dist

#创建.nojekyll 防止Github Pages build错误
touch .nojekyll

git init
git add -A
git commit -m 'deploy'

# 推送到gh-pages分支
git push -f "https://${access_token}@github.com/Codeniu/lanbitou.git" master:gh-pages

2.使用 Travis CI 实现自动化部署

在每次提交时,让Travis 替我们完成buid以及推动到gh-pages分支的工作。

打开官网Travis CI,使用GitHub账号登录即可看到你的库了。激活你刚创建的库。并在该库的setting中将你刚生成的令牌添加到变量中去。

${access_token},access_token就是我们取的变量的名字,变量的值是我们在GitHub中生成的一个个人令牌。

在你的项目中添加以下两个文件:

deploy.sh

#!/usr/bin/env sh

# 确保脚本抛出遇到的错误
set -e

# 生成静态文件
npm run docs:build

# 进入生成的文件夹
cd docs/.vuepress/dist

#创建.nojekyll 防止Github Pages build错误
touch .nojekyll

git init
git add -A
git commit -m 'deploy'

git push -f "https://${access_token}@github.com/Codeniu/lanbitou.git" master:gh-pages

cd -

.travis.yml

sudo: required
language: node_js
node_js: stable
script: bash ./deploy.sh
branches:
  only:
  - master
notifications:
  email: false

关于Travis CI的工作原理,可以详细看一下github pages与travis ci运作原理 - 陌上兮月 - 博客园

passion
原文地址:https://www.cnblogs.com/youngniu/p/14135621.html