GitHub Pages + Jekyll 搭建个人blog
最近开始意识到有条理地整理学习笔记的重要性,所以搭建这个博客一是觉得有趣,二来也是为了督促自己做好平时学习的记录,梳理思路加深印象并且方便今后的回顾复习。那么第一篇文章就记录一下搭建这个博客的过程吧。
Jekyll
GitHub官方推荐使用Bundler来安装和运行Jekyll,Bundler需使用Ruby来安装,所以如果系统里没有Ruby则需要先安装Ruby。 对于Windows系统,需要用rubyinstaller来安装Ruby,同时安装相应版本的DevKit(到这里下载)
- 安装时注意勾选 Add Ruby executables to your PATH
- 将DevKit解压后,命令行下进入解压目录
$ ruby dk.rb init -
此时产生一个config.yml文件,用编辑器打开它,如果文件最后没有Ruby的路径(如:- C:/Ruby23-x64)手动加上即可
- 回到命令行下
$ ruby dk.rb install
然后就可以开始安装Bundler啦~
$ gem install bundler
关于Gem这里再补充一点: 由于众所周知的原因(手动滑稽),国内开发者安装Gem大多都使用淘宝镜像 ruby.taobao.org,由于现在已经停止维护了(原因可见这篇文章:Ruby China 的 RubyGems 镜像上线),建议使用新的Gem源 gems.ruby-china.org
使用方式:
$ gem sources --add https://gems.ruby-china.org/ --remove https://rubygems.org/
由于我们要使用Bundle,可以用Bundle的Gem源代码镜像命令:
$ bundle config mirror.https://rubygems.org https://gems.ruby-china.org
这样就不用改 Gemfile 的 source了
source ‘https://rubygems.org/’
gem ‘rails’, ‘4.2.5’
…
接下来就创建一个本地的仓库来存放Jekyll页面吧
- 首先,你的系统里需要安装有git,如果没有请到这里安装→git官网下载地址
-
初始化一个空的仓库(如将其命名为my-blog)并进入目录底下
$ git init my-blog
$ cd my-blog - 在仓库根目录下新建一个名为Gemfile的文件写入以下内容并保存
source ‘https://rubygems.org’
gem ‘github-pages’, group: :jekyll_plugins
-
命令行下执行
$ bundle install - 想要更快速地建立一个blog,可以直接下载一个主题(Jekyll Themes)并将文件copy到自己目录底下
- 可以在本地运行起来啦
$ bundle exec jekyll serve - 打开浏览器,输入
http://localhost:4000即可预览网页效果 - 根据自己需求尽情修改Jekyll主题吧
GitHub Pages
- 登录GitHub新建一个仓库将其命名为 username.github.io (此处username必须与你的用户名相同)
- 将仓库内容clone到本地文件夹
$ git clone https://github.com/username/username.github.io - 进入项目文件夹
$ cd username.github.io - 将Jekyll目录下的所有文件copy到此文件夹内
- push到GitHub上去
$ git add --all
$ git commit -m "Initial commit"
$ git push -u origin master - 在浏览器中打开 http://username.github.io 就可以看到你的blog啦~