原文来自:Blog Configuration

 本文结构:
  1.  博客文章的永久链接格式
  2.  设置BASE_PATH
  3.  启用评论模块
  4.  启用站点分析模块

您可以通过./_config.yml文件中的设置选项配置Jekyll-Bootstrap。该文件本身也提供了一些配置说明。下面让我们来仔细看一下这些设置选项。

博客文章的永久链接格式

Jekyll 支持自定义博客文章的永久链接格式,您可以参阅格式表Jekyll Permalinks

Jekyl-Bootstrap 默认的链接格式是

1
permalink: /:categories/:year/:month/:day/:title/

这样任何文章的URL中都会依次包含文章的类别、时间、标题

请选择适合自己的链接格式。

设置BASE_PATH

Jekyll-Bootstrap推荐以 BASE_PATH 作为所有页面和文章的URL前缀。

BASE_PATH的设置可以让你的博客在相对目录下运行,主要在博客托管于GitHub Project Page 上时使用。如果您正在部署的站点是您在 GitHub 上的项目之一,你就必须设置BASE_PATH为您的项目名称。

如果您的站点定义了CNAME ,你可以将BASE_PATH置为空白。更多详情,请参阅http://pages.github.com/

注意:
在本地运行时,你的站点将会从根目录下运行,而忽略BASE_PATH

启用评论模块

Jekyll-Bootstrap 附带的评论插件代码有 DisqusIntense DebatelivefyreFacebook Comments

如果要启用评论功能,你需要注册有各个评论系统的帐号,然后在 _config.yml文件中找到 comments 配置项。如下

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
# Settings for comments helper
# Set 'provider' to the comment provider you want to use.
# Set 'provider' to false to turn commenting off globally.
#
comments :
  provider : disqus
  disqus :
    short_name : jekyllbootstrap
  livefyre :
    site_id : 123
  intensedebate :
    account : 123abc
  facebook :
    appid : 123
    num_posts: 5
    width: 580
    colorscheme: light

选择 Provider

设置provider 为您使用的provider。确定在相应的provider下指定帐户凭证。

上面的例子:使用 disqus provider,以 jekyllbootstrap 作为用户的short_name

自定义 Provider

您可以自定义评论系统,设置provider: custom,在下面路径下创建一个文件

1
./_includes/custom/comments

您可以在此文件中写入自己的插件代码,它可以在任何使用评论功能的地方被加载。如果您知道其他具有评论功能的第三方插件,请打开 GitHub Issue告诉我们,我们将把其加入其中。

禁止评论

设置provider: false可以禁止整个站点的评论功能。

如果你需要禁止某些页面/文章的评论功能,你可以在其YAML信息中加入comments: false。如下

1
2
3
4
5
6
---
layout: post
category : lessons
comments : false
tags : [yay]
---

启用站点分析模块

Jekyll-Bootstrap 附带的站点分析插件代码有GoogleGetClicky

如果要启用站点分析功能,你需要注册有各个站点分析系统的帐号,然后在 _config.yml文件中找到 analytics 配置项。如下

1
2
3
4
5
6
7
8
9
10
# Settings for analytics helper
# Set 'provider' to the analytics provider you want to use.
# Set 'provider' to false to turn analytics off globally.
#        
analytics :
  provider : google
  google : 
      tracking_id : 'UA-123-12'
  getclicky :
    site_id :

选择 Provider

设置provider为您使用的provider。确定在相应的provider下指定帐户凭证。

上面的例子:使用 google provider,以 UA-123-12 作为用户的tracking_id

自定义 Provider

您可以自定义站点分析系统,设置provider: custom,在下面路径下创建一个文件

1
./_includes/custom/analytics

您可以在此文件中写入自己的插件代码,它可以在任何使用站点分析功能的地方被加载。如果您知道其他具有站点分析功能的第三方插件,请打开 GitHub Issue告诉我们,我们将把其加入其中。

禁止分析

设置provider: false可以禁止对整个站点的分析。

如果你需要禁止对某些页面/文章的分析,你可以在其YAML信息中加入analytics: false。如下

1
2
3
4
5
6
---
layout: post
category : lessons
analytics : false
tags : [yay]
---