本博客采用了jekyll + github-pages
如果用的是windows系统,需要先安装ruby,比如到ruby官网下载ruby2.0.0p648版本,然后配置一下环境变量.
如果用的是mac系统,则无需自己安装ruby.
由于众所周知的原因,国内直接使用gem安装一些东西会下载不了,所以需要配置一下gem镜像:
请尽可能用比较新的 RubyGems 版本。
gem update --system # 这里请翻墙一下
gem -v
gem sources --add https://gems.ruby-china.com/ --remove https://rubygems.org/
gem sources -l
# 确保此时的输出只有 gems.ruby-china.com
注:如果在Mac系统下使用gem install xxx安装东西时提示类似这样的错误"You don't have write permissions for the /Library/Ruby/Gems/2.0.0 directory.",请在gem install之前加上sudo.
sudo gem install jekyll
Mac下可能会遇到因ffi安装失败而导致jekyll安装不成功的情况，这时可以做如下操作：
brew install automake autoconf libtool
sudo gem install ffi -v '1.9.21'
sudo gem install --no-ri --no-rdoc jekyll
这时还可能遇到Ruby版本过低的情况，这时可以做如下处理：
curl -L get.rvm.io | bash -s stable
source ~/.bashrc
source ~/.bash_profile
ruby -v
rvm list known
rvm install 2.6.3
rvm docs generate-ri
经过上面的两步处理，再安装sudo gem install jekyll就能成功了。
因为这个博客用到了jekyll-paginate(注意不要拼写错误,是paginate而不是pagenate),所以我们还需要单独安装一下它.
sudo gem install jekyll-paginate
jekyll serve
启动好之后可以用127.0.0.1:4000访问
jekyll build
进行到这里,基本上就可以自己开始玩这个博客了.
这里采用了git@github.com:Huxpro/huxblog-boilerplate.git 中的模版经过加工修改而成.
你可以通用修改 _config.yml文件来轻松的开始搭建自己的博客:
# Site settings
title: Paian's Blog # 你的博客网站标题
SEOTitle: Paian's Blog # 在后面会详细谈到
description: "指尖程序,笔下诗行" # 随便说点，描述一下
# SNS settings
github_username: mobilesite # 你的github账号
weibo_username: xxxx # 你的微博账号，底部链接会自动更新的。
# Build settings
# paginate: 10 # 一页你准备放几篇文章
Jekyll官方网站还有很多的参数可以调，比如设置文章的链接形式...网址在这里：Jekyll - Official Site 中文版的在这里：Jekyll中文.
要发表的文章一般以markdown的格式放在这里_posts/，你只要看看这篇模板里的文章你就立刻明白该如何设置。
yaml 头文件长这样:
---
layout: post
title: "Hey, this is Paian."
subtitle: "A subtitle here"
date: 2013-01-04 05:20:00
author: "Paian"
header-img: "img/xxx.jpg"
tags:
- Introduction
---
设置是在 _config.yml文件里面的Sidebar settings那块。
# Sidebar settings
sidebar: true #添加侧边栏
sidebar-about-description: "简单的描述一下你自己"
sidebar-avatar: /img/avatar.jpg #你的大头贴，请使用绝对地址.
侧边栏是响应式布局的，当屏幕尺寸小于992px的时候，侧边栏就会移动到底部。具体请见bootstrap栅格系统 http://v3.bootcss.com/css/
Mini-About-Me 这个模块将在你的头像下面，展示你所有的社交账号。这个也是响应式布局，当屏幕变小时候，会将其移动到页面底部，只不过会稍微有点小变化，具体请看代码。
# Featured Tags
featured-tags: true
featured-condition-size: 1 # A tag will be featured if the size of it is more than this condition value
唯一需要注意的是featured-condition-size: 如果一个标签的 SIZE，也就是使用该标签的文章数大于上面设定的条件值，这个标签就会在首页上被推荐。
内部有一个条件模板 {% if tag[1].size > {{site.featured-condition-size}} %} 是用来做筛选过滤的.
这里可以添加一些你经常关注的链接。这会在全部页面显示。
设置是在 _config.yml文件里面的WATCHLIST那块，自己加吧。
# WATCHLIST
friends: [
{
title: "Foo Blog",
href: "http://foo.github.io/"
},
{
title: "Bar Blog",
href: "http://bar.github.io"
}
]
HTML5幻灯片的排版：
这部分是用于占用html格式的幻灯片的，一般用到的是 Reveal.js, Impress.js, Slides, Prezi 等等.我认为一个现代化的博客怎么能少了放html幻灯的功能呢~
其主要原理是添加一个 iframe，在里面加入外部链接。你可以直接写到头文件里面去，详情请见下面的yaml头文件的写法。
---
layout: keynote
iframe: "http://xxx/xxx...."
---
iframe在不同的设备中，将会自动的调整大小。保留内边距是为了让手机用户可以向下滑动，以及添加更多的内容。
博客支持评论，采用的是Gitment评论框（老的多说评论已经不再提供服务了，更多评论插件的选择参见这里）。
首先，你需要去注册一个账号。不要直接使用我的啊！
其次，需要按照要求进行一些设置和插入代码（可以参考这篇文章）。
网站分析，现在支持百度统计和Google Analytics。需要去官方网站注册一下，然后将返回的code贴在下面：
# Baidu Analytics
ba_track_id: xxxxxxxxxxxxxx
# Google Analytics
ga_track_id: 'UA-xxxxxx-xxxx' # 你用Google账号去注册一个就会给你一个这样的id
ga_domain: xxxxxxxxx # 默认的是 auto, 这里我是自定义了的域名，你如果没有自己的域名，需要改成auto。
如果你喜欢折腾，你可以去自定义我的这个模板的 code，Grunt已经为你准备好了。（感谢 Clean Blog）
JavaScript 的压缩混淆、Less 的编译、Apache 2.0 许可通告的添加与 watch 代码改动，这些任务都揽括其中。简单的在命令行中输入 grunt 就可以执行默认任务来帮你构建文件了。如果你想搞一搞 JavaScript 或 Less 的话，grunt watch 会帮助到你的。
如果你可以理解 _include/ 和 _layouts/文件夹下的代码（这里是整个界面布局的地方），你就可以使用 Jekyll 使用的模版引擎 Liquid的语法直接修改/添加代码，来进行更有创意的自定义界面啦！
标题底图是可以自己选的，看看几篇示例post你就知道如何设置了。
但是需要注意的是本模板的标题是白色的，所以背景色要设置为灰色或者黑色，总之深色系就对了。当然你还可以自定义修改字体颜色，总之，用github pages就是可以完全的个性定制自己的博客。
我的博客标题是 “Paian's Blog” 但是我想要在搜索的时候显示 “拍岸的博客 | Paian's Blog” ，这个就需要SEO Title来定义了。
其实这个SEO Title就是定义了<title>标题</title>这个里面的东西，你可以自行修改的。
-
感谢@IronSummitMedia和@huxpro的模版和文档,大大加快了我的博客搭建速度,赞他们的开源精神!
-
感谢Jekyll、Github Pages 和 Bootstrap提供的产品和服务!