Github Page 搭建 jekyll 博客

申请Github帐号

点击进入Github,点击 sign up for github 就可以了

利用gitpage 搭建静态网站

先进入你的github主页,这里你可以查看和管理你的所有项目 项目首页

点击绿色New按钮,新建一个与你的github用户名相同的 项目,如agmgh.github.io的项目即可。如下图所示,xxx修改为你自己的github用户名。

新建项目

点击 Create repository ,你自己的站点就创建好了。(https://yourgitname.github.io)然后是下载github的客户端windows下 mac下(linux用命令行工具就不介绍了,略多不直观),安 装好后不同平台会有不同,但是基本的还是一样的.

Windows Git客户端

将刚刚创建好的github.io项目,clone 到本地就可以了。

本地配置 jekyll

安装ruby环境

window 下这里下载ruby,安装好后顺手把rails一起安了吧~

安装完成后记得设置环境变量, 具体就是把安装好的ruby位置放到环境变量里去。

win+R 调出运行,然后输入cmd 呼出terminal,敲入gem install rails等待安装完成吧~~

命令行输入gem install bundler等待安装完,

命令行输入gem install jekyll等待安装完,

接下来下载我的模板 到你clone下来 的地址,记得解压,你该看到大约是这样

agmgh.github.io

其中文件夹agmgh.github.io位置应该是你的项目位置

令行输入cd XXXXX XXXX是你的项目位置,

命令行输入bundle install

会自动给你安装GEMfile中提到的几个库

这样jekyll环境就算搭建好了

运行jekyll

配置_config

根据我的模板主页的readme文档设置

注意,本地试运行先把 production_url 改为http:\localhost:4000 博客首页

运行jekyll

命令行依然cd到你的项目目录,输入jekyll build,运行完了后再输入jekyll serve。 tips:没事terminal不要关。

浏览器里输入地址http:\localhost:4000你就能看到博客主页了 (不过这个时候搜索功能无法使用)!

可能会遇到的问题汇总

安装github客户端时,如果网络状况不佳,可能无法通过clickone 安装github Windows 客户端,建议从网上搜索别人做好的离线安装包。

安装ruby后,如果没有替换为 淘宝源时,会出现无法安装jekyll的情况。

切换淘宝源:

删除默认的官方源

gem sources -r https://rubygems.org/

添加淘宝源

gem sources -a https://ruby.taobao.org/

查看当前源

gem sources -l # https://ruby.taobao.org

安装我的模板时,需要安装以下模块:

gem install jekyll-seo-tag

gem install jekyll-feed

gem install jekyll-sitemap

执行gem install bundler 时出现ssl 证书验证错误。

点击下载cacert.pem ,将文件放在C盘根目录下

set SSL_CERT_FILE=C:\cacert.pem