申请 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 环境
Windows 下这里下载 Ruby, 安装好后顺手把 Rails 一起安了吧~
安装完成后记得设置环境变量, 具体就是把安装好的 Ruby 位置放到环境变量里去.
win+R 调出运行, 然后输入 cmd 呼出 terminal, 敲入 Gem install Rails 等待安装完成吧~~
命令行输入 Gem install bundler 等待安装完,
命令行输入 Gem install jekyll 等待安装完,
接下来下载我的模板 http://github.com/agmgh/agmgh.github.io 到你 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
来源: http://www.jianshu.com/p/c537bbb026e9