使用 Jekyll 搭建个人博客

苏轻 2018年9月20日 20:21:31

前言

　　本篇文章主要是针对 Mac，Linux 稍有不同，而 Windows 则不推荐使用 Jekyll，请勿照搬。我的博客 suqing.fun 已经搭建好了，欢迎观光。

Homebrew

简介 Homebrew

　　Homebrew 是 Mac OS 平台下的一款软件包管理工具。 Homebrew 官网详细说明了 Homebrew 的用途以及如何安装使用。

检查 Homebrew，若没有则需要安装
```
$ brew -v
```
安装 Homebrew 提示Permission denied的解决办法
```
$ sudo chown -R $(whoami) /usr/local
```

Git

Git 是什么？
- git 分布式版本控制工具
检查 git
```
$ git --version
```
安装 git
```
$ brew install git
```

SSH Key

检查 ssh 是否已经存在
```
$ cd ~/.shh
```
- 出现No such file or directory的短语即表示没有。

设置 GitHub 每次 commit 的时候会使用到的 username 和 email

$ git config --global user.name "yourname"
$ git config --global user.email "youremail@qq.com"

创建 ssh key
```
$ ssh-keygen -t rsa -C "youremail@qq.com" // 我并未探究此处的字符串意义 照办就好
```
　　接下来需要确认路径和密码。因为密码可以为空，所以我选择了连按回车3下。当然，你也可以根据提示，设置你自己的路径和密码。还有，如果你以前创建过 ssh key，会提示你是否需要 overwrite。
查看 ssh 文件
```
$ cat .ssh/id_rsa.pub
```
复制
添加你的 SSH Key 到 GitHub
- 单击右上角你的头像
- 单击Settings
- 单击左侧SSH and GPG keys标签
- 单击右侧绿色按钮New SSH key
- 在 Title 的输入框给你的 SSH Key 起一个名字，任意内容都可。
- 在 Key 的输入框中粘贴刚刚复制的那段乱七八糟的文本。
- 单击Add SSH Key按钮
验证
```
$ ssh -T git@github.com
```
　　可能会提示你不确定github.com (192.30.253.113)的 host 是否可靠，键入yes回车，然后 host 会被永久添加到你的电脑的白名单里面。出现You've successfully authenticated, but GitHub does not provide shell access.即成功，可以进行下一步了。

Git 的使用

Clone（克隆）你的 Repository（仓库）到本地
- 单击Clone or download按钮
- 单击Use SSH蓝色文字
- 复制文本
- 在终端先cd到指定的目录，然后使用下面的命令克隆
```
$ git clone git@github.com:yourname/repositoryname.git // 这里就是刚刚复制的文本
```

其他命令（后面会用到）

先cd到你的克隆下来的仓库目录

// Add files to your repository
$ git add . // 表示提交所有文件（注意这里是有一个“.”的！）
// Delete
$ git rm −r -–cached FileName // 偶尔用到，删除指定的文件或文件夹
// Commit code to your repository
$ git commit -m "Commit"
// Push
$ git push

Ruby

Ruby 是什么
- Ruby 环境支持
- OS X 自带 Ruby
检查 Ruby
```
$ ruby -v
```

安装 Ruby

$ brew install ruby
// 虽然 OS X 系统原本就有 Ruby，我还是建议安装一下，因为原本的 Ruby 可能版本太低。

RubyGems

RubyGems 是什么？ RubyGems.org 是 Ruby 社区的 Gem 托管服务。让你能便捷、快速的发布、管理你的 Gem 以及安装它们。 RubyGems 官网提供 API 查阅可用 Gem 的详细资料。 RubyGems 官网安装指导
检查 gem 版本
```
$ gem -v
```
更新 gem
- 因为https://rubygems.org/ 很可能出现404（你懂得），所以需要把地址换一下。
- RubyGems 镜像有详细的教程，但是因域名备案问题，.org域名无法继续提供 RubyGems 镜像服务，域名被.com代替。
```
$ gem sources --add https://gems.ruby-china.com/
$ gem sources --remove https://rubygems.org/
```
- 更新 gem
```
$ sudo gem update --system
```
- 最后显示RubyGems system software updated，更新完成。

检查 gem

$ gem list --local // 显示的是我们自己安装的库
$ /usr/bin/gem list --local // 显示出来的应该是 OS X 系统原本自带的库
// 此处的2套库应该是互不影响的！

Jekyll

Jekyll 是个什么东西？
- 可以先到 Jekyll 官网了解一下，官网还提供了详细的文档。
- 简单。这篇教程跟着我一步一步走下来应该不难吧……或许……
- 静态。刚好 GitHub Pages 也只能做静态的页面，我主要是为了使用 Markdown 异常方便。
安装 Jekyll
```
$ sudo gem install jekyll
```
若提示You don't have write permissions for the /usr/bin directory.，则使用下面这条命令
```
$ sudo gem install -n /usr/local/bin jekyll
```
检查 Jekyll
```
$ jekyll -v
```
现在终于可以借助 Jekyll 开始搭建你自己的博客了！你可以自己新建一个 Jekyll 博客，也可以使用别人制作好的 Jekyll 主题的博客。
JekyllThemes 站点上展示了很多 Jekyll 主题的博客，如果初次接触可以从 GitHub 上下载。
如果是使用的主题，那么先cd到根目录，然后执行下面的命令。
```
$ bundle exec jekyll serve
```
接下来就可以使用 http://localhost:4000 预览网页效果了！

Hexo

Hexo 和 Jekyll 类似，有兴趣的可以去看一看。

结语

　　谨以本文记录一下使用 GithubPages 配合 Jekyll 搭建博客的流程，如有后来者看到这篇文章并获得些许帮助，幸甚之至。

　　苏轻 2018年8月20日 20:27:50