建立一个可以自由配置的个人博客对很多人(比如我自己)来说颇有吸引力。关于为什么不用Wordpress等而选择Github Pages无需赘述,可以参见这篇文章.
很早之前按照该文里的步骤尝试搭建,但一直出现各种错误,甚为头疼。后来终于在Windows下利用Github Pages成功创建了我自己的博客。下面就来分享一下我的经历。
首先,Github Pages有两种搭建途径:
- User & Organization Pages
- 项目下的Pages
第一种Pages,每个用户名只能创建一个与自己的用户名同名的博客;而第二种则属于对应的项目,每个项目都可创建对应Pages
之前尝试搭建时,采用阮老师的方法,建立项目Pages,感觉很容易出错。后来发现直接建立第一种Pages更为方便,所以以下只介绍User Pages的情况
Step 1: 登录github,新建一个repository,命名为username.github.io,其中的username为当前github账户的用户名。
Step 2: 依照官方说明建立基本的index.html页面,并push。
Step 3: 依照官方说明,安装bundle。之后的步骤在cmd中进行:
- ruby –version 查看ruby版本号。如果未安装ruby则需先安装ruby。推荐使用Railsinstaller,非常快捷简便。
-
运行 gem install bundler
- 在项目目录中新建名为Gemfile的文件,不加后缀名。
-
运行</br> source ‘https//rubygems.org’ </br> gem ‘github-pages’
- 运行
bundle install
如果出现DL开头的两行报错信息,这相当于Warning,可以不管。如果最终提示未安装成功,可以多试几次。 -
运行 bundle exec jekyll serve 该命令用来启动jekyll server。在浏览器中输入localhost:4000,可以看到博客的index页面。cmd中输入ctrl+c,则可关闭server。运行jekyll server相当于在本地预览效果,之后对博客进行修改或发布博文时可以先在本地随时预览效果。
- 参照这篇文章中有关目录结构的部分建立目录结构。
- 参照这篇文章中配置_config.yml文件的方法进行个人设置。
- 参照这篇文章,尝试写一篇博客。注意:不用在_config.yml中配置baseurl,写博客时也不需要引用baseurl。
- push一下,访问username.github.io查看效果。
如果你的博客成功出现效果,那么恭喜你~
进一步配置和修改Jekyll可参照这篇文章。
一些jekyll模板可以看这里。