使用Gitpage和Jekyll搭建个人博客

原文链接
工作生活中经常会遇到一些需要记录下来的东西,设想是本地编写markdown文档,文档中的各种图片资源会随时使用截图工具或者图片文件,使用Alfred或者AutoHotKey自动将图片或者剪贴板中的截图内容上传至七牛云图床,并返回markdown格式的图片链接,本地编写好之后git push到GitHub上面,使用GitPages自动生成博客。
将搭建的过程记录下来以备和我有相同需求或者遇到相同问题的同学参考。
本人使用Mac,搭建过程也以Mac过程为主,主要使用到的工具如下:

  • Github账户 + GitPage配置
  • Jekyll / Hexo (生成静态HTML页面)
  • 七牛云账户 + qshell(用于存储Blog重的图片)
  • Alfred + Powerpack + qimage-mac(用于本地截图或文档自动上传七牛云对象存储,Windows可使用AutoHotKey)
  • vscode + Markdown All in One + Markdown Preview Github Styling (用于本地编辑markdown及实时预览)
  • Snipaste 或其他截图工具
  • 一个免费或收费的域名

1. GitHub及相关配置

1-1 创建repository

登陆Github,并新建一个repository,这里需要注意一下的是需要按照username.github.io格式来创建repository,这样后面才能够使用https://username.github.io这样的URL来访问GitPage。

img

1-2 修改repository的Setting

找到Repository的Setting tab页面,如下图:


img

向下一直拖动到GitHub Pages页面,启用GitPages,这里可以设置GitPages使用哪个分支,修改显示的主题风格,以及修改为自定义的域名。

img

至此,基于GitPages的一个免费个人博客就已经搭建成功了,我们在代码中可以直接编辑html,然后访问username.github.io即可看到个人博客网站的显示结果。
比如将以下代码保存成index.html放到repository的根目录:

<!DOCTYPE HTML>
<html>
    <head>
    <title>m00nwhite</title>
    </head>
    <body>
        welcome to m00nwhite.github.io! 
    </body>
</html>

然后访问username.github.io 即可看到显示结果

img

2.Jekyll及相关配置

Jekyll是一个的免费Blog生成框架,可以运行在GitHub Pages上,详细的使用教程请参考 官方文档。 也可以使用Hexo,看个人喜好,Jekyll和GitPage的契合度更高一些,但是生成静态页面的速度方面不如Hexo迅速,使用方面较Hexo也略微复杂一些,这里使用Jekyll,单纯的是因为想学习一下。

官方网址:Jekyll

2-1 jekyll的安装

先来看一下官方安装教程,简单得只有一张图:

image

需要安装bundler,gem

# 安装bundler和gem
gem install bundler jekyll

# 使用jekyll新建一个博客项目,m00nwhite请替换成你喜欢的名字
jekyll new m00nwhite

# 进入到jekyll为你创建的文件夹,并启动jekyll的本地服务
cd m00nwhite
bundle exec jekyll serve

执行了上面的命令之后,jekyll就为你在本地4000端口创建了一个博客服务。


img

使用浏览器访问一下,可以看到Jekyll为我们生成的页面:


img

3 图片配置

其实上面两步完成之后,对于简单的博客来说应该就基本够用了,但是对于追求效率的重度使用者来说还需要优化一下,比如贴图的过程。一张一张手工编辑链接地址并且上传的话未免效率低下,体验不是很友好。于是考虑使用七牛云图床,一来可以提高效率,二来可以使用CDN加速提高访问速度。

3-1 七牛云配置

需要注册七牛云账户并登陆至管理控制台,添加对象存储。

img

3-2 安装及配置qshell

创建完存储空间之后,我们就可以使用七牛提供的管理控制台来上传和管理我们的图片了。也可以使用客户端,这里选择使用七牛提供的命令行工具(qshell)来方便地上传和使用图片。

官方安装链接在七牛的:开发者中心
下载对应平台的qshell并安装即可。

一些需要鉴权的qshell命令需要先设置好AK(AccessKey)和SK(SecretKey),这两个Key在七牛管理控制台右侧的密钥管理中可以找到。

image

img

然后使用下面的命令设置好qshell的AK和SK,这样我们就可以使用Alfred创建Workflow来调用qshell自动上传图片了。

qshell account ak sk name

其他qshell的使用请参考官方文档,这里不再赘述。

3-3 配置Alfred的workflow

这里使用qimage-mac
详细的教程请参考使用 Alfred 在 markdown 中愉快的贴图

导入workflow之后需要修改一下热键


image

修改一下参数配置,设置七牛的AK,SK和bucket等参数。


img
image

这里在执行的时候报错了,调试发现设置qshell账户的shell命令行参数数量不对,因为之前已经设置过了,这里就直接注释掉了,速度还能快一些。


image

最后,将GitHub上的仓库克隆到本地,修改之后再push就可以直接更新博客内容了。

git clone git@github.com:username/username.github.io.git
# 修改markdown文档
git commit -m "your comment"
git push 

本地修改可以使用vscode或者typoravscode需要安装Markdown All in OneMarkdown Preview Github Styling两个插件,可以在编辑markdown文件的时候实时生成预览效果。

4. 一些问题

搭建过程中并不是一帆风顺的,难免遇到一些问题

4.1 问题1.GitPage上面七牛的图片显示不出。

原因:GitPage不绑定域名时默认使用https方式提供服务,而七牛云提供的图片外链是http的。
解决方法:GitPage使用自定义域名,并将服务方式修改为http,GitPage和七牛云都修改为Https应该也可以,留待以后验证。
首先申请一个域名,这里选择腾讯云的域名。然后在腾讯云的管理控制台中将域名的CNAME指向修改为GitPage的username.github.io

image

CNAME修改后一般需要十分钟左右才能生效


image

在GitPages的setting中也将域名修改为自定义域名


image

另外,由于七牛的测试域名只能使用30天,所以这里把七牛云空间也一并修改为自定义域名,修改方式也是在腾讯云的管理控制台里面把域名的CNAME修改为七牛云提供的CNAME即可。

image
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,884评论 6 492
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,755评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 158,369评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,799评论 1 285
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,910评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,096评论 1 291
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,159评论 3 411
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,917评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,360评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,673评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,814评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,509评论 4 334
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,156评论 3 317
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,882评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,123评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,641评论 2 362
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,728评论 2 351

推荐阅读更多精彩内容