搭建jekyll + Github Pages博客

个人博客:https://withlei.github.io/

操作系统:Windows10

Jekyll是什么

引用自官网:
Jekyll 是一个简单的博客形态的静态站点生产机器。它有一个模版目录,其中包含原始文本格式的文档,通过一个转换器(如 Markdown)和我们的 Liquid 渲染器转化成一个完整的可发布的静态网站,你可以发布在任何你喜爱的服务器上。Jekyll 也可以运行在 GitHub Page 上,也就是说,你可以使用 GitHub 的服务来搭建你的项目页面、博客或者网站,而且是完全免费的。

简单来说,Jekyll就是将纯文本转化为静态博客网站,不需要数据库支持,也没有评论功能,想要评论功能的话可以借助第三方的评论服务。
Jekyll + Github Pages可以让你更加专注于博客内容,而不是如何搭建一个博客平台。

Github Pages是什么

GitHub Pages 是一个静态网站托管服务,直接从github仓库托管你个人、公司或者项目页面 ,并且不需要你写任何后端语言来支持。

Github Pages的服务是免费的,但是也有一些限制:

仓库空间不大于1G
每个月的流量不超过100G
每小时更新不超过 10 次

但是这些限制对我们普通人来说肯定没影响的,所以可以忽略。
这里只是将Github Pages当做一个平台,其他详细信息可以在Github Pages 文档查看

开始安装Jekyll

安装Jekyll前,确认已经按下步骤进行安装

  1. 安装Ruby+DevKit
  2. 安装Jekyll

1.安装Ruby+DevKit

下载地址:https://rubyinstaller.org/downloads/

在这里插入图片描述

直接选择带DevKit的版本

安装完成后,检查ruby是否安装成功

ruby -v
gem -v //查看gem 是否正常安装
在这里插入图片描述

在这里插入图片描述

2.安装Jekyll

gem install jekyll

快速启动
安装了 Jekyll 的 Gem 包之后,就可以在命令行中使用 Jekyll 命令了。官网提供了一个快速启动的例子:

# 安装bundler,bundler通过gemfile文件来管理gem包
gem install  bundler

# 创建一个新的Jekyll项目,并命名为myblog
jekyll new myblog

# 进入myblog目录
cd myblog

# 在Jekyll自带的服务器上预览你的项目,默认的运行地址为http://localhost:4000
# bundle exec 表示在当前项目依赖的上下文环境中执行命令 jekyll serve
bundle exec jekyll serve

Jekyll 自带了一个开发用的服务器,可以让你使用浏览器在本地进行预览。

jekyll serve
# 开发服务器将会运行在 http://localhost:4000/

serve 指令将会自动监测变化,生成新的文件。想关闭这功能,你可以使用 jekyll serve --no-watch,这里还有其他几个参数:

  • jekyll serve --livereload相当于前端开发中自动刷新浏览器。
  • jekyll serve --incremental相当于模块热替换,只刷新更改的模块。
  • jekyll serve --detach 和jekyll serve命令相同,但是会脱离终端在后台运行,如果你想关闭服务器,可以使用kill -9 1234命令,"1234" 是进程号(PID)。如果你找不到进程号,那么就用ps aux | grep jekyll命令来查看,然后关闭服务器。

访问测试链接:http://127.0.0.1:4000/
出现该页面说明创建部署成功


在这里插入图片描述

开始搭建Github Pages

1.使用Jekyll写博文

你可能喜欢markdown或html来写博文,都可以,但是博文文件的命名规则要服从下面的规则:

 year-month-title.markup //markup为你的文件格式的后缀名

在你的文章头部添加yaml头信息

---
layout: post
title:  "Jekyll+Github搭建个人博客"
date:   2019-06-05
categories: original
---

写上自己的博文内容,将这个文件保存在blog里面的_posts目录里面即可。再重启jekyll内置服务器,刷新页面:http://localhost:4000,如果没有,可以先输入:

jekyll build 

重新生成页面,在启动服务器,这样就可以在页面看到自己添加的博文的标题了。
这就是在本地搭建jekyll和写博文的大致过程了,相信还有其他的搭建方法,但是估计都是大同小异吧。

2.部署到Github Pages

这里有两种方法:

  1. 使用命令完成
  2. 使用GitHub desktop应用完成

1)使用命令操作

接下来的操作都是用GIT命令完成的,不再是cmd了。首先,大家应该都拥有了github账号,没有的注册一个就好了。

  • 创建个人仓库
    就是建立一个新的仓库,但是这个仓库的名字必须为你的github的名字+github+io,即yourname.github.io
  • 将目录切换到你想要放github博客的文件目录下,在这个目录git bash 将刚才建的仓库克隆下来:
  git clone git@github.com:yourname/yourname.github.io.git

这时,你会发现你的文件夹下会多出一个yourname的文件,我们把之前的blog下的所有文件复制到里面。

  • 然后把里面的所有文件push到刚刚建的远程仓库,步骤我就不写了。
    这时,在浏览器里面输入网址:http://yourname.github.io 就可以看你的个人博客网站了,这就是你的博客网站的地址了。
    前面所说的yourname指的是你的github账号名字。
  • 嗯,接下来你就可以查看你的博客网站了。其中还可以在github的settings中选择你的博客主题。

2)使用GitHub desktop应用

将本地博客使用desktop上传仓库,仓库名为 yourname.github.io ,接着同步后就可以访问了

blog preview

blog preview

blog preview

blog preview

参考博客:
windows下Jekyll安装步骤及问题 - 彭世瑜
Jekyll中文官网
Jekll+Github Pages搭建静态博客
Jekyll搭建个人博客-潘柏信

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

推荐阅读更多精彩内容