使用 Jekyll 搭建 github 博客

Author Avatar
tanglijun 7月 14, 2015

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

Windows 系统中安装 Jekyll,High 起来,yeah!

安装 Ruby 和 Ruby DevKit

下载Ruby2.0.0-p481 x86/x64

安装 Ruby, 勾选 Add Ruby executable to your PATH

安装Ruby

下载Ruby DevKit x86/x64

安装 Ruby DevKit

安装 Ruby DevKit

打开命令行工具 cmd

win + R and input cmd

进入 RubyDevKit 目录

cd c:/RubyDevKit

自动检测 Ruby installations 并把它们添加到配置文件

ruby dk.rb init

安装 DevKit, 绑定到你的 Ruby installation

ruby dk.rb install

很好!你已经完成了安装 jekyll 的准备工作。敢不敢继续挑战下一步,安装jekyll? : )

安装 jekyll

确认 gem 正确安装

gem -v

确认 gem 正确安装

如果正确显示版本号则继续, 否则请重新安装 Ruby

gem install jekyll

确认 jekyll 正确安装

jekyll -v

确认 jekyll 正确安装

恭喜你!你已经成功安装了 jekyll, 是不是兴奋起来了,我们继续 high!

创建你的 github 帐号

进入 [GitHub] 官网

注册 github 帐号

输入你的注册信息并创建 github 帐号 (注意: 帐号名请使用小写,因为 blog 的用户名将用作二级域名使用,如果存在大写将导致你的 blog 无法打开)

创建 github 帐号

选择新建仓库

新建仓库

创建你的仓库 (注意: 仓库名的命名格式为 username_of_github_account.github.io)

![创建仓库]create_repository

当你按下按钮的那刻起,你的博客托管服务器便成功建立了,是不是热血沸腾了呢?加油,好戏还在后面。

安装 git

下载 git

安装 git

安装 git

确认 git 正确安装

git --version

确认 git 正确安装

设置 git 用户信息

win + R and input cmd

进入 RubyDevKit 目录

cd c:/RubyDevKit

自动检测 Ruby installations 并把它们添加到配置文件

ruby dk.rb init

安装 DevKit, 绑定到你的 Ruby installation

ruby dk.rb install

很好!你已经完成了安装 jekyll 的准备工作。敢不敢继续挑战下一步,安装jekyll? : )

安装 jekyll

确认 gem 正确安装

gem -v

确认 gem 正确安装

如果正确显示版本号则继续, 否则请重新安装 Ruby

gem install jekyll

确认 jekyll 正确安装

jekyll -v

确认 jekyll 正确安装

恭喜你!你已经成功安装了 jekyll, 是不是兴奋起来了,我们继续 high!

创建你的 github 帐号

进入 [GitHub] 官网

注册 github 帐号

输入你的注册信息并创建 github 帐号 (注意: 帐号名请使用小写,因为 blog 的用户名将用作二级域名使用,如果存在大写将导致你的 blog 无法打开)

创建 github 帐号

选择新建仓库

新建仓库

创建你的仓库 (注意: 仓库名的命名格式为 username_of_github_account.github.io)

![创建仓库]create_repository

当你按下按钮的那刻起,你的博客托管服务器便成功建立了,是不是热血沸腾了呢?加油,好戏还在后面。

安装 git

下载 git

安装 git

安装 git

确认 git 正确安装

git --version

确认 git 正确安装

设置 git 用户信息

git config --global user.name 'your name'
git config --global user.email 'you email address'

查看 git 配置信息

git config --list

查看 git 配置信息

能来到这里说明你是个有实力的家伙,不过别得意,后面的任务你能完成吗?

添加 SSH Keys 到 github 帐号

打开你的 git bash 终端, 检查 SSH Keys 是否存在

ls -al ~/.ssh

查看 ssh_keys 是否存在

如果不存在也没关系,下面我们来创建它

ssh-keygen -t rsa -b 4096 -C "[email protected]"

生成一个新的 ssh_key

确认 ssh-agent 开启

eval $(ssh-agent -s)

确认 ssh-agent 开启

把 key 添加到 ssh-agent

ssh-add ~/.ssh/id_rsa

把 key 添加到 ssh-agent

复制 key

clip < ~/.ssh/id_rsa.pub

复制 key

进入 github, 选择 settings

选择 settings

选择左侧导航 SSH keys

选择左侧导航 SSH keys

点击 Add SSH key

点击 Add SSH key

添加 SSh key 到 github 帐号

添加 SSh key 到 github 帐号

添加成功

添加成功

测试 git 连接

ssh -T [email protected]

测试 git 连接

伸个懒腰,休息一下。轮到我们的 jekyll 上场,好戏才刚刚开始!

创建 jekyll 博客

首先把你的 username_of_github_account.github.io 克隆一份到你的本机上

git clone [email protected]:username_of_github_account/username_of_github_account.github.io.gif

克隆一份到本机

初始化一个默认的 jekyll 博客模版

jekyll new username_of_github_account.github.io

初始化 jekyll 博客模版

进入该目录

进入该目录

本地运行 blog (注意:默认是 4000 端口)

jekyll serve --port 5000

本地运行 blog

默认样式看起来是这样的

默认样式看起来是这样的

暂存所有文件到git

git add -A

暂存所有文件到 git

提交所有文件到 git

git commit -a -m 'update my blog'

提交所有文件到 git

提交至 github 仓库

git config --list

查看 git 配置信息

能来到这里说明你是个有实力的家伙,不过别得意,后面的任务你能完成吗?

添加 SSH Keys 到 github 帐号

打开你的 git bash 终端, 检查 SSH Keys 是否存在

ls -al ~/.ssh

查看 ssh_keys 是否存在

如果不存在也没关系,下面我们来创建它

ssh-keygen -t rsa -b 4096 -C "[email protected]"

生成一个新的 ssh_key

确认 ssh-agent 开启

eval $(ssh-agent -s)

确认 ssh-agent 开启

把 key 添加到 ssh-agent

ssh-add ~/.ssh/id_rsa

把 key 添加到 ssh-agent

复制 key

clip < ~/.ssh/id_rsa.pub

复制 key

进入 github, 选择 settings

选择 settings

选择左侧导航 SSH keys

选择左侧导航 SSH keys

点击 Add SSH key

点击 Add SSH key

添加 SSh key 到 github 帐号

添加 SSh key 到 github 帐号

添加成功

添加成功

测试 git 连接

ssh -T [email protected]

测试 git 连接

伸个懒腰,休息一下。轮到我们的 jekyll 上场,好戏才刚刚开始!

创建 jekyll 博客

首先把你的 username_of_github_account.github.io 克隆一份到你的本机上

git clone [email protected]:username_of_github_account/username_of_github_account.github.io.gif

克隆一份到本机

初始化一个默认的 jekyll 博客模版

jekyll new username_of_github_account.github.io

初始化 jekyll 博客模版

进入该目录

进入该目录

本地运行 blog (注意:默认是 4000 端口)

jekyll serve --port 5000

本地运行 blog

默认样式看起来是这样的

默认样式看起来是这样的

暂存所有文件到git

git add -A

暂存所有文件到 git

提交所有文件到 git

git commit -a -m 'update my blog'

提交所有文件到 git

提交至 github 仓库

git push -u origin master

提交至 github 仓库

热烈祝贺你!你已经成功创建自己的 github 博客了!你可以通过 username_of_github_account.github.io 访问你的博客了!

参考资料

许可协议:署名-非商业性使用-相同方式共享 4.0 国际 (CC BY-NC-SA 4.0)
本文链接:https://tanglj.cn/2015/07/14/jekyll-github-blog/